Consultar notas fiscais pelo Claude: o servidor MCP da Sudrel, somente leitura

"Quanto entrou de nota esse mês?", "algum fornecedor parou de faturar?", "quanto já usei da franquia?". Perguntas assim costumam virar uma tarde de filtro no painel ou uma planilha exportada. Com o servidor MCP da Sudrel, um assistente de IA, como o Claude, responde direto, lendo as notas que a Sudrel monitora para o seu CNPJ.

O que é um servidor MCP

MCP, de Model Context Protocol, é um padrão aberto para ligar um assistente de IA a um sistema. O servidor diz ao assistente quais ferramentas existem ("listar documentos", "detalhar uma nota") e o assistente decide quando usar cada uma para responder o que você perguntou. O da Sudrel funciona no Claude Desktop, no Claude Code e em qualquer cliente que fale MCP.

Somente leitura, de propósito

A API da Sudrel tem operações de escrita: cadastrar empresa, enviar certificado, pausar, remover. Nenhuma delas está no servidor MCP, e as de emissão também não: ele não emite, não cancela e não reprocessa nota. Todo acesso passa por uma função que só faz leitura.

O que ele consulta

• Notas recebidas e emitidas: NFS-e, NF-e e CT-e capturadas, com filtro por período, fornecedor, valor, tipo e papel, e o detalhe de cada uma com prestador, tomador, valores e tributos.
• Emissão: as notas emitidas pela conta, com a linha do tempo, os ajustes que a Sudrel fez e a explicação de uma rejeição; os lotes e o resultado de cada linha; e se uma empresa já pode emitir, item por item.
• Conta: os CNPJs monitorados e o estado de cada um, o certificado, a franquia usada no ciclo e o log de eventos da conta.

Como configurar no Claude Desktop

Gere uma chave de API no painel, em Chaves de API. O recomendado é uma chave só para o assistente, de preferência restrita a uma empresa: assim dá para revogar o acesso dele sem derrubar a integração do ERP. Depois, no arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "sudrel": {
      "command": "npx",
      "args": ["-y", "@sudrel/mcp-server"],
      "env": { "SUDREL_API_KEY": "sdr_live_..." }
    }
  }
}

Para experimentar sem tocar em dado de produção, use uma chave de sandbox (sdr_test_...): o servidor funciona igual.

Perguntas que funcionam bem

• "Quais fornecedores faturaram em setembro e não faturaram em outubro?"
• "Me mostra as notas recebidas acima de R$ 5.000 em agosto."
• "Por que a nota PED-1001 foi rejeitada, e o que eu corrijo?"
• "A empresa da filial já pode emitir? Se não, o que falta?"
• "Quanto da franquia deste mês já foi usado?"

Perguntas frequentes

O assistente consegue emitir ou cancelar nota pela Sudrel?

Não. O servidor MCP da Sudrel é somente leitura: consulta notas, lotes, empresas e consumo, mas não emite, cancela, reprocessa nem altera nada.

Quais assistentes funcionam com o servidor MCP da Sudrel?

O Claude Desktop, o Claude Code e qualquer cliente compatível com o padrão MCP. A instalação usa o pacote @sudrel/mcp-server, do npm.

Que chave de API devo usar?

Uma chave dedicada ao assistente, de preferência restrita a uma empresa, para poder revogar só ela. Para testar, uma chave de sandbox funciona igual e não toca em dado de produção.

Quer integrar com código, inclusive para emitir? Veja o SDK oficial para Node.js e PHP e a documentação da API.