Servidor MCP para GitHub: Conecte-se ao Servidor Oficial em Dois Minutos

Publicado originalmente em dreaming.press.

Se você pesquisou "mcp server github", você quase certamente quer uma de duas coisas: conectar seu agente de IA ao GitHub ou construir um servidor que viva no GitHub. Este artigo responde à primeira — a que a maioria das pessoas se refere — e aponta para a segunda no final.

A versão curta: você não constrói um servidor MCP do GitHub. O GitHub já fornece um. É chamado de github/github-mcp-server, é oficial e a maneira mais rápida de usá-lo é pelo endpoint hospedado:

https://api.githubcopilot.com/mcp/

Apontar Claude, Copilot ou Cursor para essa URL, autenticar e seu agente pode ler seus repositórios, triagem de problemas, abrir e revisar pull requests, ler logs de Ações e executar varreduras de código e segredos — cerca de 80 ferramentas em 20 conjuntos de ferramentas, sem servidor para executar. Abaixo está a configuração exata para cada cliente, depois como limitar para que um agente não possa fazer mais do que você pretendia.

O que é um servidor MCP na verdade (30 segundos)

Um servidor MCP é um pequeno programa que expõe três tipos de coisas para um aplicativo de IA através do Protocolo de Contexto do Modelo — um padrão aberto de cliente-servidor:

• Ferramentas — ações chamáveis que o modelo pode invocar (create_pull_request, list_issues).
• Recursos — dados somente leitura endereçados por URI (um arquivo, um registro) que o aplicativo pode carregar no contexto.
• Prompts — modelos reutilizáveis e parametrizados, muitas vezes apresentados como comandos de barra.

O objetivo do padrão é escrever uma vez: qualquer cliente compatível com MCP pode se comunicar com o mesmo servidor, então o GitHub escreve um servidor e Claude, Copilot e Cursor todos o utilizam. (Se você quiser uma explicação mais profunda sobre os três primitivos, escrevemos MCP Tools vs Resources vs Prompts.)

O caminho mais rápido: conectar ao servidor oficial

Duas maneiras de executá-lo. Prefira o servidor remoto, a menos que você tenha um motivo para não fazê-lo — não há nada para instalar e OAuth significa que não há token no disco.

• Remoto / hospedado: https://api.githubcopilot.com/mcp/, mantido pelo GitHub, suporta OAuth e PAT.

• Local: imagem Docker ghcr.io/github/github-mcp-server (ou um binário Go), autenticado com um GITHUB_PERSONAL_ACCESS_TOKEN.

  VS Code (Copilot)

Crie .vscode/mcp.json. Note que a chave é servers, não mcpServers:

json
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
}
}
}

Na primeira utilização, o VS Code (1.101+) executa um login OAuth no navegador — sem token para colar. Se você preferir usar um token, adicione um cabeçalho e um prompt de entrada em vez disso:

json
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/\