MCP da Treeunfe

O MCP (Model Context Protocol) é um padrão aberto que permite a agentes de IA — como Claude, Cursor, VS Code Copilot, Codex e Gemini — usar ferramentas externas. Com o servidor MCP da Treeunfe, o agente pode emitir, consultar e cancelar notas a partir de um pedido em linguagem natural.

Emita uma NF-e de venda em homologação para o cliente 12345678909,
com 1 unidade do produto 6654, e me devolva a chave de acesso.

​

Endereço do servidor

https://mcp.treeunfe.com.br/mcp

O servidor usa o transporte HTTP (Streamable HTTP). Não é preciso instalar nada no computador para clientes que se conectam a servidores remotos.

​

Autenticação

O MCP usa a mesma API Key da organization das rotas REST (o rawKey). Veja API Keys para gerar uma.

Envie a chave de um destes jeitos:

Use o Bearer quando o seu cliente de IA só souber enviar token nesse formato (por exemplo, o Codex e a API do Claude).

Sem a chave, o servidor responde 401 com a mensagem x-api-key não fornecida.

​

Homologação ou produção

O ambiente segue a API Key, como na API REST:

• Uma chave de HOMOLOGACAO emite notas sem valor fiscal.
• Uma chave de PRODUCAO emite notas reais.

​

Cuidados com agentes

Um agente com acesso à emissão pode gerar notas reais. Antes de liberar em produção:

• Dê só os escopos necessários. Um agente que só consulta precisa de nfe:read. Deixe nfe:emit só para quem emite.
• Uma chave por agente. Assim você revoga uma integração sem afetar as outras.
• Peça confirmação antes de emitir ou cancelar. Configure o cliente de IA para pedir aprovação antes de chamar ferramentas que geram ou cancelam notas.
• Guarde a chave fora do código. Use variáveis de ambiente ou o cofre de segredos do cliente.

​

Próximos passos