Yapay zekâ uygulamalarını bağlama

Claude, ChatGPT, Cursor, Codex veya MCP konuşan başka herhangi bir yapay zekâ istemcisini VentionDesk'e kendin bağlayabilirsin — API anahtarı olmadan. Uygulama VentionDesk hesabın üzerinden oturum açar ve bağlarken neler yapabileceğine sen karar verirsin. Bu işletme sahipleri ve çalışanlar için çalışır; müşteri portalının müşteri hesapları yapay zekâ uygulaması bağlayamaz.

Uluslararası kullanıcılar ve uygulama dizinleri için, tüm araçların listesi ve örnek istemlerle sayfa: Connect AI apps to VentionDesk.

Bir bağlantı nasıl çalışır

1. Adresi gir. Yapay zekâ uygulamasında şu adresle bir MCP sunucusu (çoğunlukla “connector” veya “integration” olarak adlandırılır) ekle: https://api.ventiondesk.com/mcp. Uygulamanın başka bir şeye ihtiyacı yok — oturum açmanın yolunu kendisi bulur.
2. Oturum aç. Uygulama, VentionDesk oturum açma sayfasıyla bir tarayıcı penceresi açar. Zaten oturum açmışsan doğrudan devam eder.
3. Onay. VentionDesk uygulamanın adıyla bir onay sayfası gösterir (/oauth/zustimmen altında). Orada şunları seçersin:
   • birden fazlasına aitsen işletmeyi,
   • izinleri — çalışan olarak yalnızca işletme sahibinin yapay zekâ uygulamaları için açtıklarını,
   • projeleri — tümü (gelecektekiler dahil) veya bir seçim.
4. Bağlandı. Onayından sonra uygulamaya geri dönersin. Bundan sonra tam olarak bu izinlerle çalışır — seninkilerle değil. Reddedersen bağlantı hiçbir şey saklanmadan iptal edilir.

Uygulama bir ajan anahtarıyla aynı araçları alır (bkz. Claude ve MCP); bir aracın neler yapabileceğini seçtiğin izinler belirler. Uygulamanın okuduğu her şey sağlayıcısına gider — örneğin Anthropic, OpenAI veya Anysphere. İşletmenin buna izin verip vermediği onun kendi kararıdır; talepler, müşteri verileri ve isimli zaman kayıtları için genellikle sağlayıcıyla bir veri işleme sözleşmesine ihtiyacın vardır.

Claude

claude.ai ve Claude Desktop: Settings › Connectors altında ad olarak “VentionDesk” ve adres olarak https://api.ventiondesk.com/mcp ile özel bir connector ekle. Ardından “Connect” — oturum açma ve onay yukarıdaki gibi gelir. Planında ve kuruluşunda özel connector'ların etkin olup olmadığına Anthropic veya Claude yöneticin karar verir.

Claude Code: terminalde

claude mcp add --transport http ventiondesk https://api.ventiondesk.com/mcp

ve ardından Claude Code'da /mcp çağır ve “ventiondesk” için oturum aç. Sabit bir anahtarla çalışmayı tercih ediyorsan Claude ve MCP sayfasını izle.

Görevleri /aufgaben ile olduğu gibi işle — dosya sistemi olmayan uygulamada da: “Work on the next open VentionDesk task”. Claude sıradaki görevi görev çalıştırıcısıyla aynı kurala göre alır, açıklamayı, geçmişi ve projeyi okur, ekran görüntülerini yalnızca gerektiğinde getirir, sonucu kanıtla bildirir ve çalışmayı kapatır. Bunun için bağlantının “Claude çalıştırıcısı” şablonunun izinlerine ihtiyacı vardır (görevleri okuma ve bildirme, çalışmaları yönetme, projeleri okuma).

ChatGPT

Ayarlarda Connectors altında (sürüme göre “Apps & Connectors”; özel MCP sunucuları geliştirici modu gerektirir) yeni bir connector oluştur: adres https://api.ventiondesk.com/mcp, kimlik doğrulama OAuth. Oturum açma ve onay ilk kullanımda gelir. Hangi planların özel connector'lara izin verdiğine OpenAI karar verir.

Cursor

~/.cursor/mcp.json (tüm projeler için) veya .cursor/mcp.json (yalnızca bu proje) içinde:

{
  "mcpServers": {
    "ventiondesk": {
      "url": "https://api.ventiondesk.com/mcp"
    }
  }
}

Cursor ardından sunucuyu Settings › MCP altında bir oturum açma uyarısıyla gösterir; uyarıya tıklamak oturum açmayı ve onayı başlatır.

Codex

~/.codex/config.toml içinde:

[mcp_servers.ventiondesk]
url = "https://api.ventiondesk.com/mcp"

Ardından codex mcp login ventiondesk — tarayıcı oturum açmayı ve onayı açar. Codex'in eski sürümleri MCP'yi HTTP üzerinden yalnızca ek bir anahtarla konuşur; emin değilsen Codex sürümünün yardımına bak.

Diğer istemciler

OAuth ile HTTP üzerinden MCP'yi (“Streamable HTTP”) destekleyen her istemci yolu kendisi bulur: Oturum açılmamış bir isteğe https://api.ventiondesk.com/mcp 401 ile yanıt verir ve https://api.ventiondesk.com/.well-known/oauth-protected-resource adresini gösterir; VentionDesk'in oturum açma hizmeti orada listelenir. İstemci kendini orada kaydeder — önceden oluşturman gereken bir şey yoktur.

Bir istemcinin istediği OAuth kapsamları (openid, email, profile) yalnızca oturum açmayla ilgilidir. Uygulamanın VentionDesk'te neler yapabileceği onay sayfasında seçilir.

Bağlantıyı kesme ve sona erme

Ayarlar › Yapay zekâ uygulamalarım altında tüm işletmelerdeki bağlantılarını görürsün: uygulama, izinler, projeler, bağlanma tarihi ve son kullanım. “Bağlantıyı kes” bir bağlantıyı hemen sonlandırır — uygulamaya daha önce verilmiş bir oturum da sonrasında geçerli olmaz. Kendi bağlantında VentionDesk oturum açmadaki onayı da geri alır; uygulamayı yeniden bağlarsan VentionDesk sana yeniden sorar.

90 gün kullanılmayan bir bağlantı kendiliğinden sona erer. İhtiyacın olduğunda uygulamayı yeniden bağlaman yeterli.

İşletme sahibi olarak orada işletmedeki tüm kişilerin bağlantılarını da görür ve herhangi birini kesebilirsin. Ayrıca çalışanların bir yapay zekâ uygulamasına hangi izinleri verebileceğine de sen karar verirsin. Varsayılan olarak bunlar “Yalnızca okuma” ve “Claude çalıştırıcısı” şablonlarının izinleridir — projeleri, görevleri ve dağıtımları okuma, görevlere geri bildirim verme ve çalıştırmaları kaydetme —, hassas hiçbir şey yok. Sen kendin, yalnızca işletmecinin yapabildiği erişim kaydı dışında her izni verebilirsin. Açtığın izinleri daraltırsan bu, mevcut bağlantılarda uygulamanın bir sonraki token'ından itibaren geçerli olur — genellikle bir saat içinde.

Her bağlantı ve her bağlantı kesme işletmenin günlüğünde görünür; bir uygulamanın yaptığı değişiklikler, VentionDesk onları kaydettiği ölçüde orada görünür — her biri uygulama ve kişiyle, örneğin “Yapay zekâ uygulaması: Claude · Anna Schmidt”.

Yapay zekâ uygulaması mı, API anahtarı mı?