Usando o servidor MCP GitHub

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

•           **Acesse ao Copilot**. Confira [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot).
  

•         **Um IDE da JetBrains compatível**. O GitHub Copilot é compatível com as 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](https://plugins.jetbrains.com/plugin/17718-github-copilot?ref_product=copilot&ref_type=engagement&ref_style=text) no Marketplace do JetBrains. Para obter instruções de instalação, confira [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment).
  

•         **Inicie sessão no GitHub no seu IDE da JetBrains**. Para obter instruções de autenticação, confira [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment?tool=jetbrains#installing-the-github-copilot-plugin-in-your-jetbrains-ide).
  

•         **O servidor MCP da GitHub**, configurado em seu editor. Consulte [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/set-up-the-github-mcp-server).
  

• 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 servidor GitHub MCP em IDEs do JetBrains

O servidor de MCP do GitHub permite que você execute uma ampla gama de ações no GitHub via Chat Copilot em IDEs do JetBrains.

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

   

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

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

   • Em MCP Server: GitHub, você verá uma lista de ações disponíveis.

4. Na caixa Chat Copilot, digite um comando ou pergunta relacionado à ação que deseja executar e pressione Enter.

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

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

   • Na caixa do Chat Copilot, 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 Chat Copilot, verifique se:

• Você selecionou o agente correto na caixa do Chat 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.