Bağlantılar

Worun'u Codex ve Claude'a bağlayın

MCP bağlantısıyla Codex veya Claude, izin verdiğiniz organizasyondaki projeleri, işleri, görevleri ve ekip üyelerini okuyabilir; sizin adınıza görev, iş ve proje testi oluşturabilir. Kurulum OAuth ile yapılır, parola veya erişim anahtarı kopyalamanız gerekmez.

Tek Worun MCP adresi

Codex ve Claude için aynı uzak MCP adresini kullanın: https://worun.app/api/mcp. Her istemci kendi OAuth oturumunu açar; Worun parolanız istemciyle paylaşılmaz.

Neler yapabilirsiniz?

Projeleri listeleme
Üyesi olduğunuz projeleri bulur; organizasyon yöneticileri tüm projeleri görebilir.
Ekip üyelerini listeleme
Görev veya iş atamak için organizasyondaki kullanıcıları ve rollerini bulur.
İşleri ve görevleri listeleme
Erişebildiğiniz aktif kayıtları referans, proje, iş, sorumlu veya atanan kişiyle filtreler.
Görev oluşturma
Tek görev veya en fazla 50 görevlik atomik toplu kayıt oluşturur.
İş oluşturma
Bir projeye ve sorumlu kişiye bağlı iş; istenirse aynı başlıkta bağlı görev oluşturur.
Proje testi oluşturma
Bir projeye bağlı test maddesini tespit, öneri, öncelik ve atanan kişiyle oluşturur.

Codex bağlantısı

Codex masaüstü uygulaması, CLI ve IDE uzantısı aynı MCP yapılandırmasını paylaşır. Bir kez bağlandıktan sonra aynı bilgisayarda yeniden sunucu eklemeniz gerekmez.

Codex masaüstü uygulaması

En kolay kurulum yolu budur. MCP sunucu adresini aşağıdaki gibi kullanın:

Worun MCP adresi
https://worun.app/api/mcp
  1. 1
    Codex’te Ayarlar’ı açın ve MCP sunucularıbölümüne gidin.
  2. 2
    Sunucu ekle’yi seçin. Adı worun, bağlantı türünü Streamable HTTP yapın.
  3. 3
    URL alanına https://worun.app/api/mcp yazın, kaydedin ve uygulamayı yeniden başlatın.
  4. 4
    Sunucu listesinde Worun için Authenticate / Kimlik doğrula’yı seçin.
  5. 5
    Worun hesabınızla giriş yapın; organizasyonu, hesabı ve istenen izinleri kontrol edip onaylayın.
  6. 6
    Yeni bir görev açın ve mesaj alanına /mcp yazarak Worun araçlarının göründüğünü doğrulayın.

Codex CLI

Terminalden kurulum iki komuttur. İlk komut sunucuyu kaydeder, ikincisi tarayıcıda OAuth izin ekranını açar.

Terminal
codex mcp add worun --url https://worun.app/api/mcp
codex mcp login worun

Terminal bir yetkilendirme bağlantısı gösterirse aynı bilgisayardaki tarayıcıda açın. İzin verdikten sonra terminalde Successfully logged in to MCP server 'worun'.mesajını görmelisiniz.

Bağlantıyı kontrol edin
codex mcp get worun
codex mcp list

config.toml alternatifi

İsterseniz ~/.codex/config.toml dosyasına aşağıdaki kaydı ekleyip ardındancodex mcp login worun çalıştırabilirsiniz.
~/.codex/config.toml
[mcp_servers.worun]
url = "https://worun.app/api/mcp"

Claude.ai ve Claude Desktop bağlantısı

Worun, Claude’a uzak özel bağlayıcı olarak eklenir. Bağlantı Claude hesabınızda tutulduğu için aynı kurulum Claude.ai ve Claude Desktop’ta kullanılabilir.

Worun uzak MCP adresi
https://worun.app/api/mcp
  1. 1
    Claude.ai veya Claude Desktop’ta Customize → Connectors bölümünü açın.
  2. 2
    Bireysel planda + ardından Add custom connector’ı seçin. Adı Worun, URL’yi https://worun.app/api/mcp yapın.
  3. 3
    Advanced settings altındaki OAuth Client ID ve Client Secret alanlarını boş bırakın. Worun, Claude istemcisini OAuth sırasında dinamik olarak kaydeder.
  4. 4
    Add, ardından Connect’i seçin. Açılan Worun sayfasında giriş yapıp organizasyonu, hesabı ve izinleri kontrol ederek onaylayın.
  5. 5
    Yeni konuşmada mesaj alanının solundaki + → Connectorsmenüsünü açın ve Worun’u bu konuşma için etkinleştirin.

Team ve Enterprise hesabı kullanıyorsanız

Bağlayıcıyı önce bir Owner veya Primary Owner Organization settings → Connectors → Add → Custom → Webyoluyla ve aynı MCP URL’siyle organizasyona ekler. Üyeler ardından Customize → Connectorsaltında Worun’u bulup Connect’i seçer.

Claude Desktop için yerel yapılandırma gerekmez

Bu bir uzak bağlayıcıdır; claude_desktop_config.jsondosyasını düzenlemeyin. Claude Desktop da bağlantıyı Anthropic’in bulutundan, Claude hesabınız üzerinden kullanır.

Worun OAuth izin ekranı

Codex veya Claude sizi Worun’a yönlendirdiğinde izin ekranında aşağıdaki bilgileri kontrol edin. Akışı siz başlatmadıysanız ya da adres beklediğiniz istemciye ait değilse onaylamayın.

Worun adresi
Giriş ve izin sayfası https://worun.app alan adında açılmalıdır.
Uygulama ve yönlendirme adresi
Uygulama adı kullandığınız istemciyle eşleşmelidir. Codex CLI yerel 127.0.0.1 callback'i kullanabilir; Claude uzak bağlayıcısında yönlendirme adresi Claude/Anthropic alanına ait olmalıdır.
Organizasyon ve hesap
İşlem yapmak istediğiniz Worun organizasyonunu ve doğru kullanıcı e-postasını seçin.
İstenen izinler
Projeleri, işleri, görevleri ve ekip üyelerini görüntüleme; sizin adınıza görev, iş ve proje testi oluşturma ve oturum yenileme kapsamlarını tek tek gözden geçirin.

Bağlantıyı doğrulayın

Codex’te yeni bir görev, Claude’da Worun’un etkin olduğu yeni bir konuşma açıp doğal dille istekte bulunun. Önce salt okunur bir çağrıyla başlayın; oluşturma işlemlerinde başlık, atanan kişi, proje ve tarih gibi ayrıntıları kontrol edin.

  • “Worun’daki erişebildiğim projeleri listele.”
  • “Organizasyonda Caner isimli kullanıcıyı bul.”
  • “Worun projesindeki Can Girgin’e atanmış işleri ve görevleri listele.”
  • “Worun projesi için yarına düşük öncelikli bir görev oluştur.”
  • “Bu üç görevi tek atomik işlemde oluştur.”
  • “Worun projesinde bana atanmış, cuma teslimli bir iş oluştur.”
  • “Worun projesine Can Girgin’e atanmış bir proje testi ekle.”

En güvenli ilk kontrol

“Worun’daki erişebildiğim projeleri listele” isteği veri değiştirmez. Sonuç döndüğünde OAuth oturumu, organizasyon seçimi ve araç erişimi birlikte doğrulanmış olur.

İzinler ve güvenlik

Worun yalnız onay ekranında gördüğünüz kapsamları verir. İzinler organizasyon ve kullanıcı hesabınıza bağlıdır; Codex veya Claude uygulamadaki mevcut rol ve üyelik sınırlarınızı aşamaz.

worun.read
Erişebildiğiniz projeleri, işleri, görevleri ve ekip üyelerini görüntüleme.
worun.tasks.write
Sizin adınıza tek veya toplu görev oluşturma.
worun.jobs.write
Sizin adınıza iş oluşturma.
worun.project_tests.write
Sizin adınıza proje testi oluşturma.
offline_access
Parolanızı yeniden sormadan bağlantıyı güvenli yenileme; uygulama parolanızı paylaşmaz.

Onaylamadan önce kontrol edin

OAuth akışını siz başlatmadıysanız izin vermeyin. Uygulama adının kullandığınız istemciyle, hesabın ve organizasyonun seçiminizle eşleştiğinden emin olun. Codex CLI yerel callback kullanabilir; Claude bağlantısı Claude/Anthropic alanına dönmelidir.

Yeniden yetkilendirme ve bağlantıyı kaldırma

Codex’te yalnız oturumu yenilemek için logout sonrasında sunucuyu kaldırmadan tekrar login çalıştırın. Yeni bir Worun izni eklendiyse kapsamları açıkça isteyin. Tamamen kaldırmak için iki komutu da kullanın.

Codex CLI
# Yeniden yetkilendir (tüm güncel izinler)
codex mcp logout worun
codex mcp login worun --scopes worun.read,worun.tasks.write,worun.jobs.write,worun.project_tests.write,offline_access

# Tamamen kaldır
codex mcp logout worun
codex mcp remove worun

Claude’da Customize → Connectorsaltında Worun’u açın. Oturumu yenilemek için Disconnect, ardından Connect’i seçin. Bağlayıcı kaydını kaldırmak için üç nokta menüsünden Remove’ı kullanın. URL’yi değiştirmek isterseniz bağlayıcıyı kaldırıp yeni adresle tekrar ekleyin. Team ve Enterprise organizasyonlarında organizasyon genelindeki kaydı yalnız Owner kaldırabilir.

Codex sorun giderme

Yetkilendirme ekranında 127.0.0.1 adresi görünüyor
Codex CLI, OAuth sonucunu aynı bilgisayardaki geçici bir porta alır. Bu nedenlehttp://127.0.0.1:<port> normaldir. Akışı siz başlattıysanız, uygulama adı Codex ise ve ekrandaki port terminaldeki bağlantıyla aynıysa devam edebilirsiniz. Yetkilendirme ve token uçları yine https://worun.appüzerindedir.
İzin verdim ama araçlar görünmüyor
Uygulamayı yeniden başlatın veya yeni bir görev açın. Ardından mesaj alanına/mcp yazın. Mevcut görev, bağlantıdan önce açıldıysa eski araç listesini kullanıyor olabilir.
401 veya yeniden giriş hatası alıyorum
Terminalde codex mcp logout worun, ardındancodex mcp login worun çalıştırın. İzin ekranında doğru organizasyon ve hesabın seçili olduğunu kontrol edin.
codex mcp list, Auth alanında Unsupported gösteriyor
Bazı Codex sürümlerinde bu sütun OAuth oturumunu doğru yansıtmayabilir. Giriş komutundaki Successfully logged in sonucu ile yeni görevde /mcp altında Worun araçlarının görünmesini esas alın.
Bağlantıyı tamamen kaldırmak istiyorum
Önce codex mcp logout worun ile oturumu kapatın, sonracodex mcp remove worun ile sunucu kaydını silin. Masaüstünde aynı işlemi MCP sunucuları ayarından yapabilirsiniz.

Claude'a özel sorun giderme

Worun bağlandı ama bu konuşmada araçlar görünmüyor
Mesaj alanının solundaki + düğmesinden Connectors’ı açıp Worun anahtarını bu konuşma için etkinleştirin. Gerekirse yeni bir konuşma başlatın ve Tool access ayarını Auto yapın.
OAuth ekranı tekrar tekrar açılıyor veya oturum süresi doldu
Customize → Connectors altında Worun bağlantısını kesin, ardından Connect ile yeniden bağlanın. Worun izin ekranında doğru hesap ve organizasyonu seçtiğinizden emin olun.
Özel bağlayıcı ekleme seçeneği görünmüyor
Team ve Enterprise planlarında özel bağlayıcıyı önce bir Owner veya Primary Owner Organization settings → Connectors üzerinden organizasyona eklemelidir. Üyeler daha sonra Customize → Connectors altında kendi hesaplarını bağlar.
Claude Desktop'ta claude_desktop_config.json düzenlemeli miyim?
Hayır. Worun herkese açık bir uzak MCP sunucusudur; Claude hesabınızdaki web bağlayıcısı olarak eklenir ve Claude.ai ile Claude Desktop arasında kullanılabilir. Yerel MCP sunucuları için kullanılan masaüstü yapılandırması bu bağlantının parçası değildir.
Bağlantı zaman aşımına uğruyor
URL’nin tam olarak https://worun.app/api/mcpolduğunu kontrol edin. Claude uzak MCP’ye Anthropic’in bulutundan bağlandığı için localhost, VPN içi veya yalnız özel ağdan erişilen adresler çalışmaz.
Güncel istemci arayüzleri için resmî Codex MCP rehberini ve resmî Claude uzak MCP rehberini kullanın.