AI CodeOps

OpenAI Codex için AI CodeOps

AI CodeOps MCP sunucusunu Codex'e config.toml içinde ekleyin: Codex CLI veya IDE eklentisinden kapı denetimli yapay zekâ oturumları başlatın, bulguları okuyun, yayın kapısını kontrol edin.

Codex; bir CLI, bir IDE eklentisi, ChatGPT masaüstü uygulaması ve bulut biçimlerinde sunulan, OpenAI'ın 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. AI CodeOps MCP sunucusunu Codex'e ekleyin; Codex 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

AI CodeOps, kendi oturumlarında yapılan değişiklikleri kapıdan geçirir. Bir Codex bulut görevi bittiğinde ondan commit yapabilir veya pull request açabilirsiniz (Codex cloud); GitHub'da ise @codex review yazarak Codex'ten bir pull request'i incelemesini isteyebilirsiniz (GitHub'da Codex). Bu pull request'ler sıradan pull request'lerdir: AI CodeOps onları incelemez ve yayın kontrolü onları reddeder; çünkü onları bir AI CodeOps oturumu yapmamıştır.

İşi AI CodeOps kapılarından geçirmek için Codex'ten görevle bir AI CodeOps oturumu başlatmasını isteyin. Oturum değişikliği yazar, testlerinizi çalıştırır, birkaç ajanla inceler ve pull request'i ancak kapı geçildiğinde açar. Ya da merge öncesinde, Codex'ten veya CI'dan yayın kapısına sorun.

Codex'i 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. Codex'in 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. Anahtarı bir ortam değişkenine koyun; örneğin AICODEOPS_API_KEY.
  3. Sunucuyu ~/.codex/config.toml dosyasına ekleyin. Bir Streamable HTTP sunucusu için OpenAI'ın dokümantasyonu url ve bearer_token_env_var alanlarını listeler; ikincisi, değerini Codex'in Authorization başlığında gönderdiği değişkenin adıdır (Codex MCP dokümantasyonu):
    [mcp_servers.aicodeops]
    url = "https://console.aicodeops.dev/mcp"
    bearer_token_env_var = "AICODEOPS_API_KEY"

Sunucuyu tek bir repoyla sınırlamak için aynı tabloyu o projedeki .codex/config.toml dosyasına koyun; Codex proje dosyalarını yalnızca güvenilen projeler için okur. CLI, IDE eklentisi ve ChatGPT masaüstü uygulaması bu yapılandırmayı paylaşır; dolayısıyla tek bir kayıt üçünü de kapsar.

Codex neler yapabilir

AraçNe yapar
list_projectsÇalışma alanının projelerini ve repolarını listeler.
start_sessionBir projede bir görevle oturum başlatır. Bir workflow ve bir agent belirtebilirsiniz.
get_sessionBir oturumun durumu, adımları, açtığı pull request ve değişikliği.
check_release_gateBir pull request'in veya commit'in yayına alınıp alınamayacağı: engelleyici bulgular, başarısız testler ve diğer gerekçeler.
list_findingsGüvenlik ve kalite bulguları, en yeniden eskiye.
get_evidence_packBir değişikliğin imzalı kanıt paketi; değişikliğe veya oturuma göre.
list_buildsSon build'ler: her birini neyin başlattığı, branch'i ve commit'i ve nasıl sonuçlandığı.
get_buildTek 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. Codex'in başlattığı bir oturum pull request'ini diğer her oturum gibi açar; dolayısıyla onaylar ve yayın kapısı yine geçerlidir. Bkz. MCP sunucusu kılavuzu.

Codex'e sorabileceğiniz şeyler:

Use AI CodeOps to start a security-sensitive-change session on the payments project: rotate the webhook signing secret handling.
Poll that AI CodeOps session and summarize the findings when it's done.
Check the AI CodeOps release gate for commit 3f9c2ab and tell me why it's denied, if it is.

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

Yayın kontrolü bir HTTP API'sidir; dolayısıyla curl çalıştırabilen her CI sistemi merge öncesinde ona sorabilir:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $AICODEOPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"commitSHA\":\"$GIT_COMMIT\"}" > gate.json
jq -e '.allowed == true' gate.json

Bir pullRequestURL veya 7 ya da daha fazla karakterlik bir commitSHA gönderebilirsiniz. Yanıt 200 olur ve allowed alanını, bir özeti ve gerekçeleri içerir; kontrolün kendisi başarısız olursa allowed alanı false olur. Seçenekler arasında bir kapsam alt sınırı, zorunlu iş akışları, izin verilmeyen lisanslar ve zorunlu bir staging dağıtımı bulunur (API). Zorunlu bir kontrol olarak, hiçbir AI CodeOps oturumunun yapmadığı her değişikliği reddeder.

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 Codex 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. Git platformunuzu 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 config.toml dosyasına ekleyin.

Başka bir kodlama ajanı mı kullanıyorsunuz? Claude Code için AI CodeOps, Cursor veya GitHub Copilot sayfalarına bakın.

Sık sorulan sorular

AI CodeOps, Codex'in açtığı pull request'leri inceler mi?

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

Yapılandırma nereye yazılır?

Yapılandırma ~/.codex/config.toml dosyasına ya da güvenilen bir projedeki .codex/config.toml dosyasına yazılır. OpenAI'ın dokümantasyonu, Codex CLI'ın, IDE eklentisinin ve ChatGPT masaüstü uygulamasının bu yapılandırmayı paylaştığını söyler.

Codex API anahtarını nasıl gönderir?

bearer_token_env_var alanını, anahtarı tutan bir ortam değişkeninin adına ayarlayın. Codex anahtarı Authorization başlığında gönderir; böylece anahtar asla dosyada durmaz.

Codex, AI CodeOps oturumları başlatabilir mi?

Evet, kapsamında Start sessions from the MCP server izni bulunan bir anahtarla. Kapsamı olmayan bir anahtar yalnızca yedi okuma aracını kullanabilir.