- Ana sayfa
- Entegrasyonlar
- Claude Code için AI CodeOps
Claude Code için AI CodeOps
Claude Code'u AI CodeOps MCP sunucusuna bağlayın: terminalinizden görevleri kapı denetimli oturumlara devredin, merge öncesi yayın kapısını kontrol edin, bulguları okuyun.
Claude Code, terminalinizde çalıştırdığınız bir kodlama ajanıdı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. İkisini AI CodeOps MCP sunucusu üzerinden bağlayın; Claude Code bir görevi kapı denetimli bir AI CodeOps oturumuna devredebilir, oturumu izleyebilir, 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
Herhangi bir şey kurmadan önce bu konuda net olun. AI CodeOps, kendi oturumlarında yapılan değişiklikleri kapıdan geçirir. Claude Code'un terminalinizden veya Claude Code GitHub Actions üzerinden kendi başına açtığı bir pull request sıradan bir pull request'tir: AI CodeOps onu incelemez ve yayın kontrolü onu "No workflow runs found for …" mesajıyla reddeder; çünkü onu bir AI CodeOps oturumu yapmamıştır.
Dolayısıyla Claude Code'un işini kapılardan geçirmenin iki yolu vardır:
- Görevi devredin. Claude Code'dan
start_sessionaracını görevle birlikte çağırın. Bir AI CodeOps oturumu değişikliği yazar, testlerinizi çalıştırır, birkaç ajanla inceler ve pull request'i ancak kapı geçildiğinde açar. - Merge etmeden önce kontrol edin. Bir pull request'i
check_release_gatearacına sorun veya aynı kontrolü CI'da çalıştırın; böylece izin veren bir karar olmadan hiçbir şey merge edilmez.
Claude Code'u 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. Claude Code'un oturum başlatabilmesi için anahtarda Scope seçeneğini seçin ve Start sessions from the MCP server (/mcp) kutusunu işaretleyin. Kanıt paketlerini de istiyorsanız Evidence packs from the MCP server (/mcp) kutusunu da işaretleyin. Bkz. API anahtarları. - Sunucuyu ekleyin. Claude Code'un MCP dokümantasyonu, başlığı olan uzak bir HTTP sunucusu için şu biçimi verir:
claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \ --header "Authorization: Bearer sk-..." - Claude Code'da
/mcpkomutunu çalıştırın.aicodeops, dokuz araçla birlikte bağlı olarak listelenir.
Varsayılan olarak sunucu yalnızca sizin için ve yalnızca geçerli projede eklenir. Ekibinizle paylaşmak için --scope project ekleyin: Claude Code sunucuyu repo kökündeki .mcp.json dosyasına yazar. Claude Code bu dosyadaki ortam değişkenlerini açar; böylece anahtar sürüm kontrolünün dışında kalır:
{
"mcpServers": {
"aicodeops": {
"type": "http",
"url": "https://console.aicodeops.dev/mcp",
"headers": { "Authorization": "Bearer ${AICODEOPS_API_KEY}" }
}
}
}
Claude Code neler yapabilir
| Araç | Ne yapar |
|---|---|
list_projects | Çalışma alanının projelerini ve repolarını listeler. |
start_session | Bir projede bir görevle oturum başlatır; varsayılan olarak plan-build-review-test iş akışıyla. |
get_session | Bir oturumun durumu, adımları, açtığı pull request ve değişikliği. |
check_release_gate | Bir pull request'in veya commit'in yayına alınıp alınamayacağı, gerekçeleriyle birlikte. |
list_findings | Önem derecesine veya kategoriye göre filtrelenmiş güvenlik ve kalite bulguları. |
get_evidence_pack | Bir değişikliğin imzalı kanıt paketi. |
list_builds | Son build'ler: her birini neyin başlattığı, branch'i ve commit'i ve nasıl sonuçlandığı. |
get_build | Tek bir build: hangi adımda başarısız olduğu ve çıktısının sonu. |
list_saved_builds | Çalışma alanının sakladığı build'ler ve her birini neyin başlattığı. |
Her araç, anahtarı oluşturan kişi olarak ve konsolla aynı kontrollerden geçerek çalışır: o kişinin rolü, çalışma alanı bütçesi ve ajanın devam eden iş limiti. Claude Code'dan başlatılan bir oturum pull request'ini diğer her oturum gibi açar; dolayısıyla onaylar ve yayın kapısı yine geçerlidir. Tam referans MCP sunucusu kılavuzundadır.
Bağlandıktan sonra Claude Code'a sorabileceğiniz şeyler:
List my AI CodeOps projects, then start a session on the api project to add rate limiting to the login route.
Check on that session until it finishes, and tell me what the reviewers found.
Ask the AI CodeOps release gate whether https://github.com/acme/api/pull/42 may ship, and list the reasons.
Merge işlemlerini CI'da kapıdan geçirin
Yayın kontrolü aynı zamanda bir HTTP API'sidir; dolayısıyla CI aynı soruyu merge öncesinde sorabilir. Şu GitHub Actions işi, kapı pull request'i reddettiğinde başarısız olur:
name: AI CodeOps release gate
on: pull_request
jobs:
gate:
runs-on: ubuntu-latest
steps:
- name: Ask the 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
Uç nokta 200 ile yanıt verir; yanıtta true veya false olarak ayarlanmış allowed alanı, bir özet ve gerekçeler bulunur. Bir kapsam alt sınırı, zorunlu iş akışları, izin verilmeyen lisanslar ve zorunlu bir staging dağıtımı ekleyebilirsiniz; alanlar API sayfasındadır. Zorunlu bir kontrol olarak ne anlama geldiğini unutmayın: Claude Code'un kendi başına açtığı dahil, hiçbir AI CodeOps oturumunun yapmadığı bir pull request reddedilir.
Sınırlar
- Tek bir adresten dakikada 120 MCP isteği; CI kontrolü çalışma alanı başına dakikada 60 isteğe izin verir.
- MCP sunucusu durumsuzdur (stateless) ve bildirim göndermez; bu yüzden Claude Code 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.
- Git platformunuzu bağlayın ve hızlı başlangıcı kullanarak bir proje oluşturun.
- Bir API anahtarı oluşturun ve sunucuyu yukarıdaki gibi Claude Code'a ekleyin.
Başka bir kodlama ajanı mı kullanıyorsunuz? Codex için AI CodeOps, Cursor veya GitHub Copilot sayfalarına bakın. AI CodeOps oturumlarının sizin MCP sunucularınızı çağırdığı diğer yön için AI CodeOps ve MCP sayfasına bakın.
Sık sorulan sorular
AI CodeOps, Claude Code'un açtığı pull request'leri inceler mi?
Hayır. AI CodeOps, kendi oturumlarının yaptığı değişiklikleri kapıdan geçirir. Claude Code'un kendi başına açtığı bir pull request incelenmez ve yayın kontrolü onu reddeder; çünkü onu bir oturum yapmamıştır. İşi kapıdan geçirmek için görevi Claude Code'dan bir AI CodeOps oturumuna devredin.
Claude Code, AI CodeOps'a nasıl giriş yapar?
Bearer başlığı olarak gönderilen bir çalışma alanı API anahtarıyla. Anahtar, onu oluşturan üye olarak ve o üyenin rolü ve bütçesiyle hareket eder. OAuth ile giriş henüz desteklenmiyor.
Claude Code bana sormadan oturum başlatabilir mi?
Yalnızca kapsamında Start sessions from the MCP server izni bulunan bir anahtarla. Kapsamı olmayan bir anahtar yedi okuma aracını kullanabilir, daha fazlasını değil.
Kurulumu ekibimle paylaşabilir miyim?
Evet. Sunucuyu --scope project ile ekleyin; Claude Code onu repodaki .mcp.json dosyasına yazar. Anahtarın kendisini dosyada değil, bir ortam değişkeninde tutun.