​
O que é MCP?

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

​
Por que usar MCP?

MCP conecta o Cursor a sistemas externos e dados. Em vez de explicar a estrutura do seu projeto repetidamente, integre diretamente com suas ferramentas. Escreva servidores MCP em qualquer linguagem que possa imprimir para stdout ou servir um endpoint HTTP - Python, JavaScript, Go, etc.

​
Como funciona

Servidores MCP expõem capacidades através do protocolo, conectando o Cursor a ferramentas externas ou fontes de dados. O Cursor suporta três métodos de transporte:
TransporteAmbiente de execuçãoImplantaçãoUsuáriosEntradaAutenticação
stdioLocalCursor gerenciaUsuário únicoComando shellManual
SSELocal/RemotoImplantar como servidorMúltiplos usuáriosURL para um endpoint SSEOAuth
Streamable HTTPLocal/RemotoImplantar como servidorMúltiplos usuáriosURL para um endpoint HTTPOAuth

​
Instalando servidores MCP

​
Instalação com um clique

Instale servidores MCP da nossa coleção e autentique com OAuth.

Navegar Ferramentas MCP

Navegue pelos servidores MCP disponíveis

Botão Adicionar ao Cursor

Crie um botão “Adicionar ao Cursor”

​
Usando mcp.json

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

​
Localizações de configuração

Configuração do Projeto

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

Configuração Global

Crie ~/.cursor/mcp.json no seu diretório home para ferramentas disponíveis em todos os lugares.

​
Autenticação

Servidores MCP usam variáveis de ambiente para autenticação. Passe chaves de API e tokens através da configuração. Cursor suporta OAuth para servidores que o exigem.

​
Usando MCP no chat

O Composer Agent usa automaticamente as ferramentas MCP listadas em Available Tools quando relevante. Peça por uma ferramenta específica pelo nome ou descreva o que você precisa. Habilite ou desabilite ferramentas nas configurações.

​
Alternando ferramentas

Habilite ou desabilite ferramentas MCP diretamente da interface do chat. Clique no nome de uma ferramenta na lista de ferramentas para alterná-la. Ferramentas desabilitadas não serão carregadas no contexto ou disponíveis para o Agent.

​
Aprovação de ferramenta

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

​
Execução automática

Habilite a execução automática para que o Agent use ferramentas MCP sem perguntar. Funciona como comandos de terminal. Leia 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. Retorne-as como strings codificadas em base64: 
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ base64 completo cortado para legibilidade

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

​
Considerações de segurança

Ao instalar servidores MCP, considere estas práticas de segurança:
  • Verifique a origem: Instale apenas servidores MCP de desenvolvedores e repositórios confiáveis
  • Revise as permissões: Verifique quais dados e APIs o servidor irá acessar
  • Limite as chaves de API: Use chaves de API restritas com as permissões mínimas necessárias
  • Audite o código: Para integrações críticas, revise o código-fonte do servidor
Lembre-se de que os servidores MCP podem acessar serviços externos e executar código em seu nome. Sempre entenda o que um servidor faz antes da instalação.

​
Exemplos do mundo real

Para exemplos práticos do MCP em ação, consulte nosso guia de Desenvolvimento Web que demonstra a integração de ferramentas Linear, Figma e navegador em seu fluxo de trabalho de desenvolvimento.

​
FAQ