O que é o MCP?
Por que usar MCP?
stdout
ou expor um endpoint HTTP — Python, JavaScript, Go, etc.
Como funciona
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 | Múltiplos usuários | URL para um endpoint SSE | OAuth |
Streamable HTTP | Local/Remoto | Implantar como servidor | Múltiplos usuários | URL para um endpoint HTTP | OAuth |
Suporte ao protocolo
Recurso | Suporte | Descrição |
---|---|---|
Tools | Suportado | Funções que o modelo de IA pode executar |
Prompts | Suportado | Mensagens e fluxos de trabalho baseados em templates para usuários |
Resources | Suportado | Fontes de dados estruturadas que podem ser lidas e referenciadas |
Roots | Suportado | Consultas iniciadas pelo servidor sobre limites de URI ou do sistema de arquivos nos quais operar |
Elicitation | Suportado | Solicitações iniciadas pelo servidor para obter informações adicionais dos usuários |
Instalação de servidores MCP
Instalação com um clique
Navegar por Ferramentas MCP
Navega pelos servidores MCP disponíveis
Botão Adicionar ao Cursor
Cria um botão “Adicionar ao Cursor”
Usando mcp.json
Configuração do servidor STDIO
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. Precisa estar disponível no teu PATH do 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 para o 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 API de Extensão
mcp.json
. Isso é especialmente útil para ambientes corporativos e fluxos de configuração automatizada.
Referência da API de Extensão MCP
Aprende como registrar servidores MCP programaticamente usando
vscode.cursor.mcp.registerServer()
Locais de configuração
Configuração do projeto
Cria
.cursor/mcp.json
no teu projeto para ferramentas específicas do projeto.Configuração global
Cria
~/.cursor/mcp.json
no teu diretório pessoal para ferramentas disponíveis em qualquer lugar.Interpolação de configuração
mcp.json
. O Cursor resolve variáveis nesses campos: command
, args
, env
, url
e headers
.
Sintaxe compatível:
${env:NAME}
variáveis de ambiente${userHome}
caminho pra tua pasta inicial${workspaceFolder}
raiz do projeto (a pasta que contém.cursor/mcp.json
)${workspaceFolderBasename}
nome da raiz do projeto${pathSeparator}
e${/}
separador de caminho do sistema operacional
Autenticação
Usando MCP no chat
Available Tools
quando relevante. Pede uma ferramenta específica pelo nome ou descreve o que tu precisa. Ativa ou desativa ferramentas nas configurações.
Alternar ferramentas
Aprovação de ferramenta

Execução automática
Resposta da ferramenta

Imagens como contexto
Considerações de segurança
- Confere a origem: Só instala servidores MCP de desenvolvedores e repositórios confiáveis
- Revisa as permissões: Verifica 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
Exemplos do mundo real
FAQ
Qual é a função dos servidores MCP?
Qual é a função 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 seu fluxo
de trabalho de código.
Como eu depuro problemas de servidor MCP?
Como eu depuro problemas de servidor MCP?
Veja os logs do MCP assim: 1. Abre o painel Output no Cursor (Ctrl+Shift+U)
2. Seleciona “MCP Logs” no menu dropdown 3. Procura por erros de conexão,
problemas de autenticação ou travamentos do servidor. Os logs mostram a
inicialização do servidor, chamadas de ferramentas e mensagens de erro.
Posso desativar temporariamente um servidor MCP?
Posso desativar temporariamente um servidor MCP?
Sim! Alterna servidores on/off 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 ativar/desativar. Servidores
desativados não carregam nem aparecem no chat. Isso é útil pra solucionar
problemas ou reduzir a bagunça de ferramentas.
O que acontece se um servidor MCP travar ou expirar?
O que acontece se um servidor MCP travar ou expirar?
Se um servidor MCP falhar: - O Cursor mostra uma mensagem de erro no chat - A
chamada de ferramenta é marcada como falha - Você pode tentar a operação de
novo ou checar os logs pra detalhes - Outros servidores MCP continuam
funcionando normalmente. O Cursor isola falhas de servidor pra evitar que um
servidor afete os outros.
Como eu atualizo um servidor MCP?
Como eu atualizo um servidor MCP?
Para 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. Para servidores customizados, atualiza
seus arquivos locais e reinicia o Cursor.Posso usar servidores MCP com dados sensíveis?
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 executar servidores em ambientes isolados