Conectar ao Conota MCP

O servidor usa Streamable HTTP.

URL:            https://mcp.conota.dev/mcp
Autenticação:   X-API-Key

Use a mesma API Key da sua conta Conota.

Claude Code

claude mcp add --transport http conota https://mcp.conota.dev/mcp \
  --header "X-API-Key: SUA_CHAVE_AQUI"

Codex

[mcp_servers.conota]
url = "https://mcp.conota.dev/mcp"
enabled = true

[mcp_servers.conota.http_headers]
X-API-Key = "SUA_CHAVE_AQUI"

Outros clientes

Qualquer cliente compatível com MCP sobre HTTP funciona, desde que permita configurar a URL e um header de autenticação.

O Authorization: Bearer SUA_CHAVE também é aceito, para clientes que só oferecem esse campo.

Não versione a chave

Arquivos de configuração de cliente MCP costumam ir para o Git junto com o resto do projeto. Quando o cliente suportar variável de ambiente ou secret store, use — e confira o .gitignore antes do primeiro commit.

Conferindo a conexão

Depois de conectar, peça algo simples ao assistente:

Liste as empresas emissoras da minha conta.

Se vier a lista, a chave está válida e o transporte funcionando.

Ferramenta nova exige reconectar

O cliente guarda o catálogo obtido no momento da conexão. Quando publicamos uma ferramenta nova, reconecte para enxergá-la — o catálogo atual está sempre em mcp.conota.dev.

Erros chegam como texto

Se a cota acabar ou a chave for inválida, a ferramenta devolve o motivo como resultado, não como falha de protocolo:

{ "_erro": true, "http": 422, "erro": "..." }

É deliberado: o agente precisa ler o motivo para explicar à pessoa, em vez de apenas dizer que a ferramenta falhou.