Instalação no Cursor

O Cursor suporta servidores MCP customizados via arquivo de configuração .cursor/mcp.json. A configuração pode ser por projeto (preferida) ou global do usuário.

Pré-requisitos

• Cursor 0.42+ (versões anteriores não suportam MCP).
• MCP_BEARER_TOKEN válido.

Configuração por projeto

Crie o arquivo .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "alcance": {
      "url": "https://mcp-alcancecontabilidade.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer COLE_AQUI_SEU_MCP_BEARER_TOKEN"
      }
    }
  }
}

Salve. O Cursor recarrega automaticamente os servidores MCP ao detectar mudanças no arquivo.

Configuração global

Se você quer o conector disponível em todos os projetos, edite o arquivo de configuração global:

• Windows: %USERPROFILE%\.cursor\mcp.json
• macOS / Linux: ~/.cursor/mcp.json

Use o mesmo formato JSON acima.

Verificar a conexão

1. Abra o Cursor.
2. Ctrl+Shift+P (ou Cmd+Shift+P) → MCP: Show Status.
3. O servidor alcance deve aparecer como connected, com a lista de tools enumerada.

Caso a lista não apareça:

• Ctrl+Shift+P → MCP: Reload Servers.
• Verifique o painel Output → MCP para mensagens de erro detalhadas.

Usar no Composer

Abra o Composer (Ctrl+I ou Cmd+I) e mencione as ferramentas explicitamente para reduzir alucinação:

Use o tool `listar_certidoes` do servidor MCP `alcance` para
listar todas as certidões com status "vencida". Em seguida,
gere um TypeScript record `Record<string, Certidao[]>` agrupado
por cliente.

O Composer:

1. Mostra um diff/preview da chamada à tool.
2. Pede confirmação (writes sempre pedem; reads dependem da config do Cursor).
3. Insere o resultado no contexto da conversa para uso na geração de código.

Limitações conhecidas

• Sem suporte a prompts MCP nativos: o Cursor consome tools e resources, mas o slash-prompt /diagnostico-cliente precisa ser invocado manualmente como mensagem no Composer (não aparece como sugestão).
• Resources não são auto-lidos: o Cursor só lê resources quando a tool/chat pede explicitamente. Para forçar, diga: "leia o resource glossario://contabil antes de responder".
• Múltiplos servidores podem causar conflito de nomes: se outro MCP também tiver buscar_cliente, qualifique como alcance.buscar_cliente no prompt.

Troubleshooting

Mais detalhes em Troubleshooting.