Using the GitHub MCP Server in your 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).

Prerequisites

• Access to Copilot. Confira O que é GitHub Copilot?.

• A compatible JetBrains IDE. GitHub Copilot is compatible with the following 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).
  

• The GitHub MCP server, configured in your editor. See Setting 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.

Using the GitHub MCP server in JetBrains IDEs

The GitHub MCP server enables you to perform a wide range of actions on GitHub, via Bate-Papo Copilot in JetBrains IDEs.

1. Open the Bate-Papo Copilot window by clicking the Copilot Chat do GitHub icon at the right side of the JetBrains IDE window.

   

2. At the top of the chat panel, click the Agent tab.

3. To see the available actions, in the Bate-Papo Copilot box, click the tools icon.

   • You will see a list of available actions from the GitHub MCP server.

4. In the Bate-Papo Copilot box, type a command or question related to the action you want to perform, and press Enter.

   • For example, you can ask the GitHub MCP server to create a new issue, list pull requests, or retrieve repository information.

5. The GitHub MCP server will process your request and provide a response in the chat interface.

   • In the Bate-Papo Copilot box, you may be asked to give additional permissions or provide more information to complete the action.

6. Follow the prompts to complete the action.

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 Copilot, verifique se:

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