Aikount

MCP

MCP (Model Context Protocol) é o padrão pelo qual um agente de IA descobre e usa ferramentas externas. Aikount expõe sua contabilidade como ferramentas MCP, de modo que um agente compatível pode emitir faturas, capturar despesas, conciliar o banco ou consultar impostos sem que você escreva código.

Há duas maneiras de se conectar, com as mesmas ferramentas de contabilidade por baixo. Escolha conforme onde seu agente seja executado.

Servidor remoto (hospedado)

Aikount hospeda um servidor MCP:

https://api.aikount.com/mcp

• Transporte streamable-HTTP.
• Autenticação por cabeçalho: você envia seu token igual como na API, com Authorization: Bearer <token> (use uma chave agl_; veja Autenticação).
• Não é preciso instalar nada: você aponta seu cliente MCP para a URL e dá o token a ele.

É a opção recomendada quando seu agente vive na nuvem ou você quer evitar instalações locais.

Servidor local (aikount-mcp)

Para agentes que rodam na sua máquina, publicamos o pacote aikount-mcp no PyPI. O mais rápido é executá-lo com uvx, sem instalar nada de forma permanente:

AIKOUNT_TOKEN=agl_tu_clave_aqui uvx aikount-mcp

• Transporte stdio (entrada/saída padrão), o habitual para clientes MCP de desktop.
• Autenticação pela variável de ambiente AIKOUNT_TOKEN, com sua chave agl_.

É a opção indicada quando seu cliente MCP fala por stdio com processos locais (muitos editores e CLIs de agentes fazem isso).

Remoto ou local

Remoto (/mcp)	Local (aikount-mcp)
Transporte	streamable-HTTP	stdio
Autenticação	Cabeçalho Authorization: Bearer	Env AIKOUNT_TOKEN
Instalação	Nenhuma	uvx aikount-mcp
Ferramentas	As mesmas de contabilidade	As mesmas de contabilidade

Ambos os caminhos operam sobre sua empresa com o token que você der a eles. As mesmas precauções de uma chave agl_ se aplicam aqui: é acesso completo à sua contabilidade.

Próximo passo

Para conectar isso no Claude Code, Cursor, Gemini CLI ou Codex, siga Conectar um agente.

AnteriorAutenticação e chaves de APISeguinte Conectar um agente