Kendi yapay zekâ ajanınızla geliştirme

Claude Code, Codex veya başka bir MCP istemcisini Lunex’e bağlayarak projelerinizi bir yapay zekâ ajanıyla geliştirebilirsiniz. Lunex kendi araçlarını web arayüzüyle aynı adreste /mcp yolunda sunar. Ajan kendi Lunex hesabınızla oturum açar ve sizin kimliğiniz ile rolünüzle çalışır; sizin yapamadığınız bir işlemi ajan da yapamaz.

Kimler kullanabilir

Ajanla geliştirme için platform-developer rolü gerekir ve yalnız geliştirme kurulumunda yapılır; üretim kurulumunda /mcp adresi bulunmaz. Ajan sizin hesabınızla çalıştığı için yaptığı her commit ve çalıştırma sizin adınıza kaydedilir.

Git ve test sistemlerine erişim

Ajan değişiklikleri Lunex’in arayüzünden değil, bilgisayarınızdaki depo klonu üzerinden yapar ve Git’e push eder. Bunun için entegrasyon deposuna yazma erişiminiz olmalıdır: platform-developer rolündeki kullanıcı Gitea’da developers takımına alınır, Gitea’da kişisel erişim belirteci oluşturur ve HTTPS ile push eder. Adımlar ve ağ koşulları kurulum rehberinin dev ve prod bölümünde anlatılır; commit ve push kavramları için Git rehberine bakın. create_project aracı yanıtında deponun klon adresini cloneUrl alanında döner; kurulum geliştiricilerin erişebileceği bir Git adresi yayımlamıyorsa bu alan boştur ve adresi yöneticinizden istemeniz gerekir.

Mevcut SAP bağlantıları ayrı bir araçla listelenmez: diğer projelerin YAML dosyalarındaki #class:io.etzel.lunex.sap.SapJcoDestination tipli bean’lerdir ve ajan bunları klonda arayarak bulur. Kurulumda henüz hiç SAP bağlantısı yoksa ajan ilk bean’i SAP bağlantısı rehberindeki Destination oluşturun adımlarına ve örnek YAML’a göre yazar; rehbere read_help ile tr/connections/sap sayfasından ulaşır. Bağlantı Secret’larını ajan oluşturamaz ve kimlik bilgileri ajana verilmez: Secret’ı platform-admin rolündeki bir yönetici System → Secrets içinde oluşturur, ajan da anahtarlarını list_connection_references ile görür.

Veriyle tetiklenen akışlarda — veritabanı sorgulama, kuyruk tüketme — ajanın kabul örnekleri için test verisi oluşturması gerekir. Bu yüzden bilgisayarınız test veritabanına veya mesaj sunucusuna da erişebilmelidir; yalnız Lunex’in erişmesi yetmez.

Ajanı bağlama

Her iki istemcide de sunucu adı lunex, adres kurulumunuzun adresi + /mcp, istemci kimliği lunex-agent’tır. Tarayıcıda Lunex hesabınızla bir kez oturum açarsınız; istemci yenileme belirtecini saklar.

Claude Code:

claude mcp add --transport http --client-id lunex-agent lunex https://<lunex-adresi>/mcp
claude mcp login lunex            # veya oturum içinde /mcp

Codex:

codex mcp add lunex --url https://<lunex-adresi>/mcp --oauth-client-id lunex-agent
codex mcp login lunex

Kurulum kendi sertifika otoritesini kullanıyorsa Claude Code için NODE_EXTRA_CA_CERTS=<ca.crt>, Codex için sistem kökleriyle CA’yı birleştiren bir dosyaya SSL_CERT_FILE gerekir.

Bir geliştirme oturumu

Ajana ihtiyacı ve beklediğiniz sonuçları söyleyin: hangi girdi hangi sonucu üretmeli, hata durumunda ne dönmeli. Bu beklenenler projenin acceptance.md dosyasına “girdi → beklenen sonuç” satırları olarak yazılır; ajan da değişiklikle birlikte bu dosyayı günceller.

Ajan dosyaları klonda düzenler, push eder ve pull_and_run_project ile projeyi geliştirme runtime’ında çalıştırır; API işlemlerini call_api_operation ile canlı dener ve her kabul örneğinin sonucunu bildirir.

Sonucu siz değerlendirirsiniz:

İnceleme: değişikliği projenin Commits sekmesinde commit olarak, veya Pull sonrasında designer’da görsel olarak inceleyin.
Yayımlama: kabul ettiğiniz sürümü Build → Create release → Deploy ile paketleyip dağıtın; akış sürüm rehberinde anlatılır.
Reddetme: istenmeyen değişikliği geri alan bir revert commit isteyin veya kendiniz yapın. Push edilmiş commit’ler tarihçeden silinmez.

AGENTS.md ve takım kuralları

Lunex, entegrasyon deposunun kökündeki AGENTS.md dosyasında kendi işaretleyicileri arasında bir kural bloğu tutar: proje düzeni, secret referansları, acceptance.md ve oturum döngüsü burada ajana anlatılır. Bu bloğu Lunex her başlangıçta günceller; elle değiştirmeyin. Takımınızın kendi kuralları blokun dışına, aynı dosyaya yazılır.

Claude Code AGENTS.md’yi kendiliğinden okumaz. Lunex bu yüzden depoda CLAUDE.md yoksa @AGENTS.md satırını içeren bir CLAUDE.md oluşturur. Takımınız kendi CLAUDE.md dosyasını tutuyorsa içine @AGENTS.md satırını ekleyin; yoksa Claude Code Lunex’in kurallarını görmez.

Projenin Camel araçlarına erişim

Run ile başlatılan geliştirme podunda Camel’in kendi MCP sunucusu çalışır. Ajan bu sunucuya Lunex üzerinden şu adresle bağlanır (aynı lunex-agent istemcisiyle):

https://<lunex-adresi>/mcp/projects/<proje-id>

Lunex isteği projenin geliştirme runtime’ındaki Camel MCP sunucusuna iletir. Camel’in araçları değiştirilmeden geçer; Lunex araç eklemez, çıkarmaz veya sarmalamaz. Örnekler:

Araç	Kullanım
`get_routes`, `get_errors`, `get_history`	Route durumunu, hatalı dosya ve satırı, mesaj geçmişini okuma.
`trace_control`	Trace’i açıp kapatma.
`eval_expression`	Çalışan runtime’da bir ifadeyi değerlendirme.
`execute_sql`, `get_datasources`	Route’un DataSource’u üzerinden SQL çalıştırma.
`send_message`	Bir endpoint’e mesaj gönderme. Yanıt gövdesi dönmez; API işlemini yanıtıyla denemek için Lunex’in `call_api_operation` aracını kullanın.

Erişim için platform-developer rolü gerekir. Bu adres yalnız geliştirme kurulumlarında vardır; üretim kurulumunda Camel MCP ve bu adres bulunmaz. Paketlenmiş (Build ile dağıtılmış) podlara bu yoldan bağlanılmaz.

Projenin çalışan bir Run podu yoksa adres 503 döner ve yanıtta pull_and_run_project aracını belirtir. Ajan bu Lunex aracıyla projeyi Git’ten çekip çalıştırır, ardından yeniden bağlanır.

Yeni pod sonrası yeniden bağlanma

Camel MCP oturumu podun belleğinde tutulur:

Olay	Oturum
Reload	Aynı JVM çalışmaya devam eder; oturum da geçerli kalır.
Yeni pod: pod sonlandıktan veya Delete container sonrasında Run	Eski oturum sona erer. İstemci bağlantıyı yeniden başlatmalıdır (MCP `initialize`).
Başlangıç hatası	JVM kapanır, MCP sunucusu kalmaz. Nedeni Lunex’in proje durumu ve Log’undan okuyun, düzeltip yeniden çalıştırın.

Ajan eski oturumla hata alırsa önce projenin çalıştığını doğrulayın, sonra istemcide MCP bağlantısını yenileyin.

Bağımsız camel mcp

Camel JBang’in camel mcp komutu Camel MCP araçlarını kendi bilgisayarınızda, Lunex’ten bağımsız olarak çalıştırır. Bu sunucu Lunex’teki geliştirme podunu göremez; çalışan bir proje gerektirmeyen işler içindir. Örneğin bileşen kataloğunu sorgulamak veya kaynak dosyalarını commit etmeden önce camel validate ile şemaya göre doğrulamak. Lunex bu komut için ayrıca bir şey sağlamaz; Camel JBang’i kendi bilgisayarınıza kurarsınız.

Bir Lunex projesini bilgisayarınızda camel run ile başlatmayın gerekmedikçe; başlatıyorsanız camel.kubernetes-config.local-mode=true ayarını ekleyin. Bu ayar olmadan proje, Secret değerlerini geçerli kube bağlamınızdan okumaya çalışır.