Servidores MCP no Cursor

Problema: O Cursor pode ligar-se a ferramentas e dados externos, mas a história do MCP parece confusa até experimentares uma vez. Qual ficheiro? Qual formato? É igual ao Claude Code?

Vitória Rápida: Cria .cursor/mcp.json na raiz do teu projeto e cola um primeiro servidor:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-api-key" }
    }
  }
}

Reinicia o Cursor. A pesquisa web já vive dentro do IDE.

Se ainda estás a escolher quais servidores valem o teu tempo, começa com MCP Search Tools antes de os ligares ao Cursor. Lê esta página quando já sabes a categoria de servidor que queres e precisas da forma exata de config do Cursor, localizações de ficheiros e padrão de rollout. Se estás a desenhar a tua própria integração em vez de instalar uma existente, lê Custom MCP Integrations.

O Que São Servidores MCP no Cursor

Ferramentas externas, bases de dados e APIs ligam-se ao AI do Cursor através do Model Context Protocol. O comportamento é idêntico no Cursor, Claude Code e Claude Desktop porque todos falam o mesmo formato de protocolo.

Assim que um servidor é carregado, o Cursor pode:

• Ir buscar conteúdo web e documentação
• Fazer perguntas a bases de dados em linguagem natural
• Controlar GitHub, Slack e tudo o resto com integração
• Executar trabalhos de browser para testes
• Alcançar qualquer serviço que exponha um servidor MCP

O ecossistema é partilhado. Qualquer servidor MCP construído para Claude Desktop entra no Cursor sem alterações.

Configuração de Servidores MCP no Cursor

Localizações dos Ficheiros de Configuração

Há dois locais válidos:

As configs de projeto são a escolha certa para ferramentas ligadas a um codebase específico, como um servidor de base de dados para a app que estás a construir. As configs globais servem ferramentas que pertencem a todos os lados, como pesquisa web ou integração com GitHub.

Configuração Passo a Passo

Método 1: Configuração Manual

1. Cria o ficheiro de config em .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global)
2. Cola a configuração do servidor
3. Reinicia o Cursor para que os novos servidores sejam detetados
4. Testa pedindo ao AI para executar uma ferramenta do servidor

Método 2: Command Palette

1. Abre a Command Palette (Cmd+Shift+P no Mac, Ctrl+Shift+P no Windows)
2. Procura "MCP" e escolhe "View: Open MCP Settings"
3. Em MCP Tools, clica em "New MCP Server"
4. O Cursor escreve o ficheiro mcp.json e abre-o para edição

Formato de Configuração

A forma JSON corresponde ao que o Claude Desktop usa:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-name"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

Um servidor MCP baseado em Python parece quase igual:

{
  "mcpServers": {
    "python-server": {
      "command": "python",
      "args": ["path/to/server.py"],
      "env": {
        "DATABASE_URL": "postgresql://db-host/example_db"
      }
    }
  }
}

Configuração de Servidor Remoto

Servidores baseados em HTTP também são suportados:

{
  "mcpServers": {
    "remote-server": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

Útil quando o servidor corre noutra máquina ou está por trás de um serviço partilhado.

Os Melhores Servidores MCP para Cursor

Estes oferecem o maior valor por linha de config. Todos entram diretamente em .cursor/mcp.json:

Pesquisa Web e Investigação

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-key" }
    }
  }
}

Pesquisa web dentro do Cursor para consultas de documentação e investigação rápida.

Integração GitHub

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    }
  }
}

Repos, issues, PRs e revisões tudo sem sair do editor.

Acesso a Bases de Dados

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "DATABASE_URL": "postgresql://db-host/app_db" }
    }
  }
}

Consultas em linguagem natural entram, esquema e resultados saem, enquanto programas.

Automação de Browser

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@executeautomation/playwright-mcp-server"]
    }
  }
}

Cobre testes de browser, scraping e verificações visuais. Vê o guia de automação de browser para os padrões mais avançados.

Operações de Ficheiros

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

Lê e escreve ficheiros fora dos diretórios que o Cursor já monitoriza.

Memória e Conhecimento

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Mantém um grafo de conhecimento que persiste entre sessões.

O catálogo completo de servidores MCP tem mais 50+ opções.

Cursor vs MCP no Claude Code

As configs de servidor movem-se entre as duas ferramentas com quase nenhum atrito, já que ambas falam Model Context Protocol. Algumas coisas ainda diferem:

O MCP Tool Search no Claude Code carrega tools de forma lazy e reduz o uso de contexto em 95%. O Cursor carrega todas as tools configuradas no início da sessão.

Os pacotes de servidor ficam iguais nos dois lados. Uma config escrita para Claude Desktop corre no Cursor, e o inverso também se aplica.

Resolução de Problemas com Servidores MCP no Cursor

Servidor Não Carrega

Sintoma: O servidor MCP nunca aparece entre as ferramentas disponíveis.

Solução:

1. Verifica o JSON (uma vírgula a mais é a causa mais comum)
2. Fecha o Cursor completamente e relança, não apenas recarregues a janela
3. Abre o painel Output e procura erros de MCP

Autenticação Falhou

Sintoma: O servidor carrega, mas as chamadas de API voltam com erros de autenticação.

Solução: Verifica se as variáveis de ambiente estão definidas:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
      }
    }
  }
}

O padrão ${env:VAR_NAME} vai buscar às variáveis de ambiente do sistema para que os segredos nunca fiquem guardados em código.

npx Não Encontrado

Sintoma: O servidor falha com um erro de "command not found".

Solução: Confirma que Node.js está instalado e que npx está no teu PATH. Alguns sistemas precisam do caminho absoluto:

{
  "mcpServers": {
    "server-name": {
      "command": "/usr/local/bin/npx",
      "args": ["-y", "@modelcontextprotocol/server-name"]
    }
  }
}

Problemas de Ligação a Servidor Remoto

Sintoma: Um servidor baseado em HTTP recusa a ligação.

Solução:

1. Confirma que o processo do servidor está a correr e acessível
2. Verifica as regras de firewall em torno da porta
3. Certifica-te que o URL tem o protocolo certo (http vs https)

Próximos Passos

Um caminho curto para fazer crescer a tua configuração MCP no Cursor:

1. Começa simples: Liga o Brave Search para acesso web imediato
2. Adiciona ferramentas de desenvolvimento: Os servidores GitHub e de base de dados aceleram o trabalho real
3. Experimenta automação: Lança automação de browser para testes
4. Constrói o teu próprio: Lança um servidor personalizado para APIs internas
5. Explora tudo: A lista completa de servidores MCP tem o resto

Os servidores MCP transformam o Cursor de um editor fechado num ambiente de desenvolvimento ligado ao mundo. Começa com um servidor. Prova o valor. Adiciona mais quando o fluxo de trabalho o pedir.

Três Stacks MCP que São Realmente Úteis

O erro que a maioria das equipas comete é adicionar dez servidores porque pode. O movimento melhor é construir um stack por trabalho.

1. Stack de engenharia de produto

Usa este quando estás a construir funcionalidades de app de ponta a ponta:

• GitHub MCP para contexto de repo e PR
• Postgres MCP para verificações de esquema e dados
• Brave Search ou pesquisa de docs estilo Context7 para referências atuais
• Playwright MCP para verificação de browser

Isto dá ao Cursor superfície suficiente para ler código, inspecionar dados, verificar docs e validar comportamento de UI sem transformar a sessão em spam de tools.

2. Stack de conteúdo e SEO

Usa este quando estás a lançar páginas com muito conteúdo:

• GitHub MCP para conteúdo de repo e diffs
• Search MCP para investigação de concorrentes ou fontes
• Filesystem MCP para trabalhar em pastas de conteúdo fora do workspace atual

Boa escolha para equipas que escrevem landing pages, docs, changelogs ou posts de blog onde o trabalho não é só "escrever texto" mas também comparar sobreposições, atualizar links internos e manter o repo organizado.

3. Stack de debugging

Usa este quando o problema é difícil de reproduzir só com código:

• GitHub MCP para histórico de alterações
• Playwright MCP para reproduzir estado de UI
• Database MCP se o bug cheira a dependência de dados

A chave não é o número de servidores. É se as ferramentas se alinham com a superfície de falha que estás a investigar.

O Que Não Fazer

As configurações MCP no Cursor correm mal de algumas formas previsíveis:

A configuração certa não é a maior. É o menor conjunto de ferramentas que torna um fluxo de trabalho real dramaticamente melhor.

Fontes:

• Cursor MCP Documentation
• How to Add MCP Server to Cursor