İçeriğe atla

GitHub MCP Server nedir? Kurulum, jeton kapsamları, salt okuma ve güvenlik

Asistanına bir depoyu, issue'yu ya da çekme isteğini (PR) sorarsın; GitHub MCP Server depoları ve kodu okur, issue ve PR'ları yönetir, Actions çalışmalarını izler, güvenlik uyarılarını inceler. GitHub'ın kendi geliştirdiği resmî MCP sunucusu (MIT); GitHub'ın barındırdığı uzak sunucu (kurulum gerekmez) ya da kendi makinende çalışan yerel sunucu (Docker) olarak kullanılır. GitHub Docs sunucunun plan türünden bağımsız tüm GitHub kullanıcılarına açık olduğunu yazıyor. Yazma ve yıkıcı araçlar da var (dosya silme, depo silme, PR birleştirme, workflow tetikleme); salt okunur mod bunları kapatır. Başlıca risk: herkese açık depolardaki issue ve PR metni asistana talimat gibi görünebilir (istem enjeksiyonu).

Ne yapar
Asistana GitHub'da depo, issue, PR ve Actions işi yaptırır
Tür
MCP sunucusu (uzak, GitHub barındırır; ya da yerel Docker)
Nerede
Claude Code, VS Code, Cursor, Codex, Gemini CLI ve daha fazlası
Kimlik
Kişisel erişim jetonu (PAT) ya da OAuth
Yazar mı
Evet: yıkıcı araçlar dahil; salt okunur mod var
Türkçe
Resmî kaynak yazmıyor
Ücret
Sunucu ücretsiz (MIT); plan farkı yok

GitHub MCP Server ne işe yarar?

MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Bu sunucuyla asistanına GitHub'da doğrudan iş yaptırabilirsin: bir deponun dosyalarını ve geçmişini okutmak, kod aratmak, issue ve çekme isteği açtırmak ve incelettirmek, Actions çalışmalarının loglarını okutmak, kod tarama, Dependabot ve sır tarama uyarılarını gözden geçirtmek.

SenDepo, issue ya da PR işini yazarsın
AsistanClaude Code, VS Code, Cursor, Codex, Gemini CLI
GitHub MCP ServerGitHub'ın uzak sunucusu ya da yerel Docker
GitHubDepo, issue, PR, Actions, güvenlik uyarıları

Kimlik: kişisel erişim jetonu (PAT) ya da OAuth. Yazma ve yıkıcı araçlar var; salt okunur mod kapatır.

Depoyu ve kodu okutmakNe alırsın: Dosya içeriği, ağaç, commit ve sürüm listeleri, kod aramasıBağlantı gerekirIssue ve PR'ları yönettirmekNe alırsın: Yeni ya da güncellenmiş issue, PR, yorum, incelemeBağlantı gerekir

Araçlar "toolset" adı verilen gruplara ayrılıyor (context, repos, issues, pull_requests, actions ve diğerleri). Varsayılan olarak yalnız bazıları açık: context, repos, issues, pull_requests ve users (yaklaşık 45 araç). README toplamda 92 araç listeliyor; uzak sunucuda 4 ek araçla 96. Actions ve güvenlik toolset'leri varsayılanda kapalı.

Kime yarar: GitHub'da çalışan ve depo, issue, PR işlerini asistanla hızlandırmak isteyen geliştiricilere. Kod yazmıyorsan işine yaramaz.

GitHub MCP Server nasıl kurulur?

Resmî rehber uzak sunucuyu "başlamanın en kolay yolu" olarak tanıtıyor (https://api.githubcopilot.com/mcp/). Yerel sunucu, uzak MCP desteklemeyen istemciler, GitHub Enterprise Server ve özelleştirme içindir; Docker ister. Kimlik için kişisel erişim jetonu (PAT) her istemcide çalışır. README ince ayarlı jetonu öneriyor. Komutlar resmî rehberden aynen alındı.

Claude Code 2.1.1 ve üstü (terminalde)› claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

Sonra Claude Code'u yeniden başlat ve claude mcp list ile kontrol et. Rehber, Windows'ta add-json "Invalid input" verirse eski biçimi önerir:

Eski biçim (2.1.0 ve öncesi)› claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"

Atlas kartındaki --transport http komutu yalnız eski sürümler için; 2.1.1 ve üstünde rehber add-json biçimini veriyor. Kapsam için --scope local (varsayılan), project (.mcp.json ile ekip) ya da user kullanılır.

Önce salt okunur başla: yerel sunucuda --read-only ya da GITHUB_READ_ONLY=1, uzak sunucuda /readonly adresi ya da X-MCP-Readonly başlığı.

GitHub MCP Server nasıl kullanılır?

Kurduktan sonra isteği doğal dille yazarsın. Yazma gerektiren her işte önce asistanın ne yapacağını söylemesini iste.

Açık PR'ları özetle"GitHub MCP ile benim/proje-adi deposundaki açık çekme isteklerini listele, her birini bir cümleyle özetle. Hiçbir şeyi değiştirme."
Hatayı araştır"Son başarısız Actions çalışmasının logunu oku ve hatanın nedenini yaz. Düzeltme için dosya değiştirme, önce bana öner."
Issue aç"Şu hatayı anlatan bir issue taslağı hazırla ve bana göster. Ben onaylayana kadar issue açma."

Her araç çağrısını onaylatan bir istemcide onayı açık tut; özellikle silme, birleştirme ve push araçlarında.

GitHub MCP Server hangi programlarda çalışır?

Claude CodeVarUzak (PAT) ya da yerel Docker; komut sürüme göre değişir.
Claude DesktopKısmenUzak sunucu özel bağlayıcıyla eklenemiyor; yerel Docker kullanılır.
VS Code (Copilot), Visual Studio, JetBrains, Xcode, EclipseVarCopilot ayarları üzerinden; bazılarında Copilot erişimi ön koşul.
Cursor, Windsurf, Zed, OpenCodeVarResmî rehber var; uzak sunucuda çoğu PAT ister.
Codex, Gemini CLI, GitHub Copilot CLIVarResmî rehber var.
ChatGPTNet değilResmî rehberde adı geçmiyor; bir kullanıcı ChatGPT sonrası hesap askıya alma bildirdi (issue #3497), tek ve doğrulanmamış bir bildirim.

GitHub MCP Server neye erişir, ne yazar, ne siler?

Okur

Kimliğinin eriştiği depolar: dosyalar, dallar, commit'ler, issue'lar ve PR'lar, Actions çalışmaları ve logları, Dependabot, kod tarama ve sır tarama uyarıları, bildirimler, tartışmalar, projeler, kuruluş ve takım üyeleri. Özel depolar dahil; erişim jetonun kapsamı ve senin GitHub yetkilerinle sınırlı.

Yazar

Issue ve PR açma, güncelleme, yorum, inceleme ve birleştirme; dosya oluşturma ve güncelleme, push; dal ve depo oluşturma, çatallama; gist; etiket; Actions workflow tetikleme; kuruluş yönetişim araçları.

Siler

delete_file (commit olarak dosya silme) ve delete_repository (depo silme) araç listesinde var; bazı araçlar silme yöntemleri içeriyor. Hangi araçların açık olduğunu toolset ve araç seçimiyle sen belirlersin.

Veri nereye gider

Uzak sunucu GitHub altyapısında çalışır; yerel sunucuda kod makinende çalışır ve GitHub API'sine bağlanır. Okunan içerik (özel depo verisi dahil) kullandığın yapay zekâ modeline gider.

Salt okunur modNasıl
Yerel sunucu--read-only bayrağı ya da GITHUB_READ_ONLY=1 ortam değişkeni.
Uzak sunucu/readonly adresi ya da X-MCP-Readonly başlığı.
ÖncelikSalt okunur mod önceliklidir: --tools ile açıkça istense bile yazma araçları atlanır (README).

Herkese açık depolardaki issue, PR, yorum ve commit metni asistana talimat gibi görünen içerik taşıyabilir. Lockdown modu push yetkisi olmayan kullanıcıların içeriğini süzer ama README bunun bir yetkilendirme sınırı olmadığını yazıyor. Güvenlik kayıtları: GHSA-pjp5-fpmr-3349 (orta, 1.1.2'de yamalı) ve GHSA-w4q6-qw23-4rg7 (yüksek, kimlik doğrulamasız çökme). İkincisinde GitHub kaydında yama sürümü boş ve etkilenen aralık "0.33.0 ve altı (en son ana dal dahil)" yazıyor; OSV ise 1.1.0'da düzeldiğini söylüyor. Kesin bir yama sürümü net değil; güncel sürümü kullan.

Kuruluş tarafı: erişim her zaman kimliğin GitHub yetkisiyle sınırlı, anonim erişim yok. Yöneticiler "MCP servers in Copilot" politikasını, OAuth App erişimini, PAT politikalarını (klasik jetonlar kapatılabilir) ve SSO zorlamasını kullanır. Tek bir "hepsini kapat" anahtarı yok. Temel API çağrıları GitHub denetim günlüğüne düşer; MCP'ye özel günlükleme henüz yok.

GitHub MCP Server ücretsiz mi, Copilot gerekir mi?

Sunucunun kendisi ücretsiz ve MIT lisanslı. GitHub Docs sunucunun plan türünden bağımsız tüm GitHub kullanıcılarına açık olduğunu yazıyor. Genel olarak Copilot aboneliği şart değil; ancak ücretli GitHub ya da Copilot lisansı isteyen özelliklerle ilgili araçlar (örneğin Copilot kodlama ajanı) aynı lisansı ister ve Visual Studio'da kullanım için Copilot erişimi ön koşul. Copilot Business ve Enterprise üyelerinde kuruluşun "MCP servers in Copilot" politikası açık olmalı. Kendi makinende çalıştırmak için GitHub'a ücret yok; Docker ve model maliyeti sende. API hız sınırı için resmî belge sayı vermiyor, yalnız GitHub API sınırlarına tabi olduğunu söylüyor.

Yapabilirsin
  • MIT: kullanmak, değiştirmek, ticari işte kullanmak serbest
  • Sunucu plan türünden bağımsız tüm GitHub kullanıcılarına açık
Yasak
  • Ücretli Copilot ya da GitHub lisansı isteyen özelliklerin araçları aynı lisansı ister
  • GitHub Enterprise Server için uzak sunucu desteklenmiyor, yalnız yerel kullanılır

Kaynak: GitHub Docs, README ve politika belgesi. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyorNe yapmalı
Araçlar listede görünmüyor ya da 401 alıyorsunPAT'ın süresi dolmamış olmalı ve araç için gereken kapsamı içermeli (genelde "repo"). Klasik PAT'ta kapsamı olmayan araçlar listeden gizlenir; ince ayarlı PAT'ta tüm araçlar görünür ama API izni reddeder.
Docker imajı çekilirken hataResmî rehber: imaj herkese açık, süresi dolmuş bir jeton hataya yol açmış olabilir. docker logout ghcr.io sonra yeniden dene.
Claude Desktop'ta uzak sunucu "Add custom connector" ile eklenmiyorResmî rehber: şu an desteklenmiyor; yerel Docker kurulumunu kullan.
Kullanıcıların bildirdiği v2.0.x sonrası Claude Code araç listesi "missing required resultType" hatasıyla yüklenmiyorAçık issue #3453 (07.10.2026): bildiren kullanıcı v1.14.0 imajının çalıştığını yazmış; bir yorumcu v2.0.1'i çoğaltamamış. Durum netleşmedi.
Kullanıcıların bildirdiği PAT'lı Docker komutu "unknown option -e" veriyorAçık issue #3032 (06.08.2026); alternatif olarak add-json biçimini ya da OAuth komutunu dene.

GitHub MCP Server nasıl kaldırılır?

  1. İstemciden kaldır: Claude Code'da claude mcp remove github; Cursor'da ~/.cursor/mcp.json içinden github girdisini sil; VS Code'da MCP yapılandırmasından sil.
  2. PAT kullandıysan: GitHub › Settings sonra Developer settings › Personal access tokens bölümünden jetonu iptal et. İnce ayarlı jeton iptali kolaylaştırır.
  3. OAuth ile bağladıysan: GitHub hesabındaki yetkili uygulamalardan erişimi kaldır.
  4. Docker (isteğe bağlı): docker rmi ghcr.io/github/github-mcp-server yerel imajı siler.

Sık sorulan sorular

GitHub MCP Server nedir?

GitHub'ın resmî, MIT lisanslı MCP sunucusu. Yapay zekâ asistanının depoları ve kodu okumasını, issue ve çekme isteklerini yönetmesini, Actions çalışmalarını ve güvenlik uyarılarını incelemesini sağlar. Uzak (GitHub barındırır) ya da yerel (Docker) çalışır.

GitHub MCP Server ücretsiz mi, Copilot aboneliği gerekir mi?

Sunucu plan fark etmeksizin tüm GitHub kullanıcılarına açık ve MIT lisanslı. Copilot aboneliği genel olarak şart değil; ama ücretli Copilot ya da GitHub lisansı isteyen özelliklerle ilgili araçlar aynı lisansı ister ve Visual Studio'da Copilot erişimi ön koşul.

Asistan yanlışlıkla depomu silebilir mi?

Araç listesinde delete_repository ve delete_file var; hangi araçların açık olduğunu toolset ve araç seçimiyle sen belirlersin. Salt okunur mod (--read-only, /readonly, X-MCP-Readonly) yazma araçlarını tamamen kapatır. Jetonu yalnız gereken depolarla sınırlamak (ince ayarlı PAT) bir başka korumadır.

Lockdown modu istem enjeksiyonundan korur mu?

Kısmen. Lockdown modu push yetkisi olmayan kullanıcıların içeriğini süzer ama README bunun bir yetkilendirme sınırı olmadığını, süzülen içeriğin başka araçlarla yine erişilebilir olabileceğini yazıyor.

Uzak mı yerel mi kurmalıyım?

Resmî rehber uzak sunucuyu en kolay yol olarak tanıtıyor. Yerel sunucu uzak MCP desteklemeyen istemciler, GitHub Enterprise Server ve özelleştirme içindir ve Docker ister.

Claude Desktop'a eklenir mi?

Uzak sunucu özel bağlayıcıyla eklenemiyor: resmî rehber bunun OAuth kaydı gerektirdiğini ve şu an desteklenmediğini yazıyor. Yerel Docker kurulumu kullanılıyor.

GitHub Enterprise ile çalışır mı?

GitHub Enterprise Cloud için uzak sunucu kullanılabilir. GitHub Enterprise Server'da uzak barındırma desteklenmiyor; yerel sunucu GitHub adresi ayarıyla kullanılır. Kuruluş politikaları (OAuth App, PAT, SSO) geçerlidir.

GitHub MCP Server hangi işlerde, hangi setlerde?

Claude Code ile başlangıç

İlgili rehberler

Cline21st MCPai-memoryawwwards-animationsBrave Search MCPChrome DevTools MCP

Kaynaklar

Resmî kaynaklarda net olmayanlar: Hız sınırı rakamı (resmî belge vermiyor) · GitHub Advanced Security uyarılarının hangi planda açık olduğu · karma araçların tam yöntem listesi · OAuth izin ekranı ve yetkili uygulamalar menü yolu · GHSA-w4q6-qw23-4rg7 için kesin yama sürümü (GitHub ve OSV farklı diyor) · Rovo Dev CLI, Cline, Roo Code ve Antigravity rehberlerinin komutları · Türkçe bilgisi. Her biri ilgili bölümde yazılı.