> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wimeisoftwares.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação com chave de consultor

> Como configurar, armazenar e usar sua chave de consultor mk_consultant para autenticar no MigraFlow CLI e vincular execuções ao seu projeto específico.

## Chave de consultor

Cada consultor recebe uma chave no formato:

```
mk_consultant_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

Essa chave:

* É vinculada ao seu projeto específico
* Tem validade definida (padrão: 30 dias)
* Não consome quota — é cobrada por projeto
* Deve ser mantida em sigilo

## Formas de uso

### 1. Direto no comando (mais simples)

```bash theme={null}
migraflow schema.sql "contexto" --api-key mk_consultant_xxx
```

### 2. Variável de ambiente (recomendado)

<CodeGroup>
  ```bash Windows theme={null}
  set MIGRAFLOW_API_KEY=mk_consultant_xxx
  migraflow schema.sql "contexto"
  ```

  ```bash Linux / Mac theme={null}
  export MIGRAFLOW_API_KEY=mk_consultant_xxx
  migraflow schema.sql "contexto"
  ```
</CodeGroup>

## Erros comuns

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    A chave está incorreta ou expirou. Entre em contato com a equipe MigraFlow para renovar.
  </Accordion>

  <Accordion title="403 Forbidden">
    A chave não tem permissão para este recurso. Verifique se está usando uma chave do tipo `mk_consultant_`.
  </Accordion>

  <Accordion title="ERRO: API key não encontrada">
    Nenhuma chave foi fornecida. Use `--api-key` ou defina `MIGRAFLOW_API_KEY`.
  </Accordion>
</AccordionGroup>

## Solicitar uma chave

Entre em contato pelo site: [wimeisoftwares.com](https://wimeisoftwares.com)