Como conectar servidores MCP ao Claude, ao ChatGPT e ao Cursor
Pela equipe editorial do Kitbay ·
Para conectar um servidor MCP, você informa ao seu cliente de IA um comando que inicia o servidor no seu computador (um servidor local) ou a URL de um servidor hospedado na internet (um servidor remoto). Cada cliente guarda essa informação em um lugar diferente: um comando no terminal no Claude Code e no Codex, um arquivo JSON no Claude Desktop, no Cursor e no VS Code, e uma tela de configurações no ChatGPT.
Este guia mostra onde cada cliente guarda essa configuração. Para entender o básico, veja o que é um servidor MCP.
Local ou remoto: decida primeiro
| Servidor local | Servidor remoto | |
|---|---|---|
| Onde roda | No seu computador, iniciado pelo cliente | Na infraestrutura do provedor |
| Transporte | stdio (entrada e saída padrão) | Streamable HTTP |
| O que você informa | Um comando, os argumentos dele e as variáveis de ambiente necessárias | Uma URL, geralmente seguida de um login |
| Acesso | Seus arquivos e programas, com as permissões da sua conta de usuário | O que a conta com que você faz login permitir |
A documentação do MCP observa que um servidor stdio local costuma atender um cliente, enquanto um servidor remoto normalmente atende muitos. O README do projeto diz em qual dessas formas o servidor é distribuído. O gerador de configuração do Kitbay monta o trecho para vários clientes a partir de um único conjunto de dados.
Claude Code
O Claude Code adiciona servidores pelo terminal.
# remote server
claude mcp add --transport http notion https://mcp.notion.com/mcp
# local server; everything after -- is the server's own command
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server
Cada servidor tem um escopo:
- local (padrão): só para você, só neste projeto; fica salvo em
~/.claude.json. - project: compartilhado pelo arquivo
.mcp.jsonna raiz do projeto, que você inclui no commit. O Claude Code pede aprovação antes de usar servidores desse arquivo. - user: só para você, em todos os projetos; fica salvo em
~/.claude.json.
Use --scope project ou --scope user para mudar o escopo. Dentro de uma sessão, /mcp mostra o status e inicia o login via OAuth nos servidores remotos que exigem isso. claude mcp list e claude mcp remove <name> gerenciam a lista.
Claude Desktop
O Claude Desktop configura servidores locais e remotos em lugares diferentes.
Servidores locais ficam no claude_desktop_config.json. Para abri-lo, vá em Settings, depois na aba Developer e clique em Edit Config:
| Sistema | Caminho |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
}
}
}
Depois de salvar, feche o app por completo e abra de novo. Use caminhos absolutos. Se um servidor não aparecer, confira os logs: mcp.log e mcp-server-NAME.log ficam em ~/Library/Logs/Claude no macOS e na pasta logs ao lado do arquivo de configuração no Windows e no Linux.
Servidores remotos são adicionados como conectores personalizados: vá em Settings, depois em Connectors e em Add custom connector, cole a URL e conclua o login. Na mesma tela você pode ativar ou desativar cada ferramenta.
ChatGPT
O ChatGPT só se conecta a servidores que ele consegue acessar pela rede. A documentação da OpenAI descreve este fluxo no ChatGPT web:
- Abra a página Plugins, clique no botão + e escolha Add custom MCP server.
- Informe um nome e a URL do servidor, ou escolha um túnel para um servidor privado.
- Escolha a autenticação: OAuth, nenhuma ou OAuth com alternativa sem login.
- Leia o aviso de risco, crie o plugin e depois instale.
- Em um chat, mencione o servidor com
@para usá-lo.
Os transportes suportados são SSE e HTTP com streaming. Por padrão, o ChatGPT pede confirmação para ações de escrita e trata toda ferramenta como ação de escrita, a não ser que o servidor a marque como somente leitura. As permissões do workspace se aplicam, e a disponibilidade pode depender do seu plano; confira nas configurações da sua conta, porque não conseguimos confirmar a lista atual de planos nas páginas da OpenAI.
Cursor
O Cursor lê dois arquivos JSON:
.cursor/mcp.jsondentro de um projeto, só para esse projeto;~/.cursor/mcp.jsonna sua pasta pessoal, para todos os projetos.
{
"mcpServers": {
"local-example": { "command": "npx", "args": ["-y", "some-mcp-server"], "env": { "API_KEY": "${env:API_KEY}" } },
"remote-example": { "url": "https://example.com/mcp" }
}
}
O Cursor suporta stdio, SSE e Streamable HTTP, além de OAuth para servidores remotos. Por padrão, ele pede permissão antes de executar uma ferramenta MCP, e você pode expandir o pedido para ver os argumentos.
VS Code
No VS Code, execute MCP: Add Server na Command Palette, escolha HTTP ou um comando stdio e defina onde salvar. A chave principal muda de um arquivo para outro:
| Arquivo | Chave principal |
|---|---|
.vscode/mcp.json (workspace) ou o mcp.json do perfil |
servers |
.mcp.json na raiz do workspace |
mcpServers |
~/.copilot/mcp-config.json (usuário) |
mcpServers |
A referência do VS Code diz que os arquivos servers, gerenciados pelo editor, atendem a um harness mais antigo, e indica os arquivos mcpServers para novas configurações do Copilot. Use o recurso inputs (nos arquivos servers) para pedir segredos na hora, em vez de gravá-los em arquivos compartilhados. No macOS e no Linux, servidores stdio podem rodar em sandbox com "sandboxEnabled": true.
Codex
O Codex guarda os servidores em ~/.codex/config.toml ou em .codex/config.toml dentro de um projeto confiável.
codex mcp add context7 -- npx -y @upstash/context7-mcp
[mcp_servers.example]
url = "https://example.com/mcp"
codex mcp login <name> inicia o OAuth, e /mcp na interface do terminal lista os servidores ativos. O app do ChatGPT para desktop, o Codex CLI e a extensão para IDE compartilham essa configuração.
Outros clientes
O Gemini CLI usa um bloco mcpServers em ~/.gemini/settings.json ou .gemini/settings.json, além do comando gemini mcp add. A opção trust: true dele pula todas as confirmações, então reserve-a para servidores que você controla. O Windsurf, o Cline e o Zed têm configurações próprias; veja as páginas desses clientes.
Uma observação sobre segurança
Um servidor local roda com as permissões da sua conta de usuário e pode fazer com seus arquivos tudo o que você pode. Um servidor remoto age com as permissões da conta com que você faz login. Instale apenas servidores cujo código-fonte você revisou, guarde as chaves em variáveis de ambiente em vez de arquivos compartilhados e leia antes as nossas perguntas sobre segurança no MCP.
Encontre servidores por cliente
Cada listagem de servidor MCP no Kitbay informa quais clientes a documentação do próprio servidor cobre. Para criar o seu, veja como criar um servidor MCP.
Perguntas
- Como adiciono um servidor MCP ao Claude Desktop?
- Para um servidor local, vá em Settings, depois em Developer e em Edit Config, adicione o servidor em mcpServers no claude_desktop_config.json e reinicie o app. Para um servidor remoto, vá em Settings, depois em Connectors, e adicione um conector personalizado com a URL do servidor.
- O ChatGPT consegue usar servidores MCP locais?
- A documentação da OpenAI descreve como adicionar um servidor por URL ou por um Secure MCP Tunnel, então um servidor que roda só no seu computador precisa de um túnel ou de um endereço HTTPS público. O ChatGPT web não lê a configuração local do Codex.
- Onde fica o arquivo de configuração MCP do Cursor?
- O Cursor lê o .cursor/mcp.json dentro de um projeto para os servidores desse projeto, e o ~/.cursor/mcp.json na sua pasta pessoal para servidores disponíveis em todos os projetos.
- O Codex CLI e a extensão do Codex para IDE compartilham as configurações de MCP?
- Sim. A documentação da OpenAI diz que o app do ChatGPT para desktop, o Codex CLI e a extensão para IDE compartilham a mesma configuração de MCP, salva por padrão em ~/.codex/config.toml.
Fontes
- Connect Claude Code to tools via MCP (Claude Code docs)conferido em 14 de nov. de 2026
- Connect to local MCP servers (MCP docs)conferido em 14 de nov. de 2026
- Connect to remote MCP servers (MCP docs)conferido em 14 de nov. de 2026
- Developer mode and custom MCP servers in ChatGPT (OpenAI docs)conferido em 14 de nov. de 2026
- Model Context Protocol (Cursor docs)conferido em 14 de nov. de 2026
- Add and manage MCP servers in VS Codeconferido em 14 de nov. de 2026
- MCP configuration reference (VS Code docs)conferido em 14 de nov. de 2026
- MCP in Codex (OpenAI docs)conferido em 14 de nov. de 2026
- MCP servers with Gemini CLIconferido em 14 de nov. de 2026
- MCP architecture overviewconferido em 14 de nov. de 2026
Mais guias
- Como criar um servidor MCP
- Como criar skills personalizadas para o Claude Code
- Segurança no MCP: perguntas para fazer antes de instalar um servidor ou uma skill
- MCP vs. API: qual é a diferença?
- MCP vs. skills: a diferença entre servidores MCP e skills de agente
- O que é uma skill do Claude?
- O que é um servidor MCP?