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

> O que é MCP, como conectar o Claude ao SendNF e emitir NFS-e conversando, com pré-emissão, confirmação antes de emitir e segurança por chave de teste e produção.

Fonte: https://sendnf.com/blog/emitir-nota-fiscal-com-ia-mcp/ · Publicado: 2026-10-18 · SendNF

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](/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:

```bash
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.

3. **Peça a nota**.

## Como é uma conversa de verdade

> Você: Emite a nota da Acme: R$ 1.500 de desenvolvimento de software, referente a outubro.

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.

> IA: A nota está pronta: Acme Tecnologia, R$ 1.500,00, código 01.01.01, ISS de 2%. Você está em produção. Posso emitir?

> Você: Pode.

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](/mcp/).

## Perguntas frequentes

### Dá para emitir nota fiscal pelo Claude?

Sim. Conectando o Claude ao servidor MCP do SendNF com a sua chave de API, você pede a nota em português e a IA consulta o código de serviço, pré-emite e emite pela sua empresa.

### E pelo ChatGPT?

O servidor do SendNF segue o protocolo MCP por HTTP. Funciona em qualquer cliente que suporte servidores MCP remotos com header de autorização; o Claude Code e o Claude Desktop são os mais usados hoje.

### A IA pode emitir uma nota errada?

O servidor orienta a IA a pré-emitir antes e a confirmar com você antes de emitir ou cancelar em produção, e a pré-emissão bloqueia os erros de cadastro e de layout. Para testar sem risco, use uma chave de teste: tudo vai para homologação, sem valor fiscal.

### O MCP do SendNF é pago à parte?

Não. Está incluído em todos os planos, inclusive no grátis. As notas emitidas pela IA contam como qualquer outra nota.

