O MCP permite que Claude, Cursor e ChatGPT acessem seus arquivos e ferramentas por meio de um formato compartilhado. Este artigo mostra um primeiro servidor seguro, configurações funcionais para cada app, os hábitos de aprovação que mantêm você no controle e soluções para os erros que os iniciantes mais enfrentam.
Seu assistente de IA pode redigir um e-mail em segundos, mas, quando você pede para ler a planilha que está na sua área de trabalho, ele esbarra em um limite. O MCP remove esse limite. O Model Context Protocol é um padrão aberto que permite a um app de IA acessar seus arquivos, bancos de dados, calendários e outras ferramentas por meio de um formato de conexão compartilhado. Você configura a ferramenta uma vez, e todo app compatível pode usá-la.
Este artigo mostra como usar o MCP do zero. Você vai conhecer as três peças do sistema, criar uma primeira configuração funcional no Claude, no Cursor e no ChatGPT, aprender os hábitos de segurança que vale criar desde o primeiro dia e corrigir os erros que quase todo iniciante encontra. Reserve cerca de uma hora para os três apps, ou dez minutos para apenas um.
MCP significa Model Context Protocol. A Anthropic o apresentou em novembro de 2024, e o projeto agora fica sob a Agentic AI Foundation, um fundo dirigido da Linux Foundation cofundado pela Anthropic, pela Block e pela OpenAI. A documentação oficial o descreve como uma porta USB-C para aplicativos de IA: um único formato de conector que funciona com muitos dispositivos.
Antes do MCP, cada integração era um trabalho sob medida. Um conector feito para um app não servia para outro. Agora, um servidor escrito uma vez funciona em qualquer cliente que fale o protocolo, e Claude, ChatGPT, Cursor e Visual Studio Code todos falam.
Toda configuração de MCP tem as mesmas peças:
Quando você edita um arquivo de configuração abaixo, está dizendo a um host quais servidores iniciar ou chamar.
💡 Atalho para iniciantes: a maioria dos tutoriais chama o próprio app (Claude, Cursor, ChatGPT) de "client". A diferença só importa quando você cria o seu próprio servidor.
Um servidor pode oferecer três tipos de coisas:
| Primitivo | O que é | Exemplo |
|---|---|---|
| Ferramentas | Funções que o assistente pode chamar | Criar um arquivo, executar uma consulta em um banco de dados |
| Recursos | Dados que o assistente pode ler | O conteúdo de um arquivo, o esquema de um banco de dados |
| Prompts | Modelos reutilizáveis | Um formato de relatório de bug com campos para preencher |
As ferramentas são o que você vai usar primeiro. Quando você pede ao Claude para renomear uma pasta de arquivos, ele escolhe uma ferramenta da lista do servidor e espera sua aprovação antes de executá-la.
Os servidores vêm em dois tipos, e a diferença define quais apps podem usá-los:
| Local (stdio) | Remoto (Streamable HTTP) | |
|---|---|---|
| Onde roda | No seu computador, iniciado pelo app | Em um serviço hospedado |
| Quem usa | Uma pessoa | Muitas pessoas |
| Login | Raramente necessário | Geralmente OAuth |
| Ideal para | Arquivos, bancos de dados locais | Serviços em nuvem, como sistemas de rastreamento de problemas |
O Claude Desktop e o Claude Code podem iniciar servidores locais. O Cursor lida com os dois tipos. O ChatGPT se conecta apenas a servidores remotos. Guarde esta tabela em mente, porque ela explica a maior parte da confusão nas seções abaixo.
💡 O protocolo continua evoluindo (a revisão mais recente é datada de 2026-07-28), mas uma configuração para iniciantes não precisa dos detalhes da especificação. Mantenha seus apps atualizados e siga em frente.
A maioria dos servidores da comunidade é iniciada com npx, uma ferramenta que vem com o Node.js. Abra um terminal e execute:
node --version
Se aparecer um número de versão, está tudo pronto. Se o comando não for encontrado, instale a versão LTS em nodejs.org e depois reabra o terminal. LTS significa Long Term Support (suporte de longo prazo), e é a opção estável.
Comece com o servidor oficial de sistema de arquivos, publicado como @modelcontextprotocol/server-filesystem. Ele permite que o assistente leia, crie, mova e pesquise arquivos dentro das pastas que você indicar.
Crie uma pasta descartável chamada mcp-sandbox e coloque nela dois ou três arquivos de texto. Use essa pasta em todos os testes deste artigo.
⚠️ Um servidor local roda com as permissões da sua conta de usuário. Liste apenas pastas que você se sinta à vontade para deixar o assistente ler e alterar. Sua pasta pessoal inteira é uma escolha ruim para começar.
Os apps da Anthropic oferecem dois caminhos. O Claude Desktop usa um arquivo de configuração em JSON. O Claude Code, o app de terminal, usa um comando. Escolha o que você usa no dia a dia, ou use os dois.
| Sistema | Caminho |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
Substitua o conteúdo pelo trecho correspondente ao seu sistema, trocando pelo seu próprio nome de usuário. No macOS:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/mcp-sandbox"]
}
}
}
No Windows, use barras invertidas duplas:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\username\\mcp-sandbox"]
}
}
}
Cada parte tem uma função:
"filesystem" é o nome amigável que aparece no app."command": "npx" executa o servidor por meio do Node.js.-y confirma o download do pacote para que a inicialização não trave em uma pergunta.Salve o arquivo e depois feche completamente o Claude Desktop e abra-o de novo. Fechar a janela não basta, porque o app lê a configuração na inicialização.
Clique no botão Adicionar arquivos, conectores e mais no canto inferior esquerdo da caixa de mensagem, passe o cursor sobre Conectores e escolha Gerenciar conectores. Selecione filesystem para ver as ferramentas dele. Depois, faça um pedido simples:
Liste os arquivos da minha pasta mcp-sandbox e me diga qual deles foi alterado mais recentemente.
O Claude pede aprovação antes de cada operação com arquivos. Leia o pedido e então aprove ou negue.
💡 Servidores remotos dispensam o JSON. No claude.ai, vá em Settings (Configurações), depois em Connectors (Conectores), clique em Add custom connector (Adicionar conector personalizado), dê um nome e cole a URL do servidor. Normalmente você fará login por OAuth. Contas gratuitas ficam limitadas a um conector personalizado.
O Claude Code adiciona servidores pelo terminal. A forma do comando depende do tipo de servidor:
# Remote server over HTTP
claude mcp add --transport http example https://example.com/mcp
# Local server over stdio (note the double dash)
claude mcp add --transport stdio files -- npx -y @modelcontextprotocol/server-filesystem /Users/username/mcp-sandbox
# See what is configured
claude mcp list
claude mcp get files
claude mcp remove files
O -- separa as opções do próprio Claude do comando que inicia o servidor. Se você esquecê-lo, os argumentos serão interpretados de forma errada. Dentro de uma sessão do Claude Code, digite /mcp para verificar o status de cada servidor ou para concluir um login OAuth.
Onde o servidor é salvo depende do seu escopo:
| Escopo | Disponível em | Compartilhado com a equipe | Armazenado em |
|---|---|---|---|
| Local (padrão) | Somente no projeto atual | Não | ~/.claude.json |
| Project (Projeto) | Somente no projeto atual | Sim | .mcp.json na raiz do projeto |
| User (Usuário) | Todos os seus projetos | Não | ~/.claude.json |
Adicione --scope project para gravar um arquivo .mcp.json que você pode versionar, assim sua equipe recebe os mesmos servidores. Use --scope user para as ferramentas que você quer em todos os lugares.
O Cursor lê um arquivo JSON em um de dois níveis:
.cursor/mcp.json na raiz do projeto, para ferramentas ligadas a uma única base de código.~/.cursor/mcp.json na sua pasta pessoal, para ferramentas que você quer em todos os projetos.O formato é igual ao do Claude Desktop:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/mcp-sandbox"]
}
}
}
O Cursor oferece três transportes, então você pode misturar servidores locais e remotos no mesmo arquivo:
| Transporte | Roda | Ideal para |
|---|---|---|
| stdio | Localmente, gerenciado pelo Cursor | Um usuário, ferramentas locais |
| SSE | Local ou remoto | Servidores que já o utilizam |
| Streamable HTTP | Local ou remoto | Servidores compartilhados e hospedados |
Por padrão, o Cursor pede aprovação antes de executar uma ferramenta MCP. Os modos de execução podem aprovar automaticamente as ferramentas que você incluiu em uma lista de permissões, então comece com restrições e afrouxe depois.
Para um servidor hospedado, troque command e args por uma URL:
{
"mcpServers": {
"example": {
"url": "https://example.com/mcp"
}
}
}
O Cursor Marketplace e o cursor.directory também oferecem um botão Add to Cursor (Adicionar ao Cursor), que instala um servidor e cuida do login OAuth em uma única etapa. Se um servidor precisar de um token, use a interpolação ${env:NAME} em vez de colar o segredo no arquivo. O Cursor também aceita ${userHome} e ${workspaceFolder} nos valores de configuração.
O ChatGPT funciona de forma diferente dos outros dois apps. Ele se conecta a servidores remotos acessíveis por HTTPS. Um servidor que você inicia com npx na sua máquina não aparecerá, porque o ChatGPT não consegue iniciar um processo no seu computador.
O fluxo, como a OpenAI descreve:
A OpenAI afirma que servidores MCP personalizados são serviços de terceiros, não desenvolvidos nem verificados pela OpenAI. Os nomes dos menus já mudaram várias vezes, então, se um rótulo for diferente, pesquise "developer mode" na documentação para desenvolvedores da OpenAI. Alguns planos também limitam ações de escrita, então um conector pode ler dados e se recusar a alterar qualquer coisa. Verifique seu plano antes de depurar o que, na verdade, é uma limitação do plano.
Desenvolvedores que criam com a API podem anexar o mesmo servidor pela Responses API, com uma entrada de ferramenta de type: "mcp", além de um server_label, um server_url, uma lista de allowed_tools e uma configuração de require_approval.
💡 Um servidor, três apps. Hospede um único servidor remoto e você poderá colar a URL dele nos conectores personalizados do Claude, no
mcp.jsondo Cursor e no ChatGPT. Essa é a vantagem de um protocolo compartilhado.
Um assistente com ferramentas pode agir, e agir tem consequências. Dois hábitos eliminam a maior parte do risco.
Nunca cole um segredo em um arquivo de configuração que você possa versionar ou compartilhar. Passe-o por uma variável de ambiente. No Cursor, use ${env:NAME}. No Claude Code, adicione --env NAME=value ao registrar um servidor local. Antes de fazer commit de .mcp.json ou .cursor/mcp.json, abra o arquivo e confirme que nenhum token está nele.
Comece pelos logs. O Claude Desktop grava os logs do MCP em ~/Library/Logs/Claude no macOS e em %APPDATA%\Claude\logs no Windows. O arquivo mcp.log registra as tentativas de conexão e as falhas, e cada servidor também tem seu próprio mcp-server-NAME.log com o que ele imprimiu em stderr.
| Sintoma | Causa provável | Solução |
|---|---|---|
| Servidor ausente no Claude Desktop | Erro de digitação no JSON, ou a janela foi fechada em vez de o app ser encerrado por completo | Valide o JSON, feche o app por completo e abra-o de novo |
npx falha ou mostra ENOENT | O Node.js não está no PATH, ou %APPDATA%\npm não existe no Windows | Instale a versão LTS do Node.js, execute npm install -g npm e reabra o app |
| O servidor conecta, mas as ferramentas falham sem aviso | Caminhos relativos, ou um pacote que trava na inicialização | Use caminhos absolutos e depois execute o mesmo comando npx em um terminal para ler o erro |
| "Needs authentication" no Claude Code | Login OAuth não concluído | Execute /mcp e conclua o login no navegador |
| Nada aparece no ChatGPT | Servidor somente local, modo desenvolvedor desativado ou limite do plano | Use um servidor HTTPS remoto e verifique o modo desenvolvedor e seu plano |
No Windows, se um log mencionar ${APPDATA} dentro de um caminho, adicione o valor expandido ao bloco env do servidor, por exemplo "APPDATA": "C:\\Users\\username\\AppData\\Roaming\\", e depois reinicie o app.
Quando nada mais funcionar, execute o comando do servidor manualmente. Se ele falhar em um terminal, também falhará dentro do app, e o terminal mostra o erro completo.
Quando o teste com o sistema de arquivos funcionar, adicione um servidor que produza algo que você possa ver. A geração de imagens é um bom segundo passo, porque você consegue avaliar o resultado de relance.
O PicassoIA oferece um conector MCP que dá ao seu assistente quatro modelos: PicassoIA Image para texto para imagem, PicassoIA Image Editor Pro para edições, PicassoIA Video para vídeo a partir de texto ou de uma imagem, e Seedance 2.5 Lite para vídeo com áudio. Você gerencia as conexões pela sua conta do PicassoIA depois de fazer login.
As gerações são assíncronas. O assistente inicia uma tarefa, recebe um ID de previsão com um tempo estimado e, após a espera sugerida, consulta o status até que a tarefa informe sucesso ou falha. Uma falha é definitiva, então o assistente simplesmente inicia uma nova geração. Cada conta executa até cinco previsões ao mesmo tempo, compartilhadas entre todas as suas conexões.
Use um primeiro prompt como este para testar a conexão:
Gere uma imagem fotorrealista de uma mesa de madeira com um notebook e uma caneca de café sob a luz suave da manhã, depois me mostre o link.
Curioso para saber como diferentes modelos lidam com a mesma dúvida de configuração? Cole uma configuração quebrada no Claude Sonnet 5 e no GPT 5.6 Sol e veja qual deles explica o erro do JSON com mais clareza.
Seus próximos dez minutos são simples. Escolha um app deste artigo, adicione o servidor de sistema de arquivos e execute o prompt de teste. Depois, abra o Picasso IA, escolha um modelo na lista completa de modelos e gere sua primeira imagem. Uma configuração funcionando é só o começo. A diversão começa quando seu assistente cria coisas com as ferramentas que você lhe deu.
Escolha seu idioma
