Destaque seu MCP
/como-instalar-mcp

Como instalar um servidor MCP: Claude, ChatGPT e Gemini

Instale um servidor MCP passo a passo no Claude, Claude Code, ChatGPT, Gemini CLI, VS Code e Cursor. Remoto ou local, com exemplos para copiar.

11 de nov. de 2026· 6 min de leitura

Instalar um MCP leva de um a cinco minutos. Antes de começar, uma única pergunta define o caminho: o servidor tem um endereço web ou roda no seu computador? Se ainda não está claro o que é MCP, comece por o que é MCP e para que serve.

Antes de começar: remoto ou local

RemotoLocal
O que te passamUm endereço que começa com https://Um comando, como npx -y pacote
Onde rodaNa internetNo seu computador
O que você precisaSó o seu assistenteNode.js (ou Python) instalado
Tempo1 minuto5 minutos
ExemploContext7Playwright

Em cada ficha do Mcpteca você verá isso ao lado do nome: «Remoto» ou «Local». Se for remoto, a ficha traz os passos para cada assistente e o endereço pronto para copiar.

E com o Claude Fable 5.2?

O Claude Fable 5.2 saiu em 9 de novembro de 2026 e o Claude Code já o usa como modelo Fable padrão. Você não precisa fazer nada especial: os servidores MCP são adicionados ao aplicativo (Claude, Claude Code), não ao modelo. Os que você já tinha continuam lá quando muda para o Fable 5.2, e os que adicionar agora vão funcionar com qualquer modelo que escolher.

Instalar um MCP remoto no Claude

Vale para o claude.ai e o app do Claude:

1. Abra Customize → Connectors. 2. Clique em + Add e escolha Add custom connector. 3. Escreva um nome que você reconheça, cole o endereço do servidor e clique em Continue. 4. Se o servidor não pede conta, escolha No sign in, clique em Continue e depois em Add. Se pedir conta, entre quando for solicitado.

Depois, num chat, clique em + no canto inferior esquerdo → Connectors e ative-o. No plano gratuito você pode ter um conector personalizado.

Instalar um MCP remoto no ChatGPT

O ChatGPT agora chama de plugins os servidores MCP próprios, e é preciso uma conta paga:

1. Acesse chatgpt.com/plugins. 2. Clique em + e escolha Add custom MCP server. 3. Escreva um nome e uma descrição e, em Connection, cole o endereço. 4. Se não pede conta, não configure autenticação. Aceite o aviso e clique em Create as a plugin.

Para usá-lo, num chat novo digite @ e escolha o plugin.

Instalar um MCP no Gemini (Gemini CLI)

O app do Gemini ainda não aceita servidores próprios, mas o Gemini CLI sim. É usado no terminal e exige uma licença do Gemini Code Assist: desde junho de 2026 não tem mais plano gratuito.

gemini mcp add --transport http -s user context7 https://mcp.context7.com/mcp

Abra o Gemini CLI e digite /mcp para conferir se aparece. Nas fichas do Mcpteca esse comando já vem pronto com o endereço de cada servidor.

Instalar um MCP no Claude Code

O Claude Code é o assistente de programação da Anthropic no terminal. Um servidor remoto é adicionado com um comando:

claude mcp add --transport http nome https://endereco-do-servidor

E um local, colocando o comando de inicialização depois de --:

claude mcp add nome -- npx -y pacote-do-servidor

Por padrão o servidor fica disponível só na pasta em que você está. Adicione --scope user para tê-lo em todos os seus projetos. Com claude mcp list você vê os que tem.

Instalar um MCP local no Claude Desktop

Para servidores que rodam no seu computador:

1. Instale o Node.js e confira num terminal se node --version responde. 2. No Claude Desktop abra Settings → Developer → Edit Config. Abre-se o arquivo claude_desktop_config.json. 3. Adicione o servidor dentro de mcpServers. Este é o exemplo oficial, que dá acesso a uma pasta:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\seu-usuario\\Documentos"]
    }
  }
}

4. Salve, feche o Claude Desktop por completo e abra de novo.

O que significa cada linha:

  • filesystem é o nome que você verá no Claude; pode usar o que quiser.
  • command é o programa que inicia o servidor (o npx vem com o Node.js).
  • args são as opções: o pacote do servidor e, neste caso, a pasta à qual

você dá acesso. Coloque só a pasta de que precisa.

Instalar um MCP no VS Code

No Visual Studio Code abra a paleta de comandos e escolha MCP: Add Server. Você também pode escrevê-lo à mão em .vscode/mcp.json (só para aquele projeto) ou na sua configuração de usuário (MCP: Open User Configuration). Repare que o VS Code usa a chave servers:

{
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Para um local, use "type": "stdio" com command e args, como no Claude Desktop.

Instalar um MCP no Cursor

O Cursor lê ~/.cursor/mcp.json (para todos os seus projetos) ou .cursor/mcp.json (só para um). Usa a chave mcpServers:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

Resumo por assistente

AssistenteRemotoLocalOnde se adiciona
Claude (web e app)SimNãoCustomize → Connectors
Claude DesktopSimSimConnectors ou claude_desktop_config.json
Claude CodeSimSimclaude mcp add
ChatGPTSim (pago)Nãochatgpt.com/plugins
Gemini CLISimSimgemini mcp add
VS CodeSimSimMCP: Add Server ou mcp.json (servers)
CursorSimSimmcp.json (mcpServers)

Confira se funciona

Faça uma pergunta que só o servidor consiga responder. Com o Context7, por exemplo: «Use o Context7 para consultar a documentação atual desta biblioteca». O assistente deve pedir permissão para usar a ferramenta e responder com a documentação atualizada. Se responder de memória sem pedir permissão, o servidor não está ativo: confira se está ativado no chat.

Se algo der errado

  • Não aparece: feche o aplicativo por completo (também pela bandeja do

sistema) e abra de novo.

  • Erro ao salvar o arquivo: quase sempre falta uma vírgula ou sobra uma

chave. Cole o arquivo num validador de JSON.

  • `npx` não encontrado (`ENOENT`): o Node.js não está instalado ou o

aplicativo não o enxerga. Instale-o e reinicie o computador.

  • Caminhos no Windows: dentro do JSON, escreva as barras duplas

(C:\\Users\\...).

  • Pede para entrar na conta: é normal em servidores de serviços com conta;

siga os passos que o assistente mostrar.

Abaixo você tem servidores para praticar e o Context7 pronto para instalar.

Servidores mencionados neste guia

Experimente

/Como instalar

Você precisa: Qualquer plano do Claude. O plano gratuito permite 1 conector personalizado; no Team ou Enterprise, o dono da organização adiciona primeiro.

No claude.ai ou no app do Claude, abra "Personalizar" → "Conectores".
Aperte "+ Adicionar" e escolha "Adicionar conector personalizado".
Digite um nome que você reconheça, cole a URL abaixo e aperte "Continuar".
Na autenticação, escolha "No sign in", aperte "Continuar" e depois "Adicionar".
https://mcp.context7.com/mcp

Depois: Em um chat, aperte "+" no canto inferior esquerdo → "Conectores" e ative.

Você precisa: Uma conta ChatGPT paga: pode não estar disponível no plano gratuito. O ChatGPT agora chama os conectores de "Plugins".

Acesse chatgpt.com/plugins.
Aperte "+" e escolha "Adicionar servidor MCP personalizado".
Digite um nome e uma descrição, e cole a URL abaixo em "Conexão".
Não configure autenticação. Aceite "I understand and want to continue" e aperte "Criar como plugin".
https://mcp.context7.com/mcp

Depois: Em um novo chat, digite @ e escolha o plugin.

Você precisa: O app Gemini ainda não suporta conectores personalizados. É feito com o Gemini CLI pelo terminal, que exige uma licença do Gemini Code Assist (não tem mais plano gratuito).

Instale o Gemini CLI se ainda não tiver.
No terminal, execute o comando abaixo.
Abra o Gemini CLI e digite /mcp para conferir se aparece.
gemini mcp add --transport http -s user context7 'https://mcp.context7.com/mcp'

Depois: Peça como sempre: o Gemini usará o conector quando precisar.

Você precisa: Uma conta do Grok. No Grok Business ou Enterprise, um administrador ativa primeiro.

Acesse grok.com/connectors.
Aperte "New Connector" e escolha "Custom".
Cole a URL abaixo e salve.
https://mcp.context7.com/mcp

Depois: O Grok usará o conector sempre que sua pergunta precisar.

O Mcpteca não revisa o código deste servidor. Um projeto pode mudar de dono ou de conteúdo: antes de instalá-lo ou conectá-lo, revise o código ou passe-o por um revisor de segurança.

Perguntas frequentes

Como sei se um servidor MCP é remoto ou local?

Se te passam um endereço que começa com https://, é remoto. Se te passam um comando como npx ou uvx, é local. Em cada ficha do Mcpteca isso aparece no topo, ao lado do nome.

Preciso instalar algo para usar um MCP remoto?

Não. No Claude, no ChatGPT e no Grok basta colar o endereço. No Gemini é feito com o Gemini CLI, que precisa ser instalado.

Posso usar MCP no plano gratuito do Claude?

Sim. No plano gratuito você pode ter um conector personalizado. Nos planos Team e Enterprise, o proprietário da organização o adiciona primeiro.

E no ChatGPT?

O ChatGPT agora chama de «plugins» os servidores MCP próprios. É preciso uma conta paga: no plano gratuito pode não estar disponível.

O servidor não aparece depois de adicioná-lo, o que faço?

Em apps de desktop, feche o aplicativo por completo e abra de novo. Num arquivo de configuração, confira se não falta nenhuma vírgula ou chave. Se for local, verifique num terminal se node --version responde.

Onde fica o arquivo de configuração do Claude Desktop?

No Windows, em %APPDATA%\Claude\claude_desktop_config.json. No macOS, em ~/Library/Application Support/Claude/claude_desktop_config.json. Pelo app ele abre em Settings > Developer > Edit Config.

É seguro instalar um servidor local?

Um servidor local roda no seu computador com as suas permissões. Instale só os de autores de confiança e revise o repositório antes.

Explore o diretório gratuito de servidores MCP ou conte-nos sobre o seu.

Explorar o diretórioEnvie-nos o seu MCP