Vertice AI

The Vertice AI MCP bağlayıcısı şu anda Önizleme aşamasındadır. Erişimi olan müşteri kümesi sınırlıdır ve erişim, Vertice Hesap Yöneticiniz aracılığıyla talep üzerine verilir.

1. Vertice AI MCP bağlayıcısı nedir?

---

Vertice AI MCP bağlayıcısı, uyumlu bir harici AI asistanının (örneğin Claude) doğal dil kullanarak Vertice satın alma çalışma alanınızı sorgulamasına ve sizin adınıza Vertice iş akışlarını tetiklemesine olanak tanıyan barındırılan bir uç noktadır. Mevcut Vertice platformunun üzerinde açık Model Context Protocol (MCP) uygular.

Bağlayıcı, Vertice'ye ek bir erişim kanalıdır. Vertice web uygulaması üzerinden zaten kullanabileceğiniz aynı satın alma verilerini ve iş akışlarını, aynı rol tabanlı erişim kontrolleriyle sunar.

Bir AI asistanı bağlamak, Vertice'de kendinizin göremeyeceği hiçbir şeye erişim sağlamaz.

Bu belge boyunca örnek olarak Claude'u kullanıyoruz. Aynı bağlayıcı, MCP Streamable HTTP taşımasını ve PKCE (S256) ile OAuth 2.1'i destekleyen herhangi bir MCP uyumlu AI asistanıyla çalışır.

2. Örnek kullanım senaryoları

---

Bağlayıcı, satın alma ile ilgili sorular ve iş akışları için tasarlanmıştır. Aşağıda sorabileceğiniz örnek sorular verilmiştir. Her biri, bölüm 4'te listelenen araçlardan birine karşılık gelir.

• "Portföyümüzdeki hangi sözleşmeler önümüzdeki 90 gün içinde sona eriyor?"
• "Bu satıcıyla toplam yıllık harcamamız nedir ve aynı kategoride başka hangi satıcılar var?"
• "Bu satıcı için en son imzalanan sözleşmeyi bulun ve yenileme koşullarını özetleyin."
• "Bu satıcının ürünü için ek 25 kullanıcı lisansı satın alma talebi açın."

Bunlar örnektir. Araçların, parametrelerin ve davranışın tam seti, istek anında Vertice'nin orkestrasyon katmanı tarafından belirlenir.

3. Uyumluluk ve ön koşullar

---

Gereksinim	Ayrıntı
Aktif Vertice aboneliği	Aktif bir Vertice kiracısında kullanıcı olmalısınız.
Vertice kullanıcı hesabı	Vertice AI özelliklerini kullanma iznine sahip, iyi durumda bir kullanıcı hesabı.
Kimlik doğrulama	Bağlayıcı, kiracınızın mevcut Vertice kimlik doğrulama kurulumu üzerinden sizi doğrular. Kiracınız bir SAML 2.0 kimlik sağlayıcısı aracılığıyla tek oturum açma (SSO) kullanıyorsa, normal şirket kimlik bilgilerinizle oturum açarsınız. Kiracınız Vertice'nin yerel kimlik doğrulamasını kullanıyorsa, Vertice kullanıcı adınız ve şifrenizle oturum açarsınız.
AI asistan aboneliği	Özel bağlayıcılar eklemeyi destekleyen, seçtiğiniz AI asistan sağlayıcısıyla bir abonelik. Claude.ai için bu şu anda Team veya Enterprise planı gerektirir; en güncel plan kullanılabilirliği için lütfen Anthropic'in belgelerine bakın.

Bağlayıcının kendisi barındırılan bir hizmettir. Altyapınıza hiçbir yazılım kurulmaz. Kişisel API anahtarı verilmez.

4. Araç kategorileri

---

Bağlayıcı, aşağıdaki satın alma ile ilgili kategorilerde araçlar sunar. Her araç, açık MCP readOnlyHint ve destructiveHint ek açıklamaları bildirir; böylece uyumlu AI asistanları, yazma eylemlerini çağırmadan önce kullanıcıyı uyarabilir.

Kategori	Salt okunur	Yazma işlemleri gerçekleştirir
Sözleşme analitiği	✔
Harcama analitiği	✔
Satıcı istihbaratı	✔
Belge arama	✔
Uyumluluk durumu	✔
Satın alma talebi oluşturma		✔ (ekleyici — yalnızca yeni varlıklar oluşturur)
Sözleşme meta verisi güncellemeleri		✔ (kontrollü değişiklik)

Araçların yetkili listesi doğrudan AI asistanınızın içinde keşfedilebilir — asistan, bağlayıcıya karşı standart MCP tools/list yöntemini çağırır ve adları, açıklamaları ve ek açıklamaları size gösterir.

Araçların tam seti zamanla değişebilir. Her araçtaki ek açıklamalar, okuma mı yoksa yazma mı yaptığını belirtmeye devam edecektir.

5. AI asistanınızı bağlama

---

Her Vertice kiracısının kendi bağlayıcı URL'si şu biçimdedir:

https://ai.vertice.one/accounts//mcp

<your-account-id> değerini kiracı tanımlayıcınızla değiştirin. Kiracı tanımlayıcınızı bilmiyorsanız, lütfen Vertice Destek ile iletişime geçin.

Claude.ai'de bağlayıcı ekleme

---

1. Claude.ai'yi açın
2. Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle seçeneğine gidin
3. Bir ad girin (örneğin, 'Vertice')
4. Yukarıdaki bağlayıcı URL'sini yapıştırın
5. Ekle'ye tıklayın
6. Claude bir yetkilendirme penceresi açar. Kiracınızın kimlik doğrulama sağlayıcısına yönlendirilirsiniz (kiracınız SSO kullanıyorsa şirketinizin tek oturum açma sayfasına, aksi takdirde Vertice'nin yerel giriş sayfasına).
7. Mevcut kimlik bilgilerinizle oturum açın. Yeni bir şifre oluşturulmaz. Kişisel API anahtarı verilmez.
8. Claude, bağlayıcının bağlandığını onaylar.

Artık herhangi bir sohbette Claude'a Vertice verilerinizle ilgili satın alma soruları sorabilirsiniz.

Önceden doldurulmuş kurulum bağlantısı

---

Kolaylık olması açısından, aynı akış bu bağlantıyı izleyerek başlatılabilir:

https://app.vertice.one/preferences/user/integrations

6. Kimlik doğrulama

---

Kimlik doğrulama, PKCE (S256) ile OAuth 2.1 kullanır. Akış şu şekildedir:

1. AI asistanınız, yetkilendirme sunucusunu keşfetmek için bağlayıcının RFC 9728 korumalı kaynak meta verilerini alır.
2. AI asistanı, OAuth uç noktalarını keşfetmek için RFC 8414 yetkilendirme sunucusu meta verilerini alır.
3. AI asistanı, PKCE ile bir OAuth 2.1 yetkilendirme kodu akışı başlatır.
4. Vertice'nin /authorize yönlendiricisi sizi doğrudan kiracınızın kimlik doğrulama sağlayıcısına yönlendirir. Kiracınız SAML üzerinden SSO kullanıyorsa, Vertice sizi arada herhangi bir Vertice seçici adımı olmadan doğrudan yapılandırılmış SAML kimlik sağlayıcınıza yönlendirir. Kiracınız Vertice'nin yerel kimlik doğrulamasını kullanıyorsa, Vertice giriş formunu görürsünüz.
5. Başarılı oturum açmanın ardından, Vertice'nin kimlik katmanı, kullanıcınıza, kiracınıza ve bağlayıcının kaynak kapsamına bağlı kısa ömürlü bir erişim belirteci düzenler.
6. AI asistanı, Vertice'ye yapılan her MCP isteğinde bu erişim belirtecini Bearer kimlik bilgisi olarak sunar.

Belirteçler otomatik olarak sona erer. Bağlayıcıyı istediğiniz zaman AI asistanınızın ayarlarından bağlantısını kesebilirsiniz; bu, Vertice hesabınızı etkilemez.

7. İzinler

---

Bağlayıcı, mevcut Vertice rol tabanlı erişim kontrollerinizi uygular. Bağlayıcı üzerinden erişebileceğiniz veriler, Vertice web uygulaması üzerinden erişebileceğiniz verilerle aynıdır, fazlası değil.

Aynı erişim kontrol modeli, tüm Vertice yüzeylerinde paylaşılır — web uygulaması, Slack ve Microsoft Teams için Vertice entegrasyonları ve Vertice AI MCP bağlayıcısı. Verileri değiştiren her eylem, hangi yüzey tarafından başlatılırsa başlatılsın, Vertice'nin mevcut denetim izinde kaydedilir.

8. Hız sınırları

---

Hizmet kalitesini korumak için bağlayıcı, uygulama katmanı hız sınırları uygular:

Kapsam	Sınır
Kimliği doğrulanmış kullanıcı başına	dakikada 60 istek
Vertice kiracısı başına (hesaptaki tüm kullanıcılar arasında)	dakikada 300 istek

Bir sınıra ulaşıldığında, bağlayıcı -32004 kodlu bir JSON-RPC hatası döndürür ve aşağıdaki başlıklarla HTTP 429 Too Many Requests ile eşlenir:

Retry-After: X-RateLimit-Limit: X-RateLimit-Remaining: 0 X-RateLimit-Reset:

İyi davranan AI asistanları Retry-After değerini onurlandırır. Normal etkileşimli kullanımda bu sınırlara ulaşmamalısınız. Bunlar öncelikle kontrolden çıkan otomasyona karşı korumak için vardır. Kiracınızın meşru iş yükü daha yüksek eşikler gerektiriyorsa, lütfen Vertice Hesap Yöneticinizle iletişime geçin.

Claude.ai hız sınırı yanıtlarını nasıl gösterir

---

Bir Claude sohbeti sırasında hız sınırına ulaşıldığında, Claude.ai istemcisi yanıtı son kullanıcıya açık bir hız sınırı mesajı yerine genel bir araç hatası mesajı olarak görüntüleyebilir. Tel düzeyindeki yanıt spesifikasyona uygundur; kullanıcıya gösterilen yüzey metni, Vertice tarafından değil, AI asistanı tarafından belirlenir. Böyle bir hatayla karşılaşırsanız, yeniden denemeden önce birkaç saniye bekleyin.

9. Araç yanıt boyutu

---

Bağlayıcı, Anthropic Bağlayıcılar Dizini rehberliğinde tanımlanan 25.000 belirteç yanıt sınırını hedefler. Çok büyük sorgular için sonuçları kullanılabilir tutmak amacıyla yaklaşık 20.000 belirteçte bir güvenlik ağı kırpması uygulanır; devreye girerse, yanıt, kırpmanın gerçekleştiğini ve sorgunun nasıl daraltılacağını belirten açık bir alt bilgi içerir. Normal kullanımda, altta yatan Vertice orkestrasyonu büyük liste işlemlerini sayfalamak üzere tasarlanmıştır ve kırpma alt bilgisini görmemelisiniz.

10. Veri işleme

---

Vertice'nin daha geniş AI güvenlik duruşunun bir açıklaması — SOC 2 Type 2, şifreleme, kiracı izolasyonu, model sağlayıcıları ve doğruluk kontrolleri — AI MCP Bağlayıcı Gizlilik Politikamızda belirtilmiştir. Ek güvenlik materyalleri Vertice Trust Portal'da mevcuttur.

Önemli

Bağlayıcıyı çağıran herhangi bir harici AI asistanına bir soru sorduğunuzda, isteminiz ve bağlayıcının yanıtı, o AI asistanının sağlayıcısına iletilir. Bu verilerle ne yaptıklarını onların gizlilik politikası ve koşulları belirler.

Vertice, AI asistan sağlayıcısı tarafından yapılan alt işlemeyi kontrol etmez veya denetlemez. Bağlayıcıyı etkinleştirmeden önce lütfen AI asistan sağlayıcısının politikalarını inceleyin.

11. Destek

---

Neden	Kanal
İşlevsel sorunlar, kurulum yardımı	Vertice Destek ([email protected])
Hesap soruları	Hesap Yöneticiniz
Gizlilik soruları, veri sahibi hakları talepleri	[email protected]
Güvenlik açığı bildirimi	[email protected] — ayrıca Güvenlik Açığı Bildirim Politikamıza bakın

12. Sıkça sorulan sorular

---

Bağlayıcı, Vertice verilerimi AI asistan sağlayıcıma gönderir mi? Bir dış AI asistanına bağlayıcıyı çağıran bir soru sorduğunuzda, isteminiz ve bağlayıcının araç yanıtı, AI asistanı sağlayıcısının altyapısına iletilir (örneğin, Claude.ai bağlayıcısı için Anthropic'e). Bu, bir MCP bağlayıcısının kaçınılmaz doğasıdır. Vertice, AI asistanı sağlayıcısının bu verilerle ne yaptığını kontrol etmez veya denetlemez — bu, AI asistanı sağlayıcısıyla yaptığınız anlaşmaya tabidir. Bağlayıcıyı etkinleştirmeden önce AI asistanı sağlayıcısının gizlilik politikasını incelemenizi şiddetle öneririz.

Bağlayıcı, Claude sohbet geçmişimi veya Claude içindeki başka herhangi bir veriyi görür mü?

Hayır. Bağlayıcı yalnızca Claude'un gönderdiği açık MCP istek zarflarını alır — araç adı ve araç parametreleri. Claude'un belleğine, konuşma özetlerine, önceki konuşmalara veya Claude'a yüklenen dosyalara erişimi yoktur.

Bağlayıcı, onayım olmadan Vertice verilerimde değişiklik yapar mı?

Yazma işlemleri gerçekleştiren araçlar, uyumlu AI asistanlarına, bunları çağırmadan önce kullanıcıyla onaylamalarını bildiren açık MCP destructiveHint ve readOnlyHint=false ek açıklamalarını taşır. Claude bu deseni izler. Bu ek açıklamalara saygı göstermeyen bir AI asistanı kullanıyorsanız, lütfen bağlayıcıyı yalnızca okuma araçlarıyla kullanın veya devre dışı bırakın.

Aynı kiracıdaki iki kullanıcı bir bağlayıcı yapılandırmasını paylaşabilir mi?

Her son kullanıcı, kendi kimliğiyle ayrı ayrı kimlik doğrular. Bağlayıcı URL'si kiracı başınadır; bağlantının kendisi kullanıcı başınadır. Her kullanıcı yalnızca kendi Vertice rolünün izin verdiğini görür.

Bağlayıcı çevrimdışı veya hava boşluklu ortamlarda çalışır mı?

Hayır. Bağlayıcı barındırılan bir hizmettir. AI asistanı sağlayıcısının altyapısından gelen HTTPS bağlantısı gerektirir. Şirket içi veya kendi kendine barındırılan bir seçenek yoktur.

Bir hata nereye bildirebilirim veya yeni bir araç talep edebilirim?

Hata raporları ve özellik istekleri Vertice Destek ekibi aracılığıyla iletilir. Güvenlik sorunları doğrudan [email protected] adresine bildirilmelidir.