Como adicionar um novo servidor MCP ao Cursor

Nos últimos meses, o Cursor vem dominando o cenário dos assistentes de programação com IA e da IA agentiva para o desenvolvimento de software.

O Cursor tem muitos pontos fortes. Embora algumas pessoas o considerem “apenas um fork do VS Code”, ele oferece um fluxo de trabalho de engenharia verdadeiramente nativo de IA, com o Cursor Tab no centro da experiência. 

A experiência de desenvolvimento do Cursor vai muito além da edição de arquivos: ela também permite executar comandos no terminal e adotar um fluxo de trabalho verdadeiramente autônomo para o desenvolvimento de software. O que poderia estar faltando? Talvez a nova palavra da moda em IA: MCP. Mas não se preocupe, o Cursor também tem isso.

Servidores MCP no Cursor

O Cursor oferece suporte a servidores MCP em dois escopos:

• Um servidor MCP definido globalmente, que atenderá ao chat agentivo no Cursor Tab em todos os projetos.

• Um servidor MCP definido localmente, que será usado apenas no projeto atual.

Para adicionar um novo servidor MCP global ao Cursor, defina sua entrada no arquivo ~/.cursor/mcp.json, que fica no diretório pessoal do usuário (o caractere especial ~ corresponde ao diretório pessoal do usuário, como /home/lirantal ou /Users/lirantal, entre outros, dependendo do sistema operacional e da configuração).

Em outros casos, você pode querer definir um servidor MCP no nível do projeto, para que as ferramentas disponibilizadas por ele fiquem acessíveis especificamente na interface de chat do Cursor Tab daquele projeto.

Nesse caso, o Cursor segue o padrão conhecido de arquivos de configuração iniciados por ponto, lendo vários arquivos de configuração no diretório .cursor/, na raiz do projeto atual. Como seria de esperar, um deles é dedicado às definições de servidores MCP: .cursor/mcp.json.

Por exemplo, para definir um servidor MCP criado em Node.js e executado pelo tipo de transporte STDIO, adicione o seguinte ao arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "node-api-docs": {
      "command": "node",
      "args": ["/Users/lirantal/projects/repos/mcp-server-nodejs-docs/index.js"]
    }
  }
}

Depois de defini-lo, você pode abrir a página MCP Servers na tela de configurações do Cursor e confirmar se o novo servidor MCP está conectado, além de conferir a lista de ferramentas que ele disponibiliza:

Quais servidores MCP adicionar?

Uma observação: talvez você esteja se perguntando quais servidores MCP adicionar e quais benefícios eles oferecem. Aqui vão algumas sugestões para começar:

• Sem querer puxar a sardinha, mas o Snyk MCP Server é indispensável para o desenvolvimento de software. Ele é útil para desenvolver software com segurança, permitindo que a IA agentiva audite dependências e código-fonte para garantir que não contenham vulnerabilidades de segurança.

• Se você trabalha com gestão de produtos, recomendo conferir esta lista selecionada de 7 servidores MCP para gerentes de produto

Servidores MCP disponíveis no Cursor Tab

Você também pode investigar interativamente as ferramentas disponíveis com uma solicitação no chat do Cursor Tab, como “Liste as ferramentas disponíveis”, que deve gerar algo parecido com isto:

Questões de segurança ao adicionar servidores MCP

Quando o assunto é segurança de IA, os servidores MCP trazem seus próprios riscos e preocupações. Veja alguns deles:

1. Servidores MCP maliciosos — Como saber se o servidor MCP que você acabou de instalar e iniciar é legítimo e não contém backdoors, trojans ou outras intenções maliciosas?

2. Servidores MCP vulneráveis — Você auditou cada linha de código e cada dependência de um servidor MCP para garantir que não haja erros de programação que possam levar a vulnerabilidades de segurança exploráveis contra você?

Esses são apenas alguns exemplos. Outros vetores de ataque incluem servidores MCP aparentemente legítimos que usam técnicas sutis de injeção de prompt para direcionar a IA a um contexto específico ou até manipulá-la para acionar chamadas de ferramentas.

Confira a lista de leituras recomendadas a seguir para saber mais sobre segurança de IA:

• ChatGPT e programação segura? Este artigo resume os benefícios e as vulnerabilidades de segurança do código gerado pelo ChatGPT que você deve conhecer.

• Já ouviu falar de RAG? Certo, mas você já pensou em proteger o RAG? Leia este artigo.