Treeunfe API home pagelight logo
  1. IA e MCP
  2. Conectar seu agente

Em todos os exemplos, troque SUA_API_KEY pelo rawKey da organization. Prefira uma chave de homologação enquanto testa.

  • Claude Code

  • Claude Desktop

  • Cursor

  • VS Code

  • Codex

  • Gemini CLI

Rode no terminal:

claude mcp add --transport http treeunfe https://mcp.treeunfe.com.br/mcp --header "x-api-key: SUA_API_KEY"

Para confirmar, abra o Claude Code e digite /mcp. O servidor treeunfe deve aparecer como conectado.

Use --scope project para gravar a configuração no arquivo .mcp.json do projeto e compartilhar com o time. Nesse caso, não grave a chave no arquivo: use ${TREEUNFE_API_KEY} e defina a variável de ambiente em cada máquina.

​
Outros clientes

Qualquer cliente compatível com MCP remoto por HTTP funciona. Configure:

CampoValor
URLhttps://mcp.treeunfe.com.br/mcp
TransporteHTTP (Streamable HTTP)
Headerx-api-key: SUA_API_KEY ou Authorization: Bearer SUA_API_KEY

Conectores que só aceitam login por OAuth (sem campo para header) ainda não se conectam direto ao MCP da Treeunfe. Nesses casos, use o mcp-remote como no exemplo do Claude Desktop, quando o cliente permitir servidores locais.

​
Teste a conexão

Com o servidor conectado, peça ao agente algo que só lê dados:

Liste as ferramentas da Treeunfe que você tem disponíveis.

Consulte as últimas 5 notas emitidas este mês.

Se o agente responder que não tem acesso, confira:

  • se a chave está certa e ativa;
  • se a organization está ativa (organizations inativas recebem 403);
  • se a chave tem os escopos do que você pediu (nfe:read para consultar, nfe:emit para emitir).