- Ana sayfa
- Dokümantasyon
- AI CodeOps MCP sunucusu
AI CodeOps MCP sunucusu
Son güncelleme
Claude Code, Cursor veya herhangi bir MCP istemcisini AI CodeOps'a bağlayın: editörünüzden oturum başlatın, bulguları okuyun, yayın kapısını kontrol edin ve kanıt paketlerini getirin.
AI CodeOps uzak bir MCP sunucusu çalıştırır; böylece hâlihazırda kullandığınız yapay zekâ kodlama aracı çalışma alanınızla çalışabilir: editörünüzden bir oturum başlatın, onu izleyin, bir pull request'in yayına alınıp alınamayacağını kontrol edin ve bir değişikliğin imzalı kaydını alın.
Bu, AI CodeOps'un oturumlarınızdaki ajanların araçlarını kullanabilmesi için başka sunuculara bağlandığı MCP sunucuları sayfasından ayrıdır. Burada sunucu AI CodeOps'tur.
Bağlanın
Bir çalışma alanı API anahtarına ihtiyacınız vardır. Configure → API Keys altında bir tane oluşturun; sk- ile başlar ve yalnızca bir kez gösterilir. Bkz. API anahtarları.
Claude Code:
claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \
--header "Authorization: Bearer sk-..."
Ardından Claude Code'da /mcp komutunu çalıştırın: aicodeops, dokuz aracıyla birlikte bağlı olarak listelenir.
Cursor, .cursor/mcp.json dosyasında:
{
"mcpServers": {
"aicodeops": {
"url": "https://console.aicodeops.dev/mcp",
"headers": { "Authorization": "Bearer sk-..." }
}
}
}
Diğer her istemci: adres https://console.aicodeops.dev/mcp, aktarım Streamable HTTP'dir ve anahtar Authorization: Bearer başlığında gönderilir.
Anahtarı commit ettiğiniz dosyaların dışında tutun: çoğu istemci onu bir ortam değişkeninden okur.
Sunucuları açıklamalarından keşfeden bir istemci veya kayıt defteri, bu sunucunun açıklamasını https://console.aicodeops.dev/server.json adresinde (ayrıca /.well-known/mcp/server.json adresinde) okuyabilir. Anahtar gerektirmez ve adresi, aktarımı ve anahtarın gönderildiği başlığı listeler.
Araçlar
| Araç | Ne yapar | Anahtarın ihtiyacı |
|---|---|---|
list_projects | Çalışma alanının projelerini ve repolarını listeler. | workspace:read |
start_session | Bir projede bir görevle oturum başlatır. İsteğe bağlı: bir workflow (varsayılan plan-build-review-test) ve bir agent. | workflow_run:manage |
get_session | Bir oturumun durumu, adımları, açtığı pull request 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 birlikte. API ile aynı kontrol. | workspace:read |
list_findings | severity veya category ile filtrelenmiş güvenlik ve kalite bulguları. | workspace:read |
get_evidence_pack | Bir değişikliğin imzalı kanıt paketi; changeID ile veya onu başlatan oturumla. | workspace:audit.read |
list_builds | Son build'ler: her birini neyin başlattığı (bir kişi, kayıtlı bir build, bir push, bir pull request, bir zamanlama), branch'i ve commit'i ve nasıl sonuçlandığı. | workspace:read |
get_build | Tek bir build: neden başarısız olduğunu görmek için hangi adımda başarısız olduğu ve çıktısının sonu. | workspace:read |
list_saved_builds | Bir reponun build dosyasından gelenler dahil, çalışma alanının sakladığı build'ler ve her birini neyin başlattığı. | workspace:read |
Anahtarın kullanamayacağı bir araç, nedenini söyleyen bir hatayla yanıt verir ve diğer araçlar çalışmaya devam eder. start_session ve get_evidence_pack araçları için ayrıca izinlerinin anahtarın kapsamında listelenmesi gerekir (aşağıya bakın).
Bir araç neler yapabilir
Her araç, anahtarı oluşturan kişi olarak ve konsolla aynı kontrollerden geçerek çalışır:
- Roller: konsolda oturum başlatamayan bir üye burada da başlatamaz. Viewer rolündeki birinin anahtarı okuyabilir, daha fazlasını yapamaz.
- Anahtar kapsamı: kapsamı olmayan ya da kapsamında Release gate check from CI, and read-only MCP tools listelenen bir anahtar yedi okuma aracını kullanabilir.
start_sessionveget_evidence_packyalnızca kapsamında ilgili izin listelenen bir anahtarla çalışır: Configure → API Keys altında anahtarda Scope seçeneğini seçin ve Start sessions from the MCP server (/mcp) veya Evidence packs from the MCP server (/mcp) kutusunu işaretleyin; okuma araçlarının çalışmaya devam etmesi için Release gate check from CI, and read-only MCP tools kutusunu da işaretli bırakın. Kapsamı olmayan bir anahtar burada oturum başlatamaz; dolayısıyla CI veya model gateway için önceden oluşturulmuş anahtarlar bunu kendiliğinden kazanmaz. Anahtar kapsamı sınırlama planınıza bağlıdır. - Harcama: oturumlar, konsolda olduğu gibi çalışma alanının bütçesine ve ajanın devam eden iş limitine sayılır.
- Denetim: bir oturum onu kimin başlattığını, yani anahtarı oluşturan kişiyi kaydeder. Bir kanıt paketinin dışa aktarılması denetim günlüğüne kaydedilir.
Buradan başlatılan bir oturum pull request'ini diğer her oturum gibi açar; dolayısıyla merge edilmeden önce onaylarınız ve yayın kapısı yine geçerlidir.
Sınırlar
- Tek bir adresten dakikada 120 istek.
- Durumsuz (stateless): her istek tek başınadır. Sunucu bildirim göndermez ve olay akışı açmaz.
- Yalnızca çalışma alanı API anahtarları. OAuth ile giriş henüz desteklenmiyor.
Sık sorulan sorular
MCP sunucusu nasıl giriş yapar?
Bearer token olarak gönderilen bir çalışma alanı API anahtarıyla. Anahtar, onu oluşturan üye olarak ve o üyenin güncel rolüyle hareket eder. OAuth ile giriş henüz desteklenmiyor.
MCP sunucusu kodumu doğrudan değiştirebilir mi?
Hayır. start_session bir oturum başlatır ve oturum konsoldaki gibi çalışır; yani onaylarınızın ve yayın kapınızın yine uygulandığı bir pull request üzerinden. Diğer tüm araçlar yalnızca okur.
Hangi istemciler çalışır?
Claude Code ve Cursor dahil, Streamable HTTP aktarımını ve özel bir başlığı destekleyen her MCP istemcisi.