Guias práticos

Como configurar um servidor MCP no Claude Code, no Cursor e no VS Code

O que é o Model Context Protocol, como adicionar um servidor ao Claude Code, Cursor e VS Code, servidores de referência e regras de segurança.

Por Audryk · 20 de outubro de 2026

• Guias práticos
• Agentes de programação
• Novas tecnologias de IA
• #guias
• #MCP
• #Claude Code

Um servidor MCP dá a um agente de programação acesso a uma ferramenta externa: um repositório do GitHub, um banco de dados, um navegador, a documentação de uma biblioteca. Este guia explica o protocolo e depois a configuração em três clientes comuns. Os comandos e arquivos vêm da documentação oficial, verificada em 20 de outubro de 2026.

O que é o MCP?

O Model Context Protocol (MCP) é um padrão de código aberto para conectar aplicativos de IA a sistemas externos: arquivos locais, bancos de dados, ferramentas como um mecanismo de busca, ou fluxos de trabalho. Seus autores o comparam a uma porta USB-C para aplicativos de IA (modelcontextprotocol.io). Veja também o verbete MCP do glossário.

• O que um servidor expõe: tools (ações que o modelo pode executar), resources (dados de contexto) e prompts (modelos de instruções) (arquitetura do MCP).
• Dois transportes: stdio, quando o cliente inicia o servidor como um processo local na mesma máquina; Streamable HTTP, para um servidor remoto, que aceita bearer tokens, chaves de API e cabeçalhos personalizados.

Adicionar um servidor ao Claude Code

O Claude Code é configurado pela linha de comando (Anthropic). Se o agente ainda não estiver instalado, veja nosso guia Como instalar o Claude Code e dar os primeiros passos.

Servidor remoto (HTTP), a opção recomendada para serviços online:

# Basic syntax
claude mcp add --transport http <name> <url>

# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

Servidor local (stdio): tudo o que vem depois de -- é o comando que inicia o servidor.

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

O transporte SSE está obsoleto: a Anthropic recomenda HTTP quando o servidor o aceita. Para gerenciar os servidores:

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get notion

# Remove a server
claude mcp remove notion

# (within Claude Code) Check server status
/mcp

Três escopos (opção --scope):

• local (padrão): o projeto atual, só para você, armazenado em ~/.claude.json;
• project: compartilhado com sua equipe por um arquivo .mcp.json na raiz do repositório, para ser versionado;
• user: todos os seus projetos, armazenado em ~/.claude.json.

Um repositório clonado não pode aprovar sozinho os servidores do seu .mcp.json: eles ficam pendentes até você aceitar a caixa de diálogo de confiança do workspace. Exemplo oficial com o servidor remoto do GitHub, autenticado com um token de acesso pessoal de escopo restrito:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

O claude mcp add salva a configuração sem validar o token: confira a conexão com /mcp.

Adicionar um servidor ao Cursor

O Cursor oferece instalação com um clique pelo seu Marketplace (página Customize, botão "Add to Cursor", login via OAuth), ou configuração manual em um arquivo mcp.json (Cursor):

• .cursor/mcp.json no projeto, para ferramentas específicas do projeto;
• ~/.cursor/mcp.json no seu diretório pessoal, para ferramentas disponíveis em qualquer lugar.

Um servidor local iniciado com Node.js, como mostra a documentação do Cursor:

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

Para um servidor remoto, a entrada usa uma chave url (e, opcionalmente, headers) no lugar de command. O Cursor aceita stdio, SSE e Streamable HTTP, e resolve a sintaxe ${env:NAME} para que você leia um segredo de uma variável de ambiente em vez de escrevê-lo em texto simples.

Adicionar um servidor ao VS Code

No VS Code, abra a Paleta de Comandos (⇧⌘P no Mac, Ctrl+Shift+P no Windows e no Linux) e execute MCP: Add Server (Microsoft). Escolha HTTP se o publicador do servidor fornecer uma URL, Command (stdio) se fornecer um comando. O exemplo da documentação, o servidor Playwright, exige Node.js 18 ou mais recente:

node --version
npx --version

Escolha Command (stdio) e digite:

npx -y @playwright/mcp@latest

Dê um ID ao servidor (por exemplo, playwright) e escolha onde armazená-lo:

• Global > Copilot Global: ~/.copilot/mcp-config.json, para todos os seus workspaces;
• **.mcp.json na raiz do workspace**: para compartilhar com sua equipe (configuração experimental chat.mcp.workspaceRootConfig.enabled);
• **.vscode/mcp.json ou o mcp.json do perfil de usuário**: ainda disponíveis, mas marcados como obsoletos no fluxo guiado.

Atenção ao formato: os arquivos portáveis usam a chave mcpServers, o formato do VS Code usa servers. A galeria de servidores (prévia) abre quando você digita @mcp na visualização de extensões. A Microsoft também recomenda verificar se uma ferramenta do servidor foi realmente chamada na sua sessão: uma configuração adicionada não prova que o agente a usa.

Servidores de referência

O projeto MCP mantém servidores de referência para experimentar o protocolo: Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking e Time (exemplos oficiais). Os servidores em TypeScript rodam com npx, os em Python com uvx:

npx -y @modelcontextprotocol/server-memory

uvx mcp-server-git

Os servidores mantidos por empresas para suas próprias plataformas estão listados no repositório modelcontextprotocol/servers.

Segurança: regras a seguir

Um servidor MCP local não é um plugin em sandbox: é um processo comum que herda suas variáveis de ambiente, pode ler tudo o que sua conta pode ler (chaves SSH, credenciais de nuvem, diretório pessoal) e pode abrir conexões de rede (modelcontextprotocol.io). As recomendações oficiais:

• Faça um inventário: remova os servidores que não usa mais e saiba de onde vem cada um dos que restarem;
• Prefira a versão remota quando um servidor não precisa de nada da sua máquina;
• Verifique o publicador e fixe a versão em vez de usar latest, com o hábito de atualizar de forma deliberada. O exemplo do Playwright no VS Code usa @latest: adapte-o à sua própria política;
• Isole os servidores de terceiros (contêiner, sandbox ou máquina virtual);
• Limite o acesso: credenciais por servidor, acesso ao sistema de arquivos restrito a um diretório específico, somente leitura sempre que possível, saída de rede limitada;
• Leia as descrições das ferramentas: o modelo as lê como instruções, o que abre a porta para a injeção de prompt.

A Anthropic também pede que você verifique se confia em cada servidor antes de conectá-lo, sobretudo os que buscam conteúdo externo (Anthropic). O Cursor recomenda chaves de API com permissões mínimas e, para integrações críticas, a revisão do código-fonte (Cursor).

Para ir além

• As páginas das ferramentas mostram quais delas aceitam MCP: Claude Code, Cursor, GitHub Copilot, Cline.
• Compare editores: Cursor, Devin Desktop ou Copilot.
• Os riscos do código gerado: o que os estudos dizem sobre segurança.

Fontes

• Model Context Protocol: What is MCP?, verificado em 20 de outubro de 2026
• Model Context Protocol: Architecture overview, verificado em 20 de outubro de 2026
• Model Context Protocol: Example Servers, verificado em 20 de outubro de 2026
• Model Context Protocol: Local Server Security, verificado em 20 de outubro de 2026
• Claude Code Docs: Connect Claude Code to tools via MCP, verificado em 20 de outubro de 2026
• Cursor Docs: Model Context Protocol, verificado em 20 de outubro de 2026
• VS Code Docs: Add MCP servers in VS Code, verificado em 20 de outubro de 2026

Conclusão: adicionar um servidor MCP leva um comando ou algumas linhas de JSON, mas um servidor local roda com as suas permissões: instale apenas servidores de publicadores identificados, com versões fixadas e acesso limitado.

Encontrou um erro neste artigo? Avise-nos · Nossa política de correções