Como emitir nota fiscal com IA: NFS-e pelo Claude com MCP

Para emitir nota fiscal com IA, você conecta um assistente compatível com MCP (Model Context Protocol), como o Claude, ao servidor MCP do SendNF usando a sua chave de API. A partir daí, basta pedir em português, por exemplo "emite a nota da Acme de R$ 1.500 de desenvolvimento de software", e a IA usa as ferramentas do SendNF para achar o código de serviço, pré-emitir a nota, mostrar o resumo e emitir quando você confirmar. O PDF e o XML vão para o cliente por e-mail.

O que é MCP, em uma frase

MCP é um protocolo aberto que permite a assistentes de IA usar ferramentas externas de forma padronizada. Um "servidor MCP" expõe ferramentas (consultar, criar, emitir) com descrições e parâmetros; o assistente decide quando chamar cada uma, e você vê o que ele está fazendo.

Para nota fiscal, isso resolve um problema antigo: quem emite nota quase nunca é técnico. Ele sabe o que vendeu, para quem e por quanto. O resto (código de serviço, NBS, alíquota, layout da prefeitura) é exatamente o tipo de coisa que uma IA com as ferramentas certas resolve bem.

O que o servidor do SendNF sabe fazer

O servidor tem 21 ferramentas. As mais usadas numa emissão:

• account_overview: mostra se a chave é de teste ou de produção, o plano, o uso do mês e o que falta em cada empresa.
• lookup_cnpj: busca os dados públicos da empresa na Receita, descobre o sistema da prefeitura e sugere códigos de serviço pelo CNAE.
• search_service_codes: acha o código de tributação nacional a partir de palavras do dia a dia ("dentista", "aula de inglês").
• preview_nfse: pré-emite a nota, sem transmitir, e devolve os problemas com guia.
• issue_nfse: emite e espera o resultado.
• how_to_get: explica como conseguir um dado que não é público (certificado, inscrição municipal, CSC).
• cancel_document: cancela uma nota autorizada.

A lista completa está na página do servidor MCP.

Como conectar em dois minutos

1. Crie a conta no SendNF e uma chave de API em Desenvolvedores. Comece com uma chave nt_test_, que emite só em homologação.
2. Adicione o servidor. No Claude Code:

claude mcp add --transport http sendnf https://api.sendnf.com/mcp \
  --header "Authorization: Bearer nt_test_..."

No Claude Desktop e em outros clientes, use a configuração em JSON com a mesma URL e o mesmo header.

1. Peça a nota.

Como é uma conversa de verdade

A IA chama search_service_codes e encontra o 01.01.01 (análise e desenvolvimento de sistemas). Depois chama preview_nfse com o tomador, o valor e o código. A pré-emissão valida a DPS no XSD oficial e responde que está pronta.

A IA chama issue_nfse, que espera a autorização e devolve o número da nota e os links. O tomador recebe o PDF e o XML por e-mail.

O ponto importante: a IA não inventa dado fiscal. Se faltar a inscrição municipal, por exemplo, a pré-emissão devolve o problema com o guia, e a IA explica como conseguir em vez de chutar um número.

Segurança: por que é seguro deixar a IA emitir

Modo de teste. Uma chave nt_test_ nunca emite nota real. Use-a para ensinar a IA a emitir do jeito que você quer, sem risco.

Confirmação. As instruções do servidor pedem para a IA pré-emitir antes de emitir e confirmar com você antes de emitir ou cancelar em produção. Clientes MCP também costumam pedir aprovação a cada chamada de ferramenta de escrita.

Pré-emissão como trava. Erros de cadastro e de layout são barrados antes da transmissão.

Segredos protegidos. Certificado, CSC e senhas da prefeitura ficam cifrados no SendNF e nunca voltam nas respostas, nem para a IA.

Idempotência. Se a IA repetir a chamada por engano com a mesma referência, a mesma nota é devolvida em vez de uma nova.

Para quem isso faz mais sentido

• MEI e autônomos que emitem poucas notas e não querem abrir um emissor para cada uma.
• Donos de pequenos negócios que já usam assistentes de IA no dia a dia.
• Contadores, para emitir pelos clientes em lote, conversando.
• Desenvolvedores, para prototipar a integração antes de escrever código: o MCP usa a mesma API.

Limites atuais

O SendNF emite NFS-e para MEI, Simples Nacional, Lucro Presumido e Lucro Real, e NFC-e para MEI e Simples Nacional. NF-e modelo 55 ainda não é atendida, então a IA vai dizer isso se você pedir.

Resumo

• MCP conecta a IA às ferramentas do SendNF com a sua chave de API.
• A IA acha o código, pré-emite, confirma e emite; você só conversa.
• Comece com chave de teste; troque para produção quando estiver confortável.
• O MCP está incluído em todos os planos. Veja como conectar em servidor MCP.