Servidor MCP
Emita nota fiscal conversando com a IA
O SendNF tem um servidor MCP com 21 ferramentas. Conecte o Claude com a sua chave de API e peça a nota em português: a IA acha o código de serviço, pré-emite e só emite quando você confirma.
Resposta curta: Para emitir nota pelo Claude, crie uma chave de API no SendNF e adicione o servidor MCP https://api.sendnf.com/mcp com o header Authorization: Bearer <chave>. Depois é só pedir a nota na conversa.
Emite a nota da Acme: R$ 1.500 de desenvolvimento de software, referente a outubro.
search_service_codes("desenvolvimento de software") → 01.01.01 Análise e desenvolvimento de sistemas
preview_nfse → pronta para emitir (validada no XSD oficial)
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?
Pode.
issue_nfse → authorized, NFS-e nº 1042
Emitida: NFS-e nº 1042. O PDF e o XML foram para financeiro@acme.com.br.
claude mcp add --transport http sendnf https://api.sendnf.com/mcp \
--header "Authorization: Bearer nt_test_..."{
"mcpServers": {
"sendnf": {
"type": "http",
"url": "https://api.sendnf.com/mcp",
"headers": { "Authorization": "Bearer nt_test_..." }
}
}
}Passo a passo
Como conectar
- 1
Crie a conta e uma chave de API
No painel do SendNF, em Desenvolvedores, crie uma chave nt_test_ para testar em homologação. Use nt_live_ quando quiser notas reais.
- 2
Adicione o servidor MCP
No Claude Code, rode o comando claude mcp add com a URL https://api.sendnf.com/mcp e o header Authorization. No Claude Desktop e em outros clientes, use a configuração JSON.
- 3
Peça a nota em português
Por exemplo: "emite a nota da Acme de R$ 1.500 de desenvolvimento". A IA pré-emite, mostra o resumo e emite quando você confirma.
Ferramentas
As 21 ferramentas do servidor
As marcadas com escrita mudam algo na sua conta; as outras só leem.
| Ferramenta | O que faz | Tipo |
|---|---|---|
| account_overview | Modo da chave, plano, uso do mês e o que falta em cada empresa. | leitura |
| lookup_cnpj | Dados públicos da Receita, sistema da prefeitura e códigos de serviço sugeridos pelo CNAE. | leitura |
| search_service_codes | Busca na lista nacional de serviços por palavras do dia a dia ou pelo código. | leitura |
| get_service_code | Descrição oficial de um código e os NBS possíveis. | leitura |
| how_to_get | Passo a passo para conseguir dados não públicos (certificado, CSC, inscrição municipal…). | leitura |
| list_companies | Empresas emitentes da conta. | leitura |
| get_company | Dados da empresa, dados públicos e o checklist com guias. | leitura |
| create_company | Cadastra a empresa só com o CNPJ. | escrita |
| import_invoice | Lê o XML de uma nota antiga e cadastra ou completa a empresa (inscrições, códigos, numeração). | escrita |
| update_company | Atualiza inscrição municipal, código padrão, CSC, senha da prefeitura. | escrita |
| upload_certificate | Envia o certificado A1 fornecido pelo usuário. | escrita |
| check_readiness | O que falta para emitir NFS-e e NFC-e. | leitura |
| preview_nfse | Pré-emite a NFS-e sem transmitir. | leitura |
| issue_nfse | Emite a NFS-e e espera o resultado. | escrita |
| preview_nfce | Pré-emite a NFC-e sem transmitir. | leitura |
| issue_nfce | Emite a NFC-e e espera o resultado. | escrita |
| list_documents | Lista notas por empresa, status, tipo e referência. | leitura |
| get_document | Status, motivo de rejeição explicado e links de PDF e XML. | leitura |
| cancel_document | Cancela uma nota autorizada (pede confirmação). | escrita |
| retry_document | Reenvia uma nota parada depois de corrigir o que faltava. | escrita |
| order_certificate | Pede um certificado digital pelo SendNF. | escrita |
Segurança
Você no controle
Chave por modo
Uma chave nt_test_ nunca emite nota real. Teste à vontade antes de usar nt_live_.
Confirmação antes de emitir
As instruções do servidor pedem pré-emissão e confirmação antes de emitir ou cancelar em produção.
Segredos protegidos
Certificado, CSC e senhas da prefeitura ficam cifrados e nunca voltam nas respostas.
Quer entender o caso de uso por completo? Leia como emitir nota fiscal com IA.
Perguntas sobre o MCP
O que é MCP?
MCP (Model Context Protocol) é um protocolo aberto para conectar assistentes de IA a ferramentas externas. Com o servidor MCP do SendNF, a IA passa a consultar CNPJ, pré-emitir e emitir notas usando a sua chave de API.
Quais clientes funcionam?
Qualquer cliente compatível com MCP por HTTP (Streamable HTTP), como o Claude Code e o Claude Desktop. O servidor é sem sessão e responde em JSON.
A IA pode emitir nota sem eu pedir?
Ela só age com a chave que você configurou. As instruções do servidor mandam pré-emitir antes de emitir e confirmar com você antes de emitir ou cancelar em produção. Para testar sem risco, use uma chave nt_test_: tudo vai para homologação.
E se faltar um dado, como a inscrição municipal?
A ferramenta how_to_get traz o passo a passo oficial do SendNF para cada dado que não é público. O servidor orienta a IA a explicar como conseguir o dado em vez de inventá-lo.
O MCP custa à parte?
Não. O servidor MCP está incluído em todos os planos e as notas emitidas por ele contam como qualquer outra nota.
Conecte a IA em dois minutos
Crie a conta, gere uma chave de teste e adicione o servidor MCP. Homologação ilimitada e grátis.