‍Genel Bakış

GitHub MCP, uygulamanız ile GitHub arasında güvenli ve yapılandırılmış bir entegrasyon sağlar. Böylece yapay zeka tabanlı uygulamalarınız GitHub verilerini (commit listesi, kullanıcı aramaları, repository bilgileri vb.) MCP aracılığıyla kullanabilir.

Configuration Manager Üzerinden Ayarların Yapılması

Oluşturulmuş bir konfigürasyon ayarı sadece bir projede kullanılabilir. Başka projelerde kullanılmak istendiğinde aynı ayarların yeniden oluşturulması gerekmektedir.

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi seçin.
3. Configuration Manager → App Settings sekmesine gidin.

4. MCP → GitHub bölümünden ADD NEW seçeneğini tıklayın.
5. Açılan pencerede:
   
   • Name: Bu entegrasyona verilecek ayırt edici ad.
   • Access Token: GitHub üzerinde oluşturulan Personal Access Token (PAT).

GitHub Access Token Oluşturma

1. GitHub hesabınıza giriş yapın (https://github.com).

2. Sağ üstten Settings → Developer Settings → Personal Access Tokens → Tokens (classic) yolunu izleyin.

3. Generate new token → Generate new token (classic) seçeneğini tıklayın.

4. Gerekli alanları doldurun:
   
   • Note: Token için açıklama girin (örn: MCP Server Access).
   • Expiration: Süre seçin (30 gün, 90 gün veya No expiration).
   • Scopes (izinler):
     
     • repo → Depolara erişim
     • read:org → Organizasyon bilgileri
     • workflow → İş akışları
     • admin:repo_hook → Webhook yönetimi

5. Generate token butonuna tıklayın.

6. Token sadece bir kez görüntülenir → Copy ile kopyalayın ve Kuika’daki GitHub Settings alanına yapıştırın.

Action Türleri

GitHub Commit List

‍

Belirli bir repository üzerindeki commit listesini getirir.

Action Input

• settings: Config Manager’da tanımladığınız GitHub ayarı.
• author: Commit’i yapan kişi.
• owner: Repository sahibi / organizasyon adı.
• repo: Repository adı.
• sha: Commit’in benzersiz kimliği (SHA-1 hash).
• page: Getirilecek sayfa numarası.
• perPage: Sayfa başına öğe sayısı.

Action Output

Commit arama sonucunda aşağıdaki alanlar döner:

• author → Commit’i yapan kullanıcı bilgisi (login, id, avatar, url vb.)
• committer → Commit’i repository’ye gönderen kullanıcı bilgisi (yazan kişiden farklı olabilir)
• commit → Commit detayları (author, committer, message, tarih, tree, verification)
• sha → Commit’in benzersiz kimliği
• html_url → Commit’in GitHub web linki
• comments_url → Commit yorum linki

• url → API üzerinden commit detayları
• node_id → GitHub GraphQL iç kimliği
• parents → Üst commit listesi (merge commit’lerde birden fazla olabilir)
  
  

Önemli Alt Alanlar:

• commit.message → Commit mesajı
• commit.author → İsim, e-posta, tarih
• commit.committer → Gönderen kişi bilgisi (isim, e-posta, tarih)
• verification.verified → Commit imzalanmış mı?
• verification.reason → Doğrulama sonucu nedeni
• verification.signature → İmza bilgisi (PGP/GPG)

GitHub Search Users

GitHub üzerinde kullanıcı araması yapar.

Action Input

• settings: GitHub ayarı.
• query: Arama ifadesi (örn: "john smith", "location:seattle", "followers:>100").
• page: Hangi sayfayı getireceği.
• perPage: Sayfa başına sonuç sayısı.

Action Output

• total_count: Arama sonucundaki toplam kullanıcı sayısı.
• incomplete_results: Boolean → arama tamamlandı mı?
• items: Kullanıcıların listesi.
  
  • login → Kullanıcı adı
  • id → Kullanıcı ID’si
  • avatar_url → Profil resmi URL’si
  • html_url (veya profile_url) → GitHub profil linki
  • type → Kullanıcı türü (User / Organization)

Kuika’da Kullanım

Configuration Manager’da oluşturulan GitHub ayarları, projedeki GitHub Action içinde settings parametresine bağlanarak kullanılabilir.

Örneğin:

• "kuika/platform-core" repository’sinin commit geçmişini listelemek,
• "location:turkey followers:>50" kriterine göre kullanıcı aramak mümkündür.