Aikount

MCP de contabilidade

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 roda.

Guias de configuração

• ChatGPT + Aikount
• Claude + Aikount

Servidor remoto (hospedado)

Aikount hospeda um servidor MCP:

https://api.aikount.com/mcp

• Transporte streamable-HTTP.
• Não é preciso instalar nada: você aponta seu cliente MCP para a URL.

Há duas formas de autenticar, e o cliente escolhe a que sabe falar:

Com OAuth (conectores do Claude e similares)

Se seu cliente suporta o fluxo OAuth do MCP — o caso dos conectores personalizados do Claude —, basta colar a URL. O cliente se registra sozinho, abre seu navegador, você faz login no Aikount e autoriza a conexão para a empresa ativa. Você pode marcar somente leitura se quiser que o agente consulte mas não escreva.

O acesso concedido fica em Ajustes → API → Apps conectadas, e você pode revogá-lo a partir daí a qualquer momento.

Com uma API key

Se seu cliente permite cabeçalhos fixos, envie seu token igual à API: Authorization: Bearer <token> (uma chave agl_; ver Autenticação). Por exemplo, no Claude Code:

claude mcp add --transport http aikount https://api.aikount.com/mcp \
  --header "Authorization: Bearer agl_..."

É 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 é lançá-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ê fornecer. As mesmas precauções de uma chave agl_ aplicam-se aqui: é acesso completo à sua contabilidade.

Próximo passo

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