Model Context Protocol (MCP)

Conecta ferramentas externas e fontes de dados ao Cursor via MCP

O que é MCP?

O Model Context Protocol (MCP) permite que o Cursor se conecte a ferramentas externas e a fontes de dados.

Por que usar MCP?

O MCP conecta o Cursor a sistemas e dados externos. Em vez de explicar a estrutura do teu projeto repetidamente, integra direto com as tuas ferramentas.

Escreve servidores MCP em qualquer linguagem que consiga imprimir em stdout ou expor um endpoint HTTP — Python, JavaScript, Go, etc.

Como funciona

Servidores MCP expõem recursos por meio do protocolo, conectando o Cursor a ferramentas externas ou fontes de dados.

O Cursor oferece suporte a três métodos de transporte:

Transporte	Ambiente de execução	Implantação	Usuários	Entrada	Autenticação
stdio	Local	Gerenciado pelo Cursor	Usuário único	Comando de shell	Manual
SSE	Local/Remoto	Implantar como servidor	Vários usuários	URL para um endpoint SSE	OAuth
Streamable HTTP	Local/Remoto	Implantar como servidor	Vários usuários	URL para um endpoint HTTP	OAuth

Suporte ao protocolo

Cursor oferece suporte a estes recursos do protocolo MCP:

Feature	Support	Description
Tools	Supported	Funções que o modelo de IA pode executar
Prompts	Supported	Mensagens e fluxos de trabalho baseados em modelos (templates) para usuários
Resources	Supported	Fontes de dados estruturadas que podem ser lidas e referenciadas
Roots	Supported	Consultas iniciadas pelo servidor sobre limites de URI ou do sistema de arquivos nos quais operar
Elicitation	Supported	Solicitações iniciadas pelo servidor para obter informações adicionais dos usuários

Instalando servidores MCP

Instalação com um clique

Instala servidores MCP da nossa coleção e autentica com OAuth.

Browse MCP Tools

Navega pelos servidores MCP disponíveis

Add to Cursor Button

Cria um botão “Add to Cursor”

Usando mcp.json

Configura servidores MCP personalizados com um arquivo JSON:

CLI Server - Node.js

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Configuração do servidor STDIO

Para servidores STDIO (servidores locais de linha de comando), configura estes campos no teu mcp.json:

Campo	Obrigatório	Descrição	Exemplos
type	Sim	Tipo de conexão do servidor	"stdio"
command	Sim	Comando para iniciar o executável do servidor. Deve estar disponível no PATH do teu sistema ou conter o caminho completo.	"npx", "node", "python", "docker"
args	Não	Array de argumentos passados para o comando	["server.py", "--port", "3000"]
env	Não	Variáveis de ambiente do servidor	{"API_KEY": "${input:api-key}"}
envFile	Não	Caminho para um arquivo de ambiente para carregar mais variáveis	".env", "${workspaceFolder}/.env"

Usando a Extension API

Para o registro programático de servidores MCP, o Cursor oferece uma Extension API que permite configuração dinâmica sem modificar arquivos mcp.json. Isso é especialmente útil para ambientes corporativos e fluxos de trabalho de configuração automatizada.

Referência da MCP Extension API

Aprende como registrar servidores MCP programaticamente usando vscode.cursor.mcp.registerServer()

Locais de configuração

Configuração do projeto

Cria .cursor/mcp.json no seu projeto para ferramentas específicas do projeto.

Configuração global

Cria ~/.cursor/mcp.json no seu diretório home para ferramentas disponíveis em qualquer lugar.

Interpolação de configuração

Usa variáveis nos valores de mcp.json. O Cursor resolve variáveis nestes campos: command, args, env, url e headers.

Sintaxe compatível:

• ${env:NAME} variáveis de ambiente
• ${userHome} caminho para tua pasta pessoal
• ${workspaceFolder} raiz do projeto (a pasta que contém .cursor/mcp.json)
• ${workspaceFolderBasename} nome da raiz do projeto
• ${pathSeparator} e ${/} separador de caminho do SO

Exemplos

{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

Autenticação

Servidores MCP usam variáveis de ambiente para autenticação. Passa chaves de API e tokens pela config.

Cursor oferece suporte a OAuth para servidores que exigem isso.

Usando MCP no chat

O Composer Agent usa automaticamente as ferramentas MCP listadas em Available Tools quando for relevante. Pede uma ferramenta específica pelo nome ou descreve o que você precisa. Ativa ou desativa ferramentas nas configurações.

Alternando ferramentas

Ativa ou desativa ferramentas MCP direto pela interface do chat. Clica no nome de uma ferramenta na lista para alternar. Ferramentas desativadas não vão ser carregadas no contexto nem ficar disponíveis para o Agent.

Aprovação de ferramenta

Por padrão, o Agent pede aprovação antes de usar ferramentas MCP. Clica na seta ao lado do nome da ferramenta para ver os argumentos.

Execução automática

Ativa a execução automática para o Agent usar ferramentas MCP sem pedir confirmação. Funciona como comandos de terminal. Saiba mais sobre o modo Yolo aqui.

Resposta da ferramenta

O Cursor exibe a resposta no chat com visualizações expansíveis dos argumentos e das respostas:

Imagens como contexto

Servidores MCP podem retornar imagens — capturas de tela, diagramas, etc. Retorna elas como strings codificadas em base64:

const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ base64 completo truncado para facilitar a leitura

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});

Confere este servidor de exemplo para detalhes de implementação. O Cursor anexa as imagens retornadas ao chat. Se o modelo suportar imagens, ele as analisa.

Considerações de segurança

Ao instalar servidores MCP, considera estas práticas de segurança:

• Verifica a origem: Instala servidores MCP apenas de desenvolvedores e repositórios confiáveis
• Revisa as permissões: Confere quais dados e APIs o servidor vai acessar
• Limita chaves de API: Usa chaves de API restritas com o mínimo de permissões necessárias
• Audita o código: Para integrações críticas, revisa o código-fonte do servidor

Lembra que servidores MCP podem acessar serviços externos e executar código em teu nome. Sempre entende o que um servidor faz antes da instalação.

Exemplos do mundo real

Para ver exemplos práticos do MCP em ação, dá uma olhada no nosso guia de desenvolvimento web, que mostra como integrar Linear, Figma e ferramentas de navegador ao teu fluxo de desenvolvimento.

FAQ

Qual é a finalidade dos servidores MCP?

Servidores MCP conectam o Cursor a ferramentas externas como Google Drive, Notion e outros serviços para trazer documentos e requisitos pro teu fluxo de trabalho de código.

Como eu depuro problemas de servidor MCP?

Vê os logs do MCP assim: 1. Abre o painel Output no Cursor (Ctrl+Shift+U) 2. Seleciona “MCP Logs” no menu suspenso 3. Confere erros de conexão, problemas de autenticação ou panes do servidor Os logs mostram a inicialização do servidor, chamadas de ferramentas e mensagens de erro.

Posso desativar temporariamente um servidor MCP?

Sim! Ativa/desativa servidores sem remover: 1. Abre Settings ( Ctrl+Shift+J) 2. Vai em Features → Model Context Protocol 3. Clica no toggle ao lado de qualquer servidor pra habilitar/desabilitar Servidores desabilitados não carregam nem aparecem no chat. Isso é útil pra depurar ou reduzir a poluição de ferramentas.

O que acontece se um servidor MCP travar ou exceder o tempo?

Se um servidor MCP falhar: - O Cursor mostra uma mensagem de erro no chat - A chamada da ferramenta é marcada como falha - Tu pode tentar a operação de novo ou verificar os logs em busca de detalhes - Outros servidores MCP continuam funcionando normalmente O Cursor isola falhas de servidor pra evitar que um afete os outros.

Como eu atualizo um servidor MCP?

Pra servidores baseados em npm: 1. Remove o servidor nas configurações 2. Limpa o cache do npm: npm cache clean --force 3. Adiciona o servidor de novo pra obter a versão mais recente Pra servidores personalizados, atualiza teus arquivos locais e reinicia o Cursor.

Posso usar servidores MCP com dados sensíveis?

Sim, mas segue as melhores práticas de segurança: - Usa variáveis de ambiente pra segredos, nunca faz hardcode - Executa servidores sensíveis localmente com transporte stdio - Limita as permissões das chaves de API ao mínimo necessário - Revisa o código do servidor antes de conectar a sistemas sensíveis - Considera rodar servidores em ambientes isolados