MCP Model Context Protocol · HTTP

Sua IA emite nota fiscal

Conecte o assistente que você já usa ao AceleraAPI e ele passa a consultar CNPJ, classificar NCM, checar a SEFAZ e emitir documento fiscal de verdade — com o seu token, o seu limite e o seu consumo.

Conectar agora Ver a API →

Claude DesktopClaude CodeChatGPT CursorCopilotWindsurf

conversa no Claude exemplo

1você: emita uma NF-e de 2 camisetas a

2 R$ 49,90 para o CNPJ 11.222.333/0001-81

4→ status_sefaz MG operacional

5→ consultar_cnpj destinatário ativo

6→ classificar_produto NCM 6109.10.00

8Claude: vou emitir NF-e de R$ 99,80.

9 Confirma? (produção, irreversível)

11você: confirmo

12→ emitir_documento autorizada

13 nº 1 · chave 31260753…0187

autorizada confirmação pedida pelo cliente MCP, não por nós

Dois campos, nenhuma instalação

Como conectar

Endereço do servidor

https://aceleraapi.com.br/mcp

Transporte HTTP. Não há pacote para instalar nem processo local para manter.

Credencial

Authorization: Bearer ace_…

O mesmo token da API. Pegue em Painel › Chaves de API. Ainda não tem conta? Crie grátis.

Qual token usar. ace_ é o token de uma empresa: dá acesso só àquele CNPJ e aos produtos ativos nele — é o que recomendamos entregar a um assistente. aca_ é a chave matriz e alcança a administração da licença inteira (cadastrar empresa, ver consumo). Trate a chave matriz como você trataria a senha do banco.

Claude Desktop · Claude Code · Cursor · Windsurf

No arquivo de configuração do cliente (claude_desktop_config.json, .mcp.json ou equivalente):

claude_desktop_config.json JSON

2 "mcpServers": {

3 "aceleraapi": {

4 "type": "http",

5 "url": "https://aceleraapi.com.br/mcp",

6 "headers": {

7 "Authorization": "Bearer ace_SEU_TOKEN"

8 }

9 }

10 }

11}

salve e reinicie o cliente as ferramentas aparecem na lista do assistente

Testar pela linha de comando

Antes de configurar o cliente, confirme que a credencial funciona:

tools/list cURL

1curl -X POST https://aceleraapi.com.br/mcp \

2 -H "Authorization: Bearer ace_SEU_TOKEN" \

3 -H "Content-Type: application/json" \

4 -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

200 OK 14 ferramentas

14 ferramentas

O que o assistente passa a saber fazer

Leitura — consulta e diagnóstico

Ferramenta	O que faz
`aceleraapi_ping`	Verifica se a credencial é válida e informa o tipo de chave (desenvolvedor ou empresa), a conta e a empresa vinculada.
`status_sefaz`	Disponibilidade atual da SEFAZ e dos autorizadores por documento e por UF, além do status dos endpoints do AceleraAPI.
`consultar_cnpj`	Dados cadastrais de um CNPJ na Receita Federal: razão social, nome fantasia, situação cadastral, endereço completo, CNAEs, quadro societário (QSA) e enquadramento no Simples ou MEI.
`classificar_produto`	Classificação fiscal de um produto pelo código de barras (EAN/GTIN): NCM, CEST, alíquotas de ICMS por estado, substituição tributária, PIS/COFINS e a tributação da reforma (IBS, CBS e IS).
`consultar_ncm`	Busca na tabela NCM por código de 8 dígitos ou por descrição do produto.
`consultar_municipio`	Código IBGE de um município a partir do nome e da UF, ou os dados do município a partir do código de 7 dígitos.
`cobertura_nfse`	Verifica se um município aderiu ao Emissor Nacional de NFS-e.
`listar_empresas`	Lista os CNPJs cadastrados na sua licença, com os produtos ativos de cada um.
`consultar_consumo`	Consumo do mês por produto e por empresa, com o total de requisições.
`listar_documentos`	Lista os documentos fiscais já emitidos pela empresa do token, do mais recente para o mais antigo, com número, chave, situação e valor.
`consultar_documento`	Detalhe de um documento fiscal já emitido: situação, chave de acesso, protocolo de autorização, valores e os caminhos para baixar XML e PDF.

Escrita — pedem confirmação no cliente MCP

Ferramenta	O que faz
`emitir_documento`	EMITE UM DOCUMENTO FISCAL REAL na SEFAZ, em nome da empresa do token.
`cancelar_documento`	Cancela na SEFAZ um documento fiscal já autorizado.
`cadastrar_empresa`	Cadastra um novo CNPJ (empresa) na sua licença e devolve o token ace_ dela.

As ferramentas de escrita são declaradas ao protocolo com destructiveHint, que é o sinal para o cliente MCP exigir confirmação humana antes de executar. Emissão em produção tem efeito tributário e só pode ser desfeita por cancelamento, dentro do prazo legal.

Sem caminho paralelo

Por dentro, é a mesma API

Mesma autenticação

O token que você dá ao assistente é o token da API. A permissão é idêntica — nada é liberado a mais por ser IA.

Mesma medição

Cada chamada entra no seu consumo como qualquer outra requisição, a R$ 0,01. Consultar o status da SEFAZ não é cobrado.

Mesmo registro

A requisição aparece no seu relatório com rota e status, então dá para auditar exatamente o que o assistente fez.

Dúvidas

Perguntas frequentes

O que é um servidor MCP fiscal?

MCP (Model Context Protocol) é o padrão aberto que permite a um assistente de IA usar ferramentas externas. Um servidor MCP fiscal expõe as operações de documento fiscal — consultar CNPJ, classificar NCM, emitir NF-e — como ferramentas que o assistente pode chamar diretamente, sem você escrever código de integração.

A IA emite nota fiscal de verdade?

Sim. A ferramenta de emissão chama a mesma API que o seu sistema chamaria, com o seu token, e o documento é autorizado na SEFAZ. Por isso a emissão e o cancelamento são declarados como operações destrutivas no protocolo: o cliente MCP pede confirmação ao usuário antes de executar.

Preciso instalar algo para usar o MCP do AceleraAPI?

Não. O servidor é HTTP: basta informar a URL https://aceleraapi.com.br/mcp e o header Authorization com o seu token no cliente MCP. Não há processo local, pacote npm nem binário para instalar.

Usar por MCP custa mais caro?

Não. As chamadas passam pela mesma API, com o mesmo token, o mesmo limite de requisições e o mesmo preço de R$ 0,01 por requisição bem-sucedida. Consultar o status da SEFAZ pelo MCP não consome requisição.

A IA tem acesso a tudo da minha conta?

Ela tem exatamente a permissão do token que você fornecer. Um token de empresa (ace_) só alcança aquele CNPJ e os produtos ativos nele; a chave matriz (aca_) alcança a administração da licença. Para dar acesso restrito ao assistente, use o token de uma empresa específica.