Integrar um ERP a ferramentas de inteligência artificial costumava exigir semanas de desenvolvimento, conectores customizados e manutenção constante. O Model Context Protocol (MCP) muda essa equação. Criado pela Anthropic como um padrão aberto, o MCP funciona como uma ponte universal entre assistentes de IA e sistemas externos, incluindo plataformas de emissão fiscal.
Neste post, você vai entender o que é o MCP, como ele se conecta à operação fiscal brasileira, quais ferramentas a NFE.io expõe via MCP e como configurar tudo em menos de 5 minutos. Se você é desenvolvedor, contador, operador financeiro ou gestor de ERP, este guia cobre desde a arquitetura técnica do protocolo até o passo a passo de uso prático.
Como funciona o Model Context Protocol (MCP)
O MCP foi criado pela Anthropic em 2024 como um padrão aberto para resolver um problema específico: modelos de linguagem sofisticados ficavam isolados dos sistemas onde os dados realmente vivem. Cada integração exigia desenvolvimento customizado, e o resultado era uma colcha de retalhos de conectores frágeis.
A analogia mais usada é a do USB-C para IA. Assim como o USB-C substituiu dezenas de cabos proprietários por um conector universal, o MCP padroniza a comunicação entre qualquer assistente de IA e qualquer sistema externo: ERP, banco de dados, plataforma fiscal, CRM.
Segundo a especificação oficial do MCP, a arquitetura tem três camadas: o Host (aplicação de IA, como o Claude Desktop), o Client (conector dentro do host que gerencia a conexão) e o Server (serviço que expõe ferramentas e dados). A comunicação usa JSON-RPC 2.0 e funciona sobre HTTP.
O que o MCP expõe: Tools, Resources e Prompts
O protocolo organiza as capacidades de um servidor em três primitivas:
| Primitiva | O que é | Exemplo fiscal |
| Tools | Funções que a IA pode executar | Emitir NF-e, consultar CNPJ, validar chave de acesso |
| Resources | Dados contextuais que a IA pode ler | Tabela de NCM, alíquotas ICMS por estado, lista de CFOPs |
| Prompts | Templates de interação pré-configurados | “Emitir nota fiscal para [cliente] com [itens]” |
Para o contexto fiscal, as Tools são a primitiva mais relevante. Cada ferramenta tem um nome, uma descrição em linguagem natural e um schema de parâmetros. Quando o usuário pede “consulte o CNPJ 18.792.479/0001-01”, a IA identifica a ferramenta correta, monta os parâmetros e executa a chamada.
Por que MCP importa para operações fiscais no Brasil
O Brasil tem um dos sistemas tributários mais complexos do mundo. Emitir uma nota fiscal envolve regras que variam por município (NFS-e), estado (ICMS, NF-e) e tipo de operação (CFOP, CST, NCM). A Reforma Tributária adiciona novas obrigações como IBS e CBS, regulamentadas pela LC 214/2025 e detalhadas na NT 2025.002-RTC da SEFAZ.
Nesse cenário, o MCP resolve três problemas concretos:
- Acesso sem fricção. O operador financeiro não precisa aprender endpoints de API, tokens de autenticação ou estruturas de payload JSON. Ele pede à IA o que precisa em português.
- Contexto contínuo. A IA mantém o contexto da conversa. Se o usuário consultou um CNPJ e depois pediu para emitir uma nota para aquela empresa, a IA já tem os dados, sem retrabalho.
- Validação em tempo real. Antes de emitir, a IA pode validar CPF/CNPJ, conferir a chave de acesso de uma nota existente e consultar a taxa Selic ou IPCA, tudo na mesma conversa, usando ferramentas diferentes do mesmo servidor MCP.
O que é o servidor MCP da NFE.io
A NFE.io disponibiliza um servidor MCP remoto em https://mcp.nfe.io/mcp que expõe 21 ferramentas fiscais para qualquer assistente de IA compatível. A autenticação usa OAuth 2.0: o usuário faz login com suas credenciais da NFE.io e a IA recebe acesso autorizado às operações da conta.
As ferramentas se dividem em dois grupos:
| Categoria | Ferramentas | Requer autenticação? |
| Consultas e validação | CPF, CNPJ, chave NF-e, endereço (Correios), dados IBGE, taxa Selic, IPCA | Não (13 ferramentas gratuitas) |
| Emissão de documentos | NF-e, NFS-e, NFC-e | Sim (conta NFE.io autenticada) |
A emissão via MCP funciona da mesma forma que via API REST: o processamento é assíncrono (a NFE.io retorna o ID da nota e processa em fila), e o motor de cálculo automático de impostos calcula ICMS, PIS e COFINS quando o usuário não informa os dados tributários completos.
Como conectar o Claude à NFE.io via MCP: passo a passo
A configuração leva menos de 5 minutos e não exige instalação local. O servidor MCP da NFE.io roda na nuvem:
- Copie a URL do servidor: https://mcp.nfe.io/mcp
- No Claude, acesse Perfil → Personalizar → Conectores
- Clique em Adicionar → Adicionar conector personalizado
- Preencha: Nome: NFE.io | URL: cole a URL copiada
- Autenticação: marque “Obrigatório quando o servidor solicitar” (sem isso, as ferramentas de emissão não funcionam)
- Cliente OAuth: selecione “Use seu próprio cliente OAuth” | ID: mcp | Secret: deixe em branco
- Clique em Adicionar, depois em Vincular
- Faça login com suas credenciais do app.nfe.io
Após a vinculação, o Claude reconhece as 21 ferramentas. O mesmo servidor funciona com ChatGPT, Gemini, GitHub Copilot e IDEs como o Cursor.
MCP vs. integração direta via API REST: quando usar cada um
O MCP não substitui a API REST da NFE.io. Ele adiciona uma camada de acesso conversacional sobre ela. A escolha depende do caso de uso:
| Critério | MCP (via assistente de IA) | API REST (integração direta) |
| Quem usa | Operador financeiro, contador, gestor | Desenvolvedor, time de engenharia |
| Caso de uso | Consultas ad hoc, emissões pontuais, validações | Emissão em lote, automação em produção, integração ERP |
| Setup | Minutos (conector no Claude/ChatGPT) | Horas a dias (código, tokens, webhooks) |
| Volume | Baixo a médio (operação manual assistida) | Alto (milhares de notas/dia automatizadas) |
| Personalização | Limitada ao que o servidor MCP expõe | Total (todos os endpoints, payloads customizados) |
Na prática, os dois coexistem. O ERP integrado via API processa o volume diário automaticamente, enquanto o MCP serve para operações pontuais: uma consulta rápida, uma emissão avulsa, uma validação antes de fechar contrato com um fornecedor.
Exemplo prático: emitindo uma NF-e pelo Claude com MCP
Com o conector NFE.io ativo no Claude, o fluxo de emissão de uma NF-e de produto funciona assim:
- O usuário diz: “Emita uma NF-e de venda para a empresa CNPJ 12.345.678/0001-90, produto: 5 unidades de ‘Sensor de temperatura’, NCM 85171300, valor unitário R 49,90, CFOP 5102.”
- O Claude identifica a ferramenta de emissão de NF-e no servidor MCP e monta o payload com os dados informados.
- O servidor MCP chama a API POST /v2/companies/{companyId}/productinvoices com o JSON estruturado. Se dados tributários não foram informados, o motor de cálculo automático preenche ICMS, PIS e COFINS.
- A API retorna HTTP 202 com o ID da nota. O processamento é assíncrono: a nota entra em fila para validação na SEFAZ.
- O Claude informa o ID e pode consultar o status depois: “Qual o status da nota [ID]?” O servidor MCP retorna se a nota foi autorizada, rejeitada ou está em processamento.
- Após autorização, o usuário pode pedir o DANFE em PDF ou o XML da nota, ambos disponíveis via ferramentas do MCP.
Esse fluxo completo acontece dentro da conversa, sem trocar de tela, sem abrir o painel da NFE.io, sem escrever uma linha de código.
Segurança e controle de acesso no MCP
A segurança é uma preocupação central do protocolo. Três princípios governam o acesso:
Consentimento explícito do usuário. A IA não executa nenhuma ferramenta sem aprovação. Quando o Claude identifica que precisa chamar a ferramenta de emissão de NF-e, ele mostra ao usuário o que vai fazer antes de executar.
Autenticação OAuth 2.0. No caso da NFE.io, o servidor MCP exige login via app.nfe.io. As credenciais nunca são expostas à IA. O protocolo OAuth garante que o token de acesso é gerenciado pelo host (Claude), não pelo modelo de linguagem.
Atualização de julho de 2026. A especificação 2026-07-28 endureceu a autorização: validação do parâmetro iss conforme RFC 9207, credenciais vinculadas ao emissor que as criou e transição para Client ID Metadata Documents (CIMD).
O ecossistema MCP em 2026: quem mais adota
O MCP deixou de ser um protocolo experimental. Empresas como Block (dona do Square e Cash App) e Apollo já operam com MCP em produção. Plataformas de desenvolvimento como Zed, Replit, Codeium e Sourcegraph integram o protocolo para dar contexto aos assistentes de código.
Os SDKs oficiais estão disponíveis em TypeScript, Python, Go e C# (Rust em beta). Servidores pré-construídos cobrem Google Drive, Slack, GitHub e PostgreSQL, o que posiciona o MCP como padrão de facto para integração entre IA e sistemas externos.
No ecossistema fiscal brasileiro, a NFE.io é a plataforma de emissão com servidor MCP nativo. Existem projetos open-source de consulta fiscal via MCP, como o mcp-fiscal-brasil (44 ferramentas de consulta e compliance), mas esses são complementares: focam em análise e validação, não em emissão de documentos fiscais.
Próximo passo: conecte sua operação fiscal à IA
O MCP transforma o assistente de IA em uma interface direta para o sistema fiscal. Em vez de navegar painéis, copiar dados entre telas e formatar payloads JSON, o operador financeiro faz o que sempre precisou: pede o que quer em português e recebe o resultado.
Para começar, configure o conector MCP da NFE.io no Claude em nfe.io/mcp/claude. São 5 minutos de setup e 21 ferramentas fiscais disponíveis na conversa. Se a operação exige volume, a API REST da NFE.io (nfe.io/docs) continua sendo o caminho para integração direta com o ERP.
