Yapay Zeka Ajanları ile GitHub Nasıl Ücretsiz Kullanılır (2026)

Evet, GitHub ücretsizdir: GitHub Free planı sınırsız genel ve özel depo (repository), sınırsız iş birlikçi ve ayda 2.000 GitHub Actions dakikası sunar. Yapay zekâ ajanları da bu plandan yararlanabilir. GitHub'ın kendi dokümantasyonunda resmi MCP sunucusunun "plan türünden bağımsız olarak tüm GitHub kullanıcılarına açık" olduğu belirtiliyor; bu sayede Claude Code, Codex veya OpenCode ücretli bir GitHub planına ihtiyaç duymadan issue'ları okuyabilir, pull request açabilir ve iş akışı çalıştırmalarını (workflow runs) kontrol edebilir. Ödeme yapmanız gerekebilecek tek kalem ajanın kullandığı modeldir ve bunu da 0 dolarda tutmanın bir yolu var.

Özetle

GitHub'ın resmi MCP sunucusunu hassas izinli (fine-grained) bir kişisel erişim belirteciyle (personal access token) kodlama ajanınıza bağlayın. GitHub Free'de dikkat edilmesi gereken temel sınırlar; özel depolardaki Actions dakikaları, REST istek sınırları (rate limit) ve yalnızca genel depolara açık olan birkaç iş birliği özelliğidir. Asıl maliyet ajanın kendisinde ortaya çıkar: Claude Code ve Codex ücretli bir plan veya API kredisi gerektirirken, OpenCode şu an bazı ücretsiz modeller sunmaktadır. Ajanlar işleri fiilen yürütmeye başladığında, Sharkly'nin GitHub entegrasyonu yeni açılan issue'ları doğrudan bir Ajan'a atayabileceğiniz Görevlere dönüştürür.

GitHub'ın ücretsiz planı: Ajanlar için önem taşıyan sınırlar

GitHub Free depolama alanı ve kullanıcı sayısı konusunda oldukça cömert olsa da, bir ajanın sınırlarını zorlayabileceği alanlarda daha kısıtlayıcıdır.

Actions dakikaları. Fiyatlandırma sayfasında ayda 2.000 dakika belirtilmiştir ve Actions "genel depolarda ücretsizdir". Pull request açan bir ajan, her push işleminde sürekli entegrasyon (CI) hattınızı tetikler. Günde on PR açan, her biri ikişer kez push edilen ve test paketi altı dakika süren bir ajan, ayda yaklaşık 3.600 dakika tüketir; dolayısıyla özel bir depoda dakika bütçesi aşılacak ilk engel olabilir. Bu yüzden CI sürecinizi hızlı tutun veya iş akışına bir concurrency grubu ekleyerek geçerliliğini yitiren çalıştırmaları iptal edin.

İstek sınırları (Rate limits). Her MCP araç çağrısı, belirteciniz üzerinden yapılan bir GitHub API çağrısına dönüşür. GitHub'ın REST istek sınırı dokümantasyonu, kişisel belirteçlere saatte 5.000 istek hakkı tanır; ayrıca dakika başına yaklaşık 80 içerik oluşturma isteği gibi ikincil sınırlar da bulunur. Tek bir ajan bu sınırlara nadiren takılır; ancak aynı belirteci paylaşan birden fazla ajan takılabilir.

Yalnızca genel depolara özel özellikler. Free planında code owners, taslak pull request'ler ve ortam koruma kuralları yalnızca genel depolar için geçerlidir. Ajanların özel bir depoda taslak PR açmasını istiyorsanız, bu özellik ücretli planlarda yer alır.

Copilot Free. Ayda 2.000'e kadar kod tamamlama, editör içinde ajan modu ve MCP desteği sunar; ancak planlar sayfasında Copilot bulut ajanının dahil olmadığı belirtilir ve Yapay Zekâ Kredisi miktarı net bir sayı olarak verilmez. Bunu doğrudan görev atayabileceğiniz bir ekip arkadaşı olarak değil, bir editör asistanı olarak değerlendirin.

MCP sunucusunun kendisi. GitHub'ın MCP kurulum dokümantasyonu bir sınıra dikkat çeker: "Bir özellik ücretli bir GitHub veya Copilot lisansı gerektiriyorsa, ilgili MCP aracı da aynı aboneliği gerektirecektir." Issue'lar, pull request'ler, depolar ve Actions günlükleri Free planında çalışır; ancak Copilot bulut ajanını yöneten araçlar çalışmaz.

GitHub'ı Claude Code, Codex veya OpenCode'a bağlama

github-mcp-server deposu bunu çalıştırmanın iki yolunu belgeler: GitHub'ın https://api.githubcopilot.com/mcp/ adresindeki barındırılan uç noktası veya yerel bir Docker imajı. Barındırılan uç nokta herhangi bir kurulum gerektirmez, bu yüzden oradan başlamak en iyisidir.

1. Hassas izinli kişisel erişim belirteci oluşturun. Belirtece yalnızca ajanın erişmesi gereken depolar için izin verin; Issues ve Pull requests için okuma/yazma, Contents ve Actions için ise yalnızca okuma yetkisi tanımlayın. GitHub kılavuzlarında klasik repo kapsamından bahsedilse de, yalnızca belirli depolarla sınırlandırılmış hassas izinli bir belirteç bir ajan için çok daha güvenli bir tercihtir.

2a. Claude Code. GitHub'ın Claude kılavuzuna göre standart bir terminalde şu komutu çalıştırın:

claude mcp add --transport http github https://api.githubcopilot.com/mcp \
  -H "Authorization: Bearer YOUR_GITHUB_PAT"

Ardından claude mcp list komutunu çalıştırarak github bağlantısının kurulduğunu doğrulayın.

2b. Codex. GitHub'ın Codex kılavuzu belirteci bir ortam değişkeninden okur, böylece belirteç asla yapılandırma dosyasına yazılmaz:

export GITHUB_PAT_TOKEN=your_token
codex mcp add github --url https://api.githubcopilot.com/mcp/ \
  --bearer-token-env-var GITHUB_PAT_TOKEN

Araçları görmek için Codex içinde /mcp komutunu çalıştırın.

2c. OpenCode. GitHub'ın OpenCode kılavuzuna göre proje kök dizinindeki opencode.json dosyasına şunu ekleyin:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "github": {
      "type": "remote",
      "url": "https://api.githubcopilot.com/mcp/",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

{env:...} formatı, belirtecin yanlışlıkla depoya commit edilebilecek bir dosyada değil, kabuğunuzda saklanmasını sağlar.

3. Araç setlerini sadeleştirin. Varsayılan araç setleri context, repos, issues, pull_requests ve users şeklindedir. Daha az araç, araç açıklamalarına daha az bağlam (context) harcanması demektir. Yerel sunucu ayrıca --read-only parametresi de alır; bu da yalnızca ön inceleme (triage) yapacak bir ajan için mantıklı bir başlangıçtır.

4. Küçük bir görevle test edin. "Bu depodaki bug etiketli açık issue'ları listele ve en eski üç tanesini özetle" komutu, belirtecin, sunucunun ve ajanın düzgün çalıştığını tek bir istemle doğrular.

0 dolarlık yol

İşte bugün hiçbir maliyet çıkarmayan kombinasyon: GitHub Free, hassas izinli bir belirteçle kullanılan barındırılan MCP sunucusu ve ücretsiz modellerinden biriyle çalışan OpenCode.

OpenCode'un ücretsiz sürümü herhangi bir giriş veya API anahtarı gerektirmez. 16 Ekim 2026'da gerçekleştirdiğimiz testte (npx opencode-ai@latest ile OpenCode 1.19.2), bir yazma ve çalıştırma görevi opencode/deepseek-v4.1-flash-free üzerinde 32 saniyede tamamlandı. OpenCode Zen dokümantasyonu, bu modelin glm-5.3-flash-free ve diğerleriyle birlikte şu anda ücretsiz olduğunu; sağlayıcısının veri saklamadığını (zero retention) ve verilerinizle eğitim yapmadığını belirtiyor. Aynı listedeki diğer ücretsiz modeller verilerinizi kullanabilir; bu nedenle bir modeli özel bir depoya yönlendirmeden önce açıklamaları mutlaka okuyun.

İşin açıkçası sınırlar şunlardır:

• Ücretsiz modeller tanıtım amaçlıdır. Zen, bunların çoğunu "sınırlı bir süre için" ücretsiz olarak nitelendiriyor. Kullandığınız modelin bir gün kaldırılabileceğini göz önünde bulundurun.
• Ücretsiz katman yalnızca OpenCode'a yanıt verir. Aynı uç noktayı bir betikten çağırmak HTTP 403 FreeTierError hatası döndürür.
• Actions dakikaları yine de harcanır. Ajan ücretsiz olsa da özel bir depoda tetiklediği CI sınırsız değildir.
• Claude Code ve Codex bu yönteme dahil değildir. Claude Code ücretli bir Claude planı veya API kredisi; Codex ise bir ChatGPT planı veya OpenAI API anahtarı gerektirir.

Sohbetten görev atamaya

Terminale "#142 numaralı sorunu çöz" yazmak tek bir kişi için işe yarayabilir. Ancak bir ekip için asıl faydalı adım, sorunu bir ajana atamak ve sonucun herkesin görebileceği bir yere iletilmesini sağlamaktır.

Sharkly'nin bunun için geliştirdiği gerçek bir GitHub entegrasyonu mevcuttur; ayrıntıları GitHub entegrasyon dokümantasyonunda bulabilirsiniz:

• Issue'lar Görevlere (Tasks) dönüşür. Bir Organizasyon Sahibi veya Yöneticisi GitHub Uygulamasını yükler ve depoları seçer. Bir depoyu bir Alanla (Space) ilişkilendirdiğinizde, yeni açılan issue'lar Görev olarak senkronize edilir. Mevcut issue'lar içe aktarılmaz. Tek yönlü senkronizasyon GitHub'dan Sharkly'ye doğru akar; ayrıca bir Alan tek bir iki yönlü depoya da sahip olabilir.
• Pull request'ler geri bağlanır. Dal (branch) adına, PR başlığına veya PR açıklamasına bir Görev Kimliği (Task ID) eklediğinizde Sharkly, PR'ı ilgili Görevle eşleştirmeye çalışır. Bir PR'ı merge etmek Görev durumunu değiştirmez; ancak senkronize edilmiş bir issue'yu kapatmak veya yeniden açmak durumu değiştirebilir.
• Görevi bir Ajan'a atayın. Ajan; Claude Code, Codex veya OpenCode'u kendi Bilgisayarınızda (Computer), her Görevi yalıtılmış bir git worktree içinde çalıştırır; ilerleme durumu ve sonuçlar Göreve geri aktarılır.

Önemli bir ayrıntı: GitHub Uygulaması Ajan'a doğrudan klonlama (clone) yetkisi vermez. Klonlama işlemi, Ajan veya Alan üzerinde depo olarak yapılandırılmış Bilgisayarın SSH anahtarını ya da HTTPS kimlik bilgilerini kullanmaya devam eder.

Peki bir Sharkly çalıştırması sırasında MCP sunucusu nasıl çalışır? Sharkly'nin dokümantasyonunda MCP'den bahsedilmiyor. Bizim çıkarımımız şu: Bir Ajan, ajan CLI'ını deponun worktree'sinde doğrudan başlattığı için, depoya commit edilmiş proje kapsamındaki bir .mcp.json dosyası (veya o Bilgisayardaki kullanıcı yapılandırması) çalışma sırasında yüklenmelidir. Sisteme tamamen güvenmeden önce küçük bir Görevle deneme (smoke test) yapın. Bir GitHub issue'sunu yapay zekâ ajanına atama rehberi bu iş akışını adım adım anlatırken, GitHub Agent HQ incelemesi GitHub'ın ajan atama konusundaki kendi yaklaşımını ele alıyor.

Pano, 5 kişiye kadar olan organizasyonlar için şu an ücretsizdir; Ajanlar ve Bilgisayarlar kullanıcı kotasından harcamaz ve model kullanımı kendi abonelikleriniz veya anahtarlarınız üzerinden gerçekleşir. Böylece issue aşamasından merge aşamasına kadar bağlamı, ilerlemeyi, engelleri, sonuçları ve insan incelemesini tek bir noktada toplayabilirsiniz.

Dikkat edilmesi gerekenler

• Ortak belirteç, ortak istek sınırı demektir. Yoğun çalışan bir ajanın diğerlerini engellemesini (throttle) önlemek için her ajana kendi hassas izinli belirtecini tanımlayın.
• Belirteci asla .mcp.json içine düz metin olarak yazmayın. Claude Code, .mcp.json başlıklarında ${VAR} formatını genişletebilir; bu yüzden depoya değişken adını commit edip asıl değeri Bilgisayarda tutun.
• Özel depolarda taslak PR'lar ücretli plan gerektirir. Free planında, ajandan bunun yerine başlığında "WIP" ifadesi bulunan normal PR'lar açmasını isteyin.
• Ajanın push işlemleri Actions dakikalarını tüketir. Artık geçerliliğini yitirmiş çalıştırmaları durdurmak için cancel-in-progress: true içeren bir concurrency grubu ekleyin.
• Copilot bulut ajanı araçları Free planında hata verir. Bu durum belirtecin bozuk olmasından değil, ücretli lisans zorunluluğundan kaynaklanır.

Sıkça Sorulan Sorular

GitHub ücretsiz mi? Evet. GitHub Free; sınırsız genel ve özel depo, sınırsız iş birlikçi, özel depolar için ayda 2.000 Actions dakikası ve 500 MB Packages depolama alanı sunar.

GitHub MCP sunucusu ücretsiz mi? Evet. GitHub, plan türüne bakılmaksızın tüm kullanıcılara açık olduğunu belirtmektedir. Copilot bulut ajanı gibi ücretli özelliklere bağlı araçlar ilgili aboneliği gerektirir.

GitHub'ın ücretsiz planı ajanlar için neleri içermez? Özel depolarda sınırsız Actions kullanımını, özel depolarda taslak pull request'leri ve code owners özelliğini ve Copilot bulut ajanını içermez.

GitHub üzerinde 0 dolara bir kodlama ajanı çalıştırabilir miyim? Evet; GitHub Free ve barındırılan MCP sunucusuyla birlikte OpenCode'u ücretsiz modellerinden birinde çalıştırarak bunu yapabilirsiniz. Ücretsiz modeller sınırlı süreli tanıtımlar olduğundan, zamanla model değiştirmeniz gerekebileceğini unutmayın. Farklı modeller arasındaki maliyet seçenekleri için ücretsiz ve ekonomik katmanlarda bir ajan ekibi çalıştırmanın maliyeti yazısına, birden fazla ajanın işini düzenli tutmak için ise Claude Code için proje yönetimi rehberine göz atabilirsiniz.