integrações

MCP para agentes de programação: como os agentes se conectam à sua stack

9 min de leitura

Um agente já consegue trabalhar no seu repositório: buscar código, editar arquivos, executar comandos e navegar na web. Mas ele não consegue acessar seu rastreador de erros, banco de dados, tickets ou documentação. Até que estejam conectados, ele fica travado em tudo o que está fora do editor.

O Protocolo de Contexto de Modelo (MCP) é um padrão aberto que conecta um agente a ferramentas e dados externos. Conecte um servidor MCP, e o agente consulta o banco de dados em vez de pedir o schema. Ele abre o ticket em vez de descrever o que deveria constar nele.

Esse acesso é o que diferencia um agente no qual sua equipe pode se apoiar de um que escreve código isoladamente e faz da estratégia de MCP para agentes de programação uma das primeiras questões que as equipes precisam resolver. Este guia mostra, na prática, o que o MCP faz para agentes de programação, quais servidores vale a pena conectar primeiro e como adicionar um em poucos minutos.

Por que os agentes precisam de acesso real a ferramentas

O trabalho está deixando de ser escrever código e passando a ser executar o ciclo ao redor dele, e os agentes de programação já estão recorrendo a mais ferramentas para fazer isso. Em nosso uso, a média de chamadas a ferramentas por sessão subiu cerca de 30% em uma janela recente de dois meses, à medida que os agentes leem arquivos, fazem buscas no código, executam comandos e navegam na web com mais frequência dentro de uma única tarefa.

Cada uma dessas chamadas a ferramentas é um ponto em que ou existe uma integração, ou o agente dá de cara com um bloqueio. O MCP transforma cada uma dessas chamadas em uma conexão funcional, em vez de um beco sem saída. O modelo mais inteligente do mundo não consegue dizer por que o deploy em staging falhou se não consegue ver o seu rastreador de erros. Conecte esse mesmo modelo ao rastreador, ao banco de dados e à fila de issues, e ele muitas vezes consegue percorrer todo o problema, do sintoma à correção. O MCP torna essas conexões portáveis, para que um servidor configurado uma única vez funcione nos agentes e nas interfaces de que sua equipe precisa.

Perguntas antes de conectar

Se você está configurando o MCP para agente de programação pela primeira vez, estes são os pontos que precisam ser definidos antes de começar a instalar servidores.

O que é um servidor MCP?

Um servidor MCP é um pequeno adaptador que expõe uma ferramenta ou fonte de dados (um banco de dados, uma API, um produto SaaS) por meio do Protocolo de Contexto de Modelo, para que qualquer agente compatível com MCP possa usá-lo. Em uma configuração de MCP para agente de programação, o agente é o cliente e o servidor é o conector. Os servidores MCP expõem capacidades como ferramentas, prompts e recursos por meio do protocolo. Na prática, você não precisa escrever a maioria deles: o fornecedor disponibiliza um, ou a comunidade o faz, e você aponta seu agente para ele.

Como o MCP se diferencia de um plugin ou de uma integração comum de API?

Um plugin é desenvolvido para um app. Uma integração direta de API é desenvolvida para um par de sistemas, e você precisa desenvolvê-la novamente para o próximo agente. O MCP é a camada padrão entre os dois, então um servidor escrito uma vez funciona com qualquer cliente que fale o protocolo. Conecte o Sentry ou o Postgres por meio do MCP e ele funcionará da mesma forma no Cursor e em qualquer outro cliente MCP, sem precisar criar uma integração sob medida toda vez.

O agente executa essas ferramentas por conta própria?

Ele as usa como parte do seu trabalho, dentro das permissões que você concede. Você escolhe quais servidores instalar e, para qualquer operação sensível, faz a autenticação via OAuth para que o servidor acesse apenas o que a sua conta permite. Os servidores remotos podem se autenticar com OAuth quando o servidor exigir isso ou com cabeçalhos e chaves de API; os servidores locais são executados como um comando de shell na sua máquina. O agente recebe um conjunto definido de ferramentas, não um cheque em branco para os seus sistemas.

O que faz um servidor MCP ser bom, em vez de só fazer barulho?

Os bons dão ao agente um conjunto enxuto de ações bem nomeadas, para que ele saiba quando recorrer a elas. Os ruins despejam dezenas de ferramentas de pouco valor em cada prompt, inchando a janela de contexto com descrições de ferramentas não utilizadas, o que se agrava à medida que você adiciona servidores. Comece com servidores para os sistemas que você realmente usa no meio da tarefa — seu banco de dados, seu rastreador de erros, qualquer coisa para a qual você vive alternando com Alt+Tab — e adicione mais apenas quando um fluxo de trabalho real pedir isso.

Melhores servidores MCP para o Cursor, por caso de uso

O Cursor Marketplace lista plugins oficiais que são instalados com um clique e já incluem um servidor MCP (muitas vezes com regras e habilidades). Estes são os servidores MCP que mais vale a pena conectar primeiro, agrupados por caso de uso.

Bancos de dados. Dê ao agente acesso de leitura (e, com cuidado, de escrita) ao seu schema e aos seus dados para que ele pare de ficar adivinhando como são suas tabelas.

  • Supabase: gerencie tabelas, busque config e consulte dados em todos os seus projetos do Supabase.
  • MongoDB: conecte-se a bancos de dados, explore dados, gerencie coleções e otimize consultas.
  • Neon Postgres: gerencie projetos e bancos de dados Neon por meio do servidor MCP da Neon.
  • Prisma: servidor MCP, regras e habilidades para desenvolvimento de bancos de dados.

Fluxos de trabalho de desenvolvimento. Conecte o agente às ferramentas onde o trabalho é planejado, entregue e monitorado.

  • Linear: gerencie issues, projetos e documentos em todo o seu espaço de trabalho do Linear.
  • Sentry: traga erros e traces para que o agente possa depurar com base em problemas reais de produção.
  • GitLab: planeje e gerencie issues, merge requests e pipelines a partir do editor.
  • Datadog: consulte logs, métricas, traces e dashboards por meio de um servidor MCP pré-configurado (em preview).

Observação: o GitHub não aparece na lista de MCP porque é uma integração nativa do Cursor. O app do GitHub do Cursor conecta seus repositórios pelo dashboard para que recursos como Agentes na nuvem e Bugbot possam atuar nas suas PRs. Você o conecta uma vez em Integrações, em vez de adicioná-lo por meio de mcp.json.

Automação de navegador. Deixe o agente controlar um navegador real para testar, reproduzir bugs e capturar dados em tempo real.

  • Browserbase Browse: navegue, clique, preencha formulários, extraia dados e tire capturas de tela, tudo controlado via MCP.
  • BrowserStack: teste sites e apps móveis em dispositivos reais e depure falhas.
  • Bright Data: busca na web, extração de conteúdo e automação de navegador em uma plataforma de dados da web.

Recuperação de documentação. Mantenha o agente usando documentação atual e específica da versão, em vez de dados de treinamento desatualizados.

  • Context7: traga documentação atualizada e específica da versão, além de exemplos de código, direto para o contexto.
  • Notion: leve a documentação, as especificações e os requisitos da sua equipe para o fluxo de trabalho de programação.

O marketplace tem muitas outras opções (Figma, Stripe, Postman e outras), então navegue por ele para encontrar o que faz sentido para sua stack. Novos servidores são adicionados regularmente.

Como adicionar um servidor MCP no Cursor

Há duas formas: com um clique pelo marketplace ou com um pequeno arquivo de configuração para qualquer opção personalizada.

How to add an MCP serverMarketplace click, or a small config fileOne clickCursor MarketplaceBrowse official serversAdd to CursorInstall + OAuthReady to useConfig filemcp.jsonProject or home directoryCommand or URLLocal or remote serverReady to use
Two ways to add an MCP server in Cursor: one click from the marketplace, or a config file.

Com um clique. Em uma página do marketplace, clique em Adicionar ao Cursor para instalar o servidor e autenticar com OAuth. Esta é a forma mais rápida de conectar os servidores listados acima.

Arquivo de configuração. Para um servidor personalizado ou auto-hospedado, adicione-o ao mcp.json. Use .cursor/mcp.json em um projeto para ferramentas específicas do projeto ou ~/.cursor/mcp.json no diretório home para ferramentas disponíveis em qualquer lugar. Um servidor local (baseado em comando) fica assim:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Um servidor remoto (HTTP ou SSE) usa uma URL:

{
  "mcpServers": {
    "server-name": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

Para equipes. Administradores podem configurar os servidores MCP da equipe uma única vez para Agentes na nuvem pelo dashboard e vincular esses mesmos servidores a um marketplace da equipe para a janela de agentes, a IDE e a CLI. Os membros da equipe talvez ainda precisem instalar e autenticar, mas não precisam editar manualmente o mcp.json.

A documentação cobre transportes, autenticação e a referência completa de configuração. Consulte cursor.com/docs/mcp.

Crie seu próprio servidor MCP

Se não houver um servidor para seu serviço interno, você pode criar um. Escreva-o em qualquer linguagem que consiga imprimir em stdout ou disponibilizar um endpoint HTTP e faça com que exponha um pequeno conjunto de ferramentas com nomes claros que encapsulem sua API.

A maneira mais rápida de começar é deixar o agente escrevê-lo. Direcione o Cursor para a referência da API do seu serviço, a especificação OpenAPI ou a biblioteca de cliente e peça que ele gere a estrutura de um servidor MCP para os endpoints relevantes. Ele pode ler o schema, gerar o schema JSON e o manipulador de cada ferramenta, além de configurar a autenticação, para que você revise e refine tudo em vez de começar com um arquivo em branco. Mantenha o conjunto de ferramentas enxuto, dê nomes claros a cada ação e adicione o servidor a mcp.json da mesma forma que faria com um servidor de terceiros.

Integre-o à stack que você já usa

Um modelo, por si só, consegue escrever código. Um agente de programação com MCP integrado aos sistemas com que você trabalha leva uma tarefa do ticket até a correção e valida o próprio trabalho ao longo do processo. O MCP torna essas conexões portáveis entre as ferramentas que você usa. Escolha os dois ou três servidores que combinam com a sua stack, conecte-os e dê ao agente acesso direto aos sistemas entre os quais você alterna com frequência.

Publicado em: integrações