Como conectar seu primeiro servidor MCP ao Claude Code ou ao Cursor

Se você passou algum tempo com um assistente de codificação de IA, provavelmente chegou ao momento em que ele escreve código lindamente, mas não faz ideia do que há no seu banco de dados, no seu rastreador de issues ou nos seus arquivos de design. Você acaba copiando e colando contexto no chat repetidamente. O Model Context Protocol (MCP) existe para acabar com esse ciclo de copiar e colar. Este guia explica o que é o MCP e te conduz pela conexão do seu primeiro servidor.

O que o MCP realmente é

O MCP é um padrão aberto, introduzido pela Anthropic, para conectar ferramentas de IA a dados e serviços externos. A analogia comum é que o MCP é uma "porta USB-C para IA": em vez de cada ferramenta inventar sua própria integração customizada, um agente de IA pode se conectar a qualquer servidor compatível com MCP usando um único protocolo universal.

A grande vitória prática é a portabilidade. Como o Cursor e o Claude Code falam o mesmo protocolo, um servidor que você configura em um geralmente funciona no outro — e, desde a WWDC 2026, até o Xcode 27 da Apple adicionou suporte a plugins MCP. Aprenda uma vez, reutilize em todo lugar.

Um servidor MCP é só um pequeno programa que expõe tools (ações que a IA pode realizar) e resources (dados que ela pode ler). Existem servidores prontos para GitHub, PostgreSQL, Slack, Google Drive, Puppeteer e muitos outros.

Os dois tipos de servidor que você vai encontrar

Há dois transportes que vale conhecer como iniciante:

• Servidores locais (stdio) rodam como um processo na sua própria máquina — ótimos para coisas como um sistema de arquivos ou um banco de dados local. Eles começam com um comando como npx ou python.
• Servidores remotos (HTTP/SSE) são hospedados por um fornecedor em uma URL, muitas vezes atrás de um login OAuth — por exemplo Notion, Asana ou Sentry.

Conectando um servidor no Claude Code

O Claude Code usa um único comando claude mcp add. Para um servidor remoto, aponte-o para uma URL:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Para um servidor local, tudo depois de -- é o comando que o Claude roda para iniciá-lo:

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

O separador -- é importante: ele diz ao Claude Code onde suas próprias flags terminam e onde começa o comando de inicialização do servidor. Você pode então listar o que está conectado com claude mcp list para confirmar que o handshake deu certo.

O Claude Code também suporta escopos, que decidem quem pode ver o servidor. Um escopo local o mantém só para você nesta máquina, o escopo project grava a configuração em um arquivo .mcp.json compartilhado que toda a sua equipe pode commitar no git, e o escopo user o torna disponível em todos os seus projetos. Para qualquer coisa de que seus colegas também precisem, o escopo de projeto costuma ser a escolha certa.

Conectando um servidor no Cursor

O Cursor expõe a mesma capacidade pela sua interface. Abra Cursor Settings, vá em Features > MCP e clique em "+ Add New MCP Server", depois cole o comando de inicialização (para servidores locais) ou a URL (para os remotos). Por baixo dos panos, o Cursor armazena isso em uma configuração JSON, então você também pode editá-la à mão. Um refinamento agradável de 2026: o agente do Cursor agora carrega as descrições das tools sob demanda, em vez de empilhar as tools de cada servidor no prompt, o que mantém tudo rápido mesmo quando você tem vários servidores conectados.

Um primeiro projeto concreto

Se você quer uma vitória de cinco minutos, conecte um servidor MCP do GitHub e então pergunte ao seu assistente algo que ele nunca conseguiria responder antes:

"Olhe as três issues fechadas mais recentemente neste repositório e resuma o que mudou."

Sem o MCP, o assistente adivinharia ou pediria para você colar as issues. Com o servidor conectado, ele chama as tools do GitHub diretamente, lê as issues reais e responde a partir de dados ao vivo. Esse é todo o propósito do MCP em um exemplo: o modelo deixa de ser uma caixa de texto esperta e passa a ser um agente que consegue alcançar os sistemas em que você de fato trabalha.

Notas de segurança antes de você se empolgar

O MCP dá a uma IA acesso real a sistemas reais, então trate novos servidores como qualquer outra dependência. Prefira servidores oficiais ou bem avaliados, leia quais tools um servidor expõe antes de conectá-lo, restrinja chaves de API às permissões mínimas necessárias e seja cauteloso com servidores que conseguem escrever ou apagar dados. Comece com casos de uso somente leitura — consultar o esquema do seu banco de dados, ler issues, pesquisar docs — e gradue para ações de escrita quando confiar na configuração.

Uma vez que o ciclo de copiar e colar acaba, é difícil voltar. Comece com um servidor que resolva uma chateação real no seu fluxo de trabalho e cresça a partir daí.