O que é MCP?

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

Por que usar MCP?

O MCP conecta o Cursor a sistemas e dados externos. Em vez de explicar a estrutura do teu projeto toda hora, integra direto com 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 capacidades via protocolo, conectando o Cursor a ferramentas externas ou fontes de dados. O Cursor oferece suporte a três métodos de transporte:
TransporteAmbiente de execuçãoImplantaçãoUsuáriosEntradaAutenticação
stdioLocalCursor gerenciaUsuário únicoComando de shellManual
SSELocal/RemotoImplantar como servidorMúltiplos usuáriosURL de um endpoint SSEOAuth
Streamable HTTPLocal/RemotoImplantar como servidorMúltiplos usuáriosURL de um endpoint HTTPOAuth

Suporte ao protocolo

O Cursor oferece suporte a estas capacidades do protocolo MCP:
RecursoSuporteDescrição
ToolsSuportadoFunções para o modelo de IA executar
PromptsSuportadoMensagens e fluxos de trabalho com templates para usuários
RootsSuportadoConsultas iniciadas pelo servidor sobre limites de URI ou de sistema de arquivos nos quais operar
ElicitationSuportadoSolicitações iniciadas pelo servidor por informações adicionais dos usuários

Instalando servidores MCP

Instalação com um clique

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

Usando mcp.json

Configura servidores MCP personalizados com um arquivo JSON:
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Usando a Extension API

Para registrar servidores MCP por código, o Cursor oferece uma Extension API que permite configuração dinâmica sem modificar arquivos mcp.json. Isso é especialmente útil em ambientes corporativos e fluxos de setup automatizados.

MCP Extension API Reference

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

Locais de configuração

Project Configuration

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

Global Configuration

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

Autenticação

Servidores MCP usam variáveis de ambiente para autenticação. Passa chaves de API e tokens pela config. O Cursor tem 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 fizer sentido. Pede uma ferramenta específica pelo nome ou descreve o que tu precisa. Ativa ou desativa ferramentas nas configurações.

Alternando ferramentas

Ativa ou desativa ferramentas MCP direto pela interface do chat. Clica no nome da ferramenta na lista para alternar. Ferramentas desativadas não serão carregadas no contexto nem estarão disponíveis pro 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 pro Agent usar ferramentas MCP sem pedir. Funciona como comandos de terminal. Lê mais sobre o modo Yolo aqui.

Resposta da ferramenta

O Cursor mostra a resposta no chat com visualizações expansíveis de argumentos e 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 legibilidade

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
Vê este servidor de exemplo pra detalhes de implementação. O Cursor anexa as imagens retornadas ao chat. Se o modelo suportar imagens, ele analisa elas.

Considerações de segurança

Ao instalar servidores MCP, considera estas práticas de segurança:
  • Confere a origem: Só instala servidores MCP de desenvolvedores e repositórios confiáveis
  • Revisa as permissões: Vê quais dados e APIs o servidor vai acessar
  • Limita as chaves de API: Usa chaves de API restritas com as permissões mínimas 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. Entende sempre o que um servidor faz antes de instalar.

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 do navegador ao teu fluxo de desenvolvimento.

FAQ