MCP Server

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 8 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ável | Obrigatório | Descrição | |----------|-------------|-----------| | ENGINEAPI_KEY | ✅ | Sua API Key (ek_live_...) | | ENGINEAPI_BASE_URL | Não | Override da URL da API | | MCP_CORS_ORIGINS | Não | Origens CORS (modo HTTP, default: *) |

Tools Disponíveis

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