AI CodeOps

GitHub Copilot için AI CodeOps

GitHub Copilot'ı VS Code'da veya Copilot bulut ajanında AI CodeOps MCP sunucusuna bağlayın ve pull request'leri CI'ınızın çağırabildiği yayın kontrolüyle kapıdan geçirin.

GitHub Copilot; editörünüzde, pull request açan bir bulut ajanı (cloud agent) olarak ve GitHub'da bir inceleyici olarak çalışır. AI CodeOps, yapay zekâ ajanlarının bir değişikliği planladığı, yazdığı, test ettiği ve incelediği tarayıcı tabanlı bir platformdur; değişiklik ancak kalite kapıları geçildikten ve bir insan onayladıktan sonra pull request'e dönüşür. Copilot'ı AI CodeOps MCP sunucusuna bağlayın; Copilot bir görevi kapı denetimli bir AI CodeOps oturumuna devredebilir, bulgularını okuyabilir ve bir pull request'in yayına alınıp alınamayacağını sorabilir.

AI CodeOps neyi kapıdan geçirir, neyi geçirmez

AI CodeOps, kendi oturumlarında yapılan değişiklikleri kapıdan geçirir. Copilot bulut ajanı bir görev üzerinde çalışırken kendi branch'ine push eder ve bir pull request açar; GitHub'ın dokümantasyonu, ajanın reponun branch korumalarına ve zorunlu kontrollerine tabi olduğunu ve kendi pull request'ini onaylayamayacağını veya merge edemeyeceğini söyler (riskler ve önlemler). Bu pull request bir AI CodeOps değişikliği değildir: AI CodeOps onu incelemez ve yayın kontrolü onu reddeder; çünkü onu bir AI CodeOps oturumu yapmamıştır.

İşi AI CodeOps kapılarından geçirmek için Copilot'a görevle bir AI CodeOps oturumu başlattırın ya da oturumu AI CodeOps'ta kendiniz başlatın. Oturum değişikliği yazar, testlerinizi çalıştırır, birkaç ajanla inceler ve pull request'i ancak kapı geçildiğinde bir codeops/run-<id> branch'inde açar (GitHub için AI CodeOps).

Copilot'ı VS Code'da bağlayın

  1. AI CodeOps'ta Configure → API Keys altında bir çalışma alanı API anahtarı oluşturun. Anahtar sk- ile başlar ve yalnızca bir kez gösterilir. Copilot'ın oturum başlatabilmesi için anahtarda Scope seçeneğini seçin ve Start sessions from the MCP server (/mcp) kutusunu işaretleyin. Bkz. API anahtarları.
  2. Sunucuyu .vscode/mcp.json dosyasına ekleyin. VS Code'un biçimi bir servers nesnesi kullanır; bir inputs kaydı ise anahtarı sorar, böylece anahtar asla dosyaya yazılmaz (VS Code MCP yapılandırması):
    {
      "inputs": [
        { "type": "promptString", "id": "aicodeops-key", "description": "AI CodeOps API key", "password": true }
      ],
      "servers": {
        "aicodeops": {
          "type": "http",
          "url": "https://console.aicodeops.dev/mcp",
          "headers": { "Authorization": "Bearer ${input:aicodeops-key}" }
        }
      }
    }
  3. Sunucuyu VS Code'dan başlatın; VS Code anahtarı sorar. Ardından Copilot'ı agent modunda kullanın. Copilot dokuz AI CodeOps aracını çağırabilir.

Copilot bulut ajanını bağlayın

Bulut ajanı, MCP yapılandırmasını reponun ayarlarından okur (bulut ajanını MCP ile genişletme):

  1. GitHub'daki repoda Settings sayfasını açın. Code, planning, and automation altında Copilot, ardından MCP servers seçeneğini seçin.
  2. API anahtarını tutan COPILOT_MCP_AICODEOPS_KEY adlı bir Agents secret'ı ekleyin. Yapılandırma yalnızca adı COPILOT_MCP_ ile başlayan secret'ları ve değişkenleri kullanabilir.
  3. Şunu MCP configuration alanına yapıştırın ve Save MCP configuration düğmesini seçin:
    {
      "mcpServers": {
        "aicodeops": {
          "type": "http",
          "url": "https://console.aicodeops.dev/mcp",
          "headers": { "Authorization": "Bearer $COPILOT_MCP_AICODEOPS_KEY" },
          "tools": ["list_projects", "get_session", "check_release_gate", "list_findings"]
        }
      }
    }

GitHub'ın dokümantasyonu, başlıklar dahil bu yapılandırmadaki dize alanlarının COPILOT_MCP_ secret'larına $NAME veya ${NAME} ile başvurabildiğini söyler. tools listesi zorunludur; örnek yalnızca okuma araçlarına izin verir, dolayısıyla bulut ajanı kapıyı kontrol edebilir ve bulguları okuyabilir ama oturum başlatamaz. GitHub'ın dokümantasyonu ayrıca Copilot code review özelliğinin bir incelemeye bağlam çekmek için MCP sunucularını kullanabildiğini söyler (code review).

Araçlar ne yapar

AraçNe yaparAnahtarın ihtiyacı
list_projectsÇalışma alanının projeleri ve repolarıworkspace:read
start_sessionBir projede bir görevle kapı denetimli bir oturum başlatırworkflow_run:manage
get_sessionBir oturumun durumu, adımları, pull request'i ve değişikliğiworkspace:read
check_release_gateBir pull request'in veya commit'in yayına alınıp alınamayacağı, gerekçeleriyleworkspace:read
list_findingsÖnem derecesine veya kategoriye göre güvenlik ve kalite bulgularıworkspace:read
get_evidence_packBir değişikliğin imzalı kanıt paketiworkspace:audit.read
list_buildsSon build'ler, her birini neyin başlattığı ve nasıl sonuçlandığıworkspace:read
get_buildTek bir build: hangi adımda başarısız olduğu ve çıktısının sonuworkspace:read
list_saved_buildsÇalışma alanının sakladığı build'ler ve her birini neyin başlattığıworkspace:read

Her araç, konsolda olduğu gibi, anahtarı oluşturan kişi olarak ve o kişinin rolü ve bütçesiyle hareket eder (MCP sunucusu kılavuzu).

Merge işlemlerini CI'da kapıdan geçirin

GitHub Actions iş akışınız yayın kapısına doğrudan sorabilir ve kapı pull request'i reddettiğinde başarısız olabilir:

- name: Ask the AI CodeOps release gate
  env:
    AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
    PR_URL: ${{ github.event.pull_request.html_url }}
  run: |
    curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
      -H "Authorization: Bearer $AICODEOPS_API_KEY" \
      -H "Content-Type: application/json" \
      -d "{\"pullRequestURL\":\"$PR_URL\"}" > gate.json
    jq -r '.summary' gate.json
    jq -e '.allowed == true' gate.json

İşi branch korumasında zorunlu bir durum kontrolü (required status check) yapın; böylece bir pull request ancak izin veren bir kararla merge edilir. Buna Copilot bulut ajanından gelen pull request'ler de dahildir; kapı bunları reddeder, çünkü onları bir AI CodeOps oturumu yapmamıştır. Bunu, merge'e giden yolun AI CodeOps olması gereken branch'lerde kullanın. Kapsam alt sınırı ve izin verilmeyen lisanslar dahil alanlar API sayfasındadır.

Sınırlar

  • Tek bir adresten dakikada 120 MCP isteği; çalışma alanı başına dakikada 60 yayın kontrolü.
  • Sunucu durumsuzdur (stateless) ve bildirim göndermez; bu yüzden Copilot bir oturumu izlemek için get_session aracını düzenli aralıklarla sorgular.
  • Yalnızca çalışma alanı API anahtarları. OAuth ile giriş henüz desteklenmiyor.

Başlarken

  1. Ücretsiz bir hesap oluşturun: AI CodeOps açık beta aşamasındadır ve tarayıcınızda çalışır.
  2. GitHub'ı bağlayın ve hızlı başlangıcı kullanarak bir proje oluşturun.
  3. Bir API anahtarı oluşturun ve sunucuyu yukarıdaki gibi VS Code'a veya bulut ajanına ekleyin.

Birleştirmek yerine karşılaştırıyor musunuz? AI CodeOps ve GitHub Copilot code review karşılaştırması ile AI CodeOps ve GitHub Copilot coding agent karşılaştırması sayfalarını okuyun.

Sık sorulan sorular

AI CodeOps, Copilot bulut ajanının açtığı pull request'leri inceler mi?

Hayır. AI CodeOps, kendi oturumlarında yapılan değişiklikleri kapıdan geçirir. Bir Copilot pull request'i AI CodeOps tarafından incelenmez ve yayın kontrolü onu reddeder; çünkü onu bir AI CodeOps oturumu yapmamıştır.

Copilot bulut ajanı için MCP'yi nerede yapılandırırım?

Reponun Settings sayfasında, Copilot ve ardından MCP servers altında. Yapılandırmanın kullandığı secret'lar, adı COPILOT_MCP_ ile başlayan Agents secret'ları olmalıdır.

Bulut ajanı hangi AI CodeOps araçlarını almalı?

Bulut ajanının yapılandırması bir araç izin listesi alır. check_release_gate ve list_findings gibi okuma araçlarıyla başlayın; start_session aracını yalnızca Copilot'ın görevleri AI CodeOps'a devretmesini istiyorsanız ekleyin.

AI CodeOps sunucusu OAuth gerektirir mi?

Hayır. Authorization Bearer başlığında bir çalışma alanı API anahtarı alır; hem VS Code hem de Copilot bulut ajanı bunu destekler. GitHub, bulut ajanının OAuth kullanan uzak sunucuları desteklemediğini söylüyor.