Ouviu falar de MCP. Ainda não mexeu. Agora entende.
Model Context Protocol é o padrão que conecta agentes de IA a ferramentas externas — criado pela Anthropic, adotado pela indústria inteira. Em dois minutos você vai saber o que é, como funciona, e por que existe um servidor MCP oficial da NFE.io.
Pensa nele como USB-C pra agentes de IA.
Antes do USB-C, cada aparelho vinha com um conector diferente. Carregador do iPhone, carregador do Android, cabo da câmera, cabo do HD externo — cinco tomadas pra lembrar. Com USB-C, um cabo só fala com qualquer aparelho. Model Context Protocol faz isso pra IA.
Um protocolo. Qualquer agente. Qualquer ferramenta.
Antes do MCP, cada agente (Claude, ChatGPT, Cursor) falava com cada API do seu jeito. Você escrevia glue code pra cada combinação. Com MCP, a API fala uma vez — qualquer cliente MCP (Claude Desktop, Cursor, VS Code, Continue, Windsurf) conecta sem adaptador.
MCP em 3 peças.
Tudo no MCP encaixa em três substantivos: servidor, tools e cliente. Se você entende esses três, você entende MCP.
Servidor MCP
Processo que expõe capacidades pra serem usadas por agentes. Não é API REST comum — é um protocolo com descoberta automática: o cliente pergunta o que o servidor sabe fazer, e o servidor responde com uma lista tipada.
mcp.nfe.io ↓ listTools() → [5 tools] callTool(name, args) → result
Tools
Unidade de capacidade. Cada tool tem um nome, uma descrição em linguagem natural (pro agente entender quando chamar), um schema de input validado, e annotations indicando se é destrutiva/idempotente.
nfeio_lookup_cnpj
input: { cnpj: string }
output: { legalEntity: {...} }
read-only, idempotent
Cliente MCP
O app onde seu agente roda. Claude Desktop, Cursor, VS Code, Continue, Windsurf — todos falam MCP nativamente. Você não instala plugin. Aponta o cliente pro servidor via config, e o agente já vê as tools.
{
"mcpServers": {
"nfeio": { ... }
}
}
O que acontece entre você digitar "consulta esse CNPJ" e a resposta aparecer.
Três passos. Tudo automático depois que você configura uma vez.
Quatro motivos pra existir um servidor MCP oficial da NFE.io.
A API da NFE.io já funciona há anos via REST e SDK. Um servidor MCP não substitui — complementa. Ele remove fricção pro caso específico de quem quer operar via agente de IA.
Agente não escreve código HTTP
Com MCP, o agente chama tools. Sem MCP, ele tem que escrever fetch, montar headers, tratar 202, fazer polling, mapear erro. O MCP server já faz tudo isso por dentro — agente só expressa intenção.
Schemas eliminam alucinação
Tool MCP tem schema Zod validado. Se o agente tentar passar um CNPJ com 15 dígitos, o servidor rejeita antes de tocar na API. O LLM recebe a mensagem de erro e corrige. Sem schema, ele mandaria o dado torto pra Receita.
Descoberta automática
O cliente MCP pergunta "o que você sabe fazer?" e recebe a lista completa de tools com descrições, schemas, annotations. Nada pra instalar. Nada pra versionar. Se adicionamos uma tool nova, aparece sem cliente restart.
Autenticação por request
Cada cliente manda a API key dele no header Authorization: Bearer. O servidor é stateless — zero armazenamento. Isso significa multi-tenant natural e superfície de ataque mínima.
Cinco tools. Uma frase cada.
Toda a superfície inicial do mcp.nfe.io. Feita pra cobrir os 90% dos casos mais comuns de um agente operando fiscal brasileiro.
Agora que você entende, conecta em 30 segundos.
Crie conta grátis, pega a API key, cola uma linha de config no seu cliente MCP favorito. Pronto. Seu agente passa a saber emitir nota fiscal, consultar CNPJ e resolver CEP como se fosse nativo.