MCP Server — Autenticação

Gerando sua chave

1. Acesse https://api.conexaoazul.com/my/security com seu usuário.
2. Na seção de chaves de API, gere uma nova chave.
3. Copie o valor exibido — ele não é mostrado novamente depois que a tela é fechada.

Usando a chave

Envie a chave no header X-API-Key em toda requisição:

export MCP_API_KEY='SUA_CHAVE'

curl --fail-with-body --silent --show-error \
  --header "X-API-Key: ${MCP_API_KEY}" \
  https://api.conexaoazul.com/mcp/models

Uma chave ausente ou inválida retorna 401 Unauthorized.

Diferença em relação à Blue Credit API

	MCP Server	Blue Credit API
Header	X-API-Key	HTTP-API-KEY
Mecanismo	res.users.apikeys (nativo Odoo, /my/security)	auth.api.key (provisionado pela Conexão Azul)
Escopo	Modelos e operações habilitados por usuário	Grupo BLUE_CREDIT_API + saldo do parceiro

As chaves não são intercambiáveis — uma chave gerada em /my/security não autentica na Blue Credit API, e vice-versa.

Armazenamento seguro

• Guarde a chave em variáveis de ambiente ou secret managers, nunca em código versionado.
• Restrinja quem tem acesso ao usuário Odoo que gerou a chave.
• Em caso de suspeita de vazamento, revogue a chave em /my/security e gere uma nova.