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
| Remoto | Local | |
|---|---|---|
| O que te passam | Um endereço que começa com https:// | Um comando, como npx -y pacote |
| Onde roda | Na internet | No seu computador |
| O que você precisa | Só o seu assistente | Node.js (ou Python) instalado |
| Tempo | 1 minuto | 5 minutos |
| Exemplo | Context7 | Playwright |
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 (onpxvem com o Node.js).argssã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
| Assistente | Remoto | Local | Onde se adiciona |
|---|---|---|---|
| Claude (web e app) | Sim | Não | Customize → Connectors |
| Claude Desktop | Sim | Sim | Connectors ou claude_desktop_config.json |
| Claude Code | Sim | Sim | claude mcp add |
| ChatGPT | Sim (pago) | Não | chatgpt.com/plugins |
| Gemini CLI | Sim | Sim | gemini mcp add |
| VS Code | Sim | Sim | MCP: Add Server ou mcp.json (servers) |
| Cursor | Sim | Sim | mcp.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
Context7
ComunidadeO Context7 traz documentação de bibliotecas atualizada e específica por versão, além de exemplos de código, para agentes de programação com IA via MCP.
GitHub
ComunidadeServidor MCP oficial do GitHub que conecta assistentes de IA a repositórios, issues, pull requests, Actions, alertas de segurança e mais via linguagem natural.
Playwright
ComunidadeServidor MCP oficial do Playwright para automação de navegador via snapshots de acessibilidade, permitindo que LLMs testem e extraiam dados de páginas web.
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.
https://mcp.context7.com/mcpDepois: 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".
https://mcp.context7.com/mcpDepois: 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).
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.
https://mcp.context7.com/mcpDepois: 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.