Usando o servidor MCP GitHub em seu IDE

Sobre o servidor de MCP do GitHub

O servidor de MCP do GitHub é um servidor de MCP (Protocolo de Contexto de Modelo) fornecido e mantido pelo GitHub. O MCP permite que você integre recursos de IA a outras ferramentas e serviços, aprimorando sua experiência de desenvolvimento fornecendo assistência de IA com reconhecimento de contexto.

Para obter uma introdução completa ao servidor MCP do GitHub e uma visão geral do MCP, consulte Sobre o Protocolo de Contexto de Modelo (MCP).

Pré-requisitos

• Acesso a Copilot. Confira O que é GitHub Copilot?.

• Um IDE da JetBrains compatível. GitHub Copilot é compatível com os seguintes IDEs:

  • IntelliJ IDEA (Ultimate, Community, Educational)
  • Android Studio
  • AppCode
  • CLion
  • Convidado do Code With Me
  • DataGrip
  • DataSpell
  • GoLand
  • Cliente JetBrains
  • MPS
  • PhpStorm
  • PyCharm (Profissional, Comunidade, Educacional)
  • Rider
  • RubyMine
  • RustRover
  • WebStorm
  • Lado do escritor

  Consulte o localizador de ferramentas JetBrains IDEs para fazer o download.

• Versão mais recente da extensão do GitHub Copilot. Confira o plug-in do GitHub Copilot no Marketplace do JetBrains. Para obter instruções de instalação, confira Instalando a extensão GitHub Copilot em seu ambiente.

• Inicie sessão no GitHub no seu IDE da JetBrains. Para obter instruções de autenticação, confira Instalando a extensão GitHub Copilot em seu ambiente.

• O GitHub Servidor MCP, configurado em seu editor. Consulte Configurando o servidor MCP GitHub.

• Se você for membro de uma organização ou empresa com um plano Copilot Business ou Copilot Enterprise, a política "Servidores MCP no Copilot" deverá ser habilitada para usar o MCP com o Copilot.

Usando o GitHub servidor MCP em IDEs do JetBrains

O servidor MCP GitHub permite que você execute uma ampla gama de ações em GitHub, por meio de Bate-papo do Copilot nos IDEs da JetBrains.

1. Abra a Bate-papo do Copilot janela clicando no Copilot Chat do GitHub ícone no lado direito da janela IDE do JetBrains.

   

2. Na parte superior do painel de chat, clique na guia Agent.

3. Para ver as ações disponíveis, na caixa Bate-papo do Copilot, clique no ícone de ferramentas.

   • Você verá uma lista de ações disponíveis do GitHub servidor MCP.

4.        Bate-papo do Copilot Na caixa, digite um comando ou pergunta relacionado à ação que você deseja executar e pressione **Enter**.
   

   • Por exemplo, você pode pedir ao GitHub servidor MCP para criar um novo problema, listar solicitações de pull ou recuperar informações do repositório.

5. O GitHub servidor MCP processará sua solicitação e fornecerá uma resposta na interface de chat.

   • Bate-papo do Copilot Na caixa, você pode ser solicitado a conceder permissões adicionais ou fornecer mais informações para concluir a ação.

6. Siga as instruções para concluir a ação.

Solução de problemas

Se você tiver problemas ao usar o servidor de MCP do GitHub, há algumas etapas comuns de solução de problemas que você pode executar.

Problemas de autorização

Se você estiver tendo problemas para autorizar o servidor de MCP, verifique se:

• Você está conectado ao GitHub no IDE que você escolheu.

Se você estiver autenticando com um PAT (personal access token), verifique se:

• Seu PAT do GitHub é válido e tem os escopos necessários para as ações que você deseja executar.
• Você inseriu o PAT correto.

Problemas no modo do agente do Copilot

Se você estiver tendo problemas com o modo de agente do Bate-papo do Copilot, verifique se:

• Você selecionou o agente correto na caixa do Bate-papo do Copilot.
• Você configurou o servidor MCP corretamente em seu IDE.
• Você tem as permissões necessárias para as ações que está tentando executar.

Bloqueio de proteção de push

Se você estiver usando o servidor MCP GitHub e a proteção por push bloquear um segredo que você acredita que é seguro expor, poderá ignorar o bloqueio especificando um motivo para permitir o segredo. Confira Como trabalhar com a proteção de push e o servidor de MCP do GitHub.

Dicas gerais

Se você estiver enfrentando outros problemas com o servidor de MCP do GitHub, aqui estão algumas dicas gerais para ajudar a solucionar problemas:

• Verifique os logs de saída do servidor de MCP em busca de mensagens de erro.
• Se você estiver executando o servidor de MCP localmente, verifique se o ambiente local está configurado corretamente para executar contêineres do Docker.
• Tente reiniciar o servidor de MCP ou o IDE.