- Ana sayfa
- Entegrasyonlar
- GitHub Copilot için 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
- 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ı. - Sunucuyu
.vscode/mcp.jsondosyasına ekleyin. VS Code'un biçimi birserversnesnesi kullanır; birinputskaydı 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}" } } } } - 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):
- GitHub'daki repoda Settings sayfasını açın. Code, planning, and automation altında Copilot, ardından MCP servers seçeneğini seçin.
- API anahtarını tutan
COPILOT_MCP_AICODEOPS_KEYadlı bir Agents secret'ı ekleyin. Yapılandırma yalnızca adıCOPILOT_MCP_ile başlayan secret'ları ve değişkenleri kullanabilir. - Ş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 yapar | Anahtarın ihtiyacı |
|---|---|---|
list_projects | Çalışma alanının projeleri ve repoları | workspace:read |
start_session | Bir projede bir görevle kapı denetimli bir oturum başlatır | workflow_run:manage |
get_session | Bir oturumun durumu, adımları, pull request'i ve değişikliği | workspace:read |
check_release_gate | Bir pull request'in veya commit'in yayına alınıp alınamayacağı, gerekçeleriyle | workspace:read |
list_findings | Önem derecesine veya kategoriye göre güvenlik ve kalite bulguları | workspace:read |
get_evidence_pack | Bir değişikliğin imzalı kanıt paketi | workspace:audit.read |
list_builds | Son build'ler, her birini neyin başlattığı ve nasıl sonuçlandığı | workspace:read |
get_build | Tek bir build: hangi adımda başarısız olduğu ve çıktısının sonu | workspace: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_sessionaracını düzenli aralıklarla sorgular. - Yalnızca çalışma alanı API anahtarları. OAuth ile giriş henüz desteklenmiyor.
Başlarken
- Ücretsiz bir hesap oluşturun: AI CodeOps açık beta aşamasındadır ve tarayıcınızda çalışır.
- GitHub'ı bağlayın ve hızlı başlangıcı kullanarak bir proje oluşturun.
- 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.