- MCP e agentes de IA
- MCP da Treeunfe
MCP e agentes de IA
MCP da Treeunfe
Emita e consulte NF-e conversando com o Claude e outros agentes de IA.
O MCP (Model Context Protocol) é um padrão aberto que deixa agentes de IA, como Claude, Cursor, VS Code Copilot, Codex e Gemini, usarem ferramentas externas. Com o MCP da Treeunfe, o agente emite, consulta e cancela as notas da sua empresa a partir de um pedido em linguagem natural:
Emita uma NF-e de venda em homologação para o cliente 11222333000181,
com 1 unidade do produto PROD-001, e me devolva a chave de acesso e o DANFE.
O agente consulta o checklist, monta o payload, emite a nota e confere o resultado, usando as mesmas regras do emissor e da API.
Endereço do servidor
https://mcp.treeunfe.com.br/operations/mcp
O servidor usa o transporte HTTP (Streamable HTTP). Não é preciso instalar nada para clientes que se conectam a servidores remotos.
Login
O MCP usa login OAuth com a sua conta do emissor. Não é preciso copiar API Key:
- Você adiciona o endereço do servidor no seu cliente de IA.
- O cliente abre a página de login do emissor (
nfe.treeunfe.com.br). - Você entra com o seu usuário e autoriza o acesso.
- O cliente guarda o acesso e o renova sozinho.
O acesso vale só para a empresa da sua conta. Para cortar o acesso de um cliente, desconecte o servidor nele.
Este servidor não aceita o header x-api-key. A API Key continua valendo para a API REST.
Permissões
Na autorização, o cliente pede as permissões (escopos) de que precisa:
| Escopo | Permite |
|---|---|
mcp | Usar o servidor MCP. |
nfe:read | Consultar NF-e, itens, XML, DANFE e eventos. |
nfe:emit | Emitir NF-e e registrar cancelamento, CC-e e inutilização. |
nfse:read | Consultar NFS-e. |
nfse:emit | Emitir, cancelar e substituir NFS-e. |
Homologação ou produção
A nota sai no ambiente das configurações de NF-e da empresa no emissor.
Teste o agente com a empresa em homologação. Passe para produção só depois de validar as notas que ele monta.
Cuidados com agentes
Um agente com acesso à emissão pode gerar notas reais. Antes de usar em produção:
- Peça confirmação antes de emitir, cancelar ou inutilizar. Configure o cliente para pedir a sua aprovação antes dessas ferramentas.
- Confira os dados da nota. Peça ao agente para mostrar destinatário, itens, CFOP e valores antes do envio.
- Revise as conexões. Desconecte o servidor dos clientes que você não usa mais.