Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.engineapi.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
O que é o MCP Server?

O Model Context Protocol (MCP) é um padrão aberto da Anthropic que permite agentes AI interagirem com ferramentas externas de forma estruturada. O MCP Server do EngineAPI expõe 10 tools fiscais para qualquer cliente MCP compatível. Em 5 minutos você terá o Claude emitindo notas fiscais em nome dos seus emissores.

​
Início Rápido — Claude Desktop

1. Obtenha sua API Key Acesse app.engineapi.com.br → Configurações → API Keys e copie sua chave (formato ek_live_...). 2. Configure o Claude Desktop Edite o arquivo ~/.claude/claude_desktop_config.json: 
{
  "mcpServers": {
    "engineapi": {
      "command": "npx",
      "args": ["@engineapi/mcp-server"],
      "env": {
        "ENGINEAPI_KEY": "ek_live_sua_chave_aqui"
      }
    }
  }
}
3. Reinicie o Claude Desktop e peça:
“Liste meus emissores cadastrados no EngineAPI” “Emita uma NFSe de R$ 3.500 para o CNPJ 12.345.678/0001-90, serviço de desenvolvimento de software”

​
Cursor / Continue.dev

Crie .cursor/mcp.json na raiz do seu projeto: 
{
  "mcpServers": {
    "engineapi": {
      "command": "npx",
      "args": ["@engineapi/mcp-server"]
    }
  }
}
Adicione ENGINEAPI_KEY=ek_live_... nas variáveis de ambiente do Cursor.

​
Modo HTTP+SSE (avançado)

Para integrações web (n8n, Make.com): 
ENGINEAPI_KEY=ek_live_xxx npx @engineapi/mcp-server --http --port 3015
Ou acesse nosso servidor público: https://mcp.engineapi.com.br

​
Variáveis de Ambiente

VariávelObrigatórioDescrição
ENGINEAPI_KEY✅Sua API Key (ek_live_...)
ENGINEAPI_BASE_URLNãoOverride da URL da API
MCP_CORS_ORIGINSNãoOrigens CORS (modo HTTP, default: *)

​
Tools Disponíveis

emitir_nfe

Emite NF-e (Modelo 55) com itens, NCM e destinatário

emitir_nfse

Emite NFS-e de prestação de serviços

emitir_cte

Emite Conhecimento de Transporte Eletrônico

emitir_mdfe

Emite Manifesto de Documentos Fiscais

listar_notas

Lista documentos com filtros (tipo, status, período)

consultar_status

Status detalhado por ID ou chave de acesso (44 dígitos)

cancelar_nota

Cancela nota autorizada com justificativa SEFAZ

listar_emissores

Lista emissores com status do certificado digital

consultar_cnpj

Consulta dados na Receita Federal

status_sefaz

Disponibilidade dos serviços SEFAZ por UF

​
Exemplos de Uso com Claude

// Emitir nota de serviço
"Emita uma NFSe de R$ 2.500 para a empresa 12.345.678/0001-90,
 serviço de consultoria em TI, emissor Alpha LTDA"

// Consultar notas do mês
"Liste as NFe autorizadas em maio de 2026"

// Verificar SEFAZ antes de emitir
"O SEFAZ de SP está funcionando?"

// Cancelar com justificativa
"Cancele a nota UUID-123 — erro nos dados do destinatário"

​
Segurança

  • Sua ENGINEAPI_KEY nunca trafega para fora do EngineAPI — ela é usada apenas para autenticar chamadas ao api.engineapi.com.br
  • Todas as ações passam pelos Guards de autenticação e rate limit do seu plano
  • Logs de auditoria são gerados normalmente para cada ação via MCP
O ambiente de sandbox (emissão em homologação SEFAZ) é ativado automaticamente quando o emissor selecionado tem sandbox=true. O MCP sempre informa quando está em modo sandbox.