Vertice AI

Konektor MCP Vertice AI saat ini dalam Pratinjau. Jumlah pelanggan yang memiliki akses terbatas dan akses diberikan berdasarkan permintaan melalui Manajer Akun Vertice Anda.

1. Apa itu konektor MCP Vertice AI?

---

Konektor MCP Vertice AI adalah endpoint yang di-hosting yang memungkinkan asisten AI eksternal yang kompatibel — misalnya, Claude — untuk menanyai ruang kerja pengadaan Vertice Anda dan memicu alur kerja Vertice atas nama Anda, menggunakan bahasa alami. Ini mengimplementasikan Model Context Protocol (MCP) terbuka di atas platform Vertice yang sudah ada.

Konektor ini adalah saluran akses tambahan ke Vertice. Ini mengekspos data pengadaan dan alur kerja yang sama yang sudah dapat Anda gunakan melalui aplikasi web Vertice, diatur oleh kontrol akses berbasis peran yang sama.

Menghubungkan asisten AI tidak memberikan akses ke apa pun yang tidak dapat Anda lihat sendiri di Vertice.

Sepanjang dokumen ini kami menggunakan Claude sebagai contoh yang dikerjakan. Konektor yang sama berfungsi dengan asisten AI yang kompatibel dengan MCP yang mendukung transportasi HTTP Streamable MCP dan OAuth 2.1 dengan PKCE (S256).

2. Contoh kasus penggunaan

---

Konektor ini ditujukan untuk pertanyaan dan alur kerja terkait pengadaan. Di bawah ini adalah contoh pertanyaan yang mungkin Anda ajukan. Setiap pertanyaan dipetakan ke salah satu alat yang tercantum di bagian 4.

• "Kontrak mana dalam portofolio kami yang berakhir dalam 90 hari ke depan?"
• "Berapa total pengeluaran tahunan kami dengan vendor ini, dan vendor lain mana yang berada dalam kategori yang sama?"
• "Temukan kontrak terbaru yang ditandatangani untuk vendor ini dan rangkum ketentuan pembaruan."
• "Buka permintaan pembelian baru untuk tambahan 25 kursi produk vendor ini."

Ini adalah contoh. Kumpulan alat, parameter, dan perilaku yang tepat ditentukan oleh lapisan orkestrasi Vertice pada saat permintaan.

3. Kompatibilitas dan prasyarat

---

Persyaratan	Detail
Langganan Vertice aktif	Anda harus menjadi pengguna pada penyewa (tenant) Vertice yang aktif.
Akun pengguna Vertice	Akun pengguna dalam status baik, dengan izin untuk menggunakan fitur AI Vertice.
Autentikasi	Konektor mengautentikasi Anda melalui pengaturan autentikasi Vertice yang ada di penyewa Anda. Jika penyewa Anda menggunakan single sign-on (SSO) melalui penyedia identitas SAML 2.0, Anda masuk dengan kredensial perusahaan normal Anda. Jika penyewa Anda menggunakan autentikasi asli Vertice, Anda masuk dengan nama pengguna dan kata sandi Vertice Anda.
Langganan asisten AI	Langganan dengan penyedia asisten AI pilihan Anda yang mendukung penambahan konektor kustom. Untuk Claude.ai, ini saat ini memerlukan paket Tim atau Perusahaan; silakan merujuk ke dokumentasi Anthropic untuk ketersediaan paket terbaru.

Konektor itu sendiri adalah layanan yang di-hosting. Tidak ada perangkat lunak yang diinstal pada infrastruktur Anda. Tidak ada kunci API pribadi yang diterbitkan.

4. Kategori alat

---

Konektor mengekspos alat di seluruh kategori terkait pengadaan berikut. Setiap alat mengiklankan anotasi MCP eksplisit readOnlyHint dan destructiveHint, sehingga asisten AI yang kompatibel dapat memperingatkan pengguna sebelum memanggil tindakan tulis.

Kategori	Hanya baca	Melakukan penulisan
Analitik kontrak	✔
Analitik pengeluaran	✔
Intelijen vendor	✔
Pencarian dokumen	✔
Status kepatuhan	✔
Pembuatan permintaan pembelian		✔ (aditif — hanya membuat entitas baru)
Pembaruan metadata kontrak		✔ (mutasi terkontrol)

Daftar alat yang otoritatif dapat ditemukan langsung di dalam asisten AI Anda — asisten memanggil metode MCP standar tools/list terhadap konektor dan menampilkan nama, deskripsi, dan anotasi kepada Anda.

Kumpulan alat yang tepat dapat berkembang. Anotasi pada setiap alat akan terus menunjukkan apakah alat tersebut membaca atau menulis.

5. Menghubungkan asisten AI Anda

---

Setiap penyewa Vertice memiliki URL konektor sendiri dengan bentuk:

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

Ganti <your-account-id> dengan pengidentifikasi penyewa Anda. Jika Anda tidak mengetahui pengidentifikasi penyewa Anda, silakan hubungi Dukungan Vertice.

Menambahkan konektor di Claude.ai

---

1. Buka Claude.ai
2. Buka Pengaturan → Konektor → Tambahkan konektor kustom
3. Masukkan nama (misalnya, 'Vertice')
4. Tempel URL konektor dari atas
5. Klik Tambahkan
6. Claude membuka jendela otorisasi. Anda akan diarahkan ke penyedia autentikasi penyewa Anda (single sign-on perusahaan Anda jika penyewa Anda menggunakan SSO, atau login asli Vertice jika tidak).
7. Masuk dengan kredensial yang sudah ada. Tidak ada kata sandi baru yang dibuat. Tidak ada kunci API pribadi yang diterbitkan
8. Claude mengonfirmasi bahwa konektor terhubung.

Anda sekarang dapat mengajukan pertanyaan terkait pengadaan kepada Claude tentang data Vertice Anda dalam percakapan apa pun.

Tautan instalasi yang sudah diisi sebelumnya

---

Untuk kenyamanan, alur yang sama dapat dimulai dengan mengikuti tautan ini:

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

6. Autentikasi

---

Autentikasi menggunakan OAuth 2.1 dengan PKCE (S256). Alurnya adalah:

1. Asisten AI Anda mengambil metadata sumber daya yang dilindungi RFC 9728 dari konektor untuk menemukan server otorisasi.
2. Asisten AI mengambil metadata server otorisasi RFC 8414 untuk menemukan endpoint OAuth.
3. Asisten AI memulai alur kode otorisasi OAuth 2.1 dengan PKCE.
4. Penerus /authorize Vertice mengarahkan Anda langsung ke penyedia autentikasi penyewa Anda. Jika penyewa Anda menggunakan SSO melalui SAML, Vertice mengarahkan Anda langsung ke penyedia identitas SAML yang dikonfigurasi tanpa langkah pemilih Vertice di antaranya. Jika penyewa Anda menggunakan autentikasi asli Vertice, Anda melihat formulir login Vertice.
5. Setelah masuk berhasil, lapisan identitas Vertice menerbitkan token akses berumur pendek yang terikat pada pengguna Anda, penyewa Anda, dan cakupan sumber daya konektor.
6. Asisten AI menyajikan token akses tersebut sebagai kredensial Bearer pada setiap permintaan MCP ke Vertice.

Token kedaluwarsa secara otomatis. Anda dapat memutuskan konektor kapan saja dari pengaturan asisten AI Anda; ini tidak memengaruhi akun Vertice Anda.

7. Izin

---

Konektor memberlakukan kontrol akses berbasis peran Vertice yang sudah ada. Data yang dapat Anda akses melalui konektor persis sama dengan data yang dapat Anda akses melalui aplikasi web Vertice, tidak lebih.

Model kontrol akses yang sama digunakan bersama di semua permukaan Vertice — aplikasi web, integrasi Vertice untuk Slack dan Microsoft Teams, dan konektor MCP AI Vertice. Setiap tindakan yang memodifikasi data, terlepas dari permukaan mana yang memulainya, dicatat dalam jejak audit Vertice yang ada.

8. Batas kecepatan

---

Untuk menjaga kualitas layanan, konektor memberlakukan batas kecepatan pada lapisan aplikasi:

Cakupan	Batas
Per pengguna terautentikasi	60 permintaan per menit
Per penyewa Vertice (di semua pengguna pada akun)	300 permintaan per menit

Ketika batas tercapai, konektor mengembalikan kesalahan JSON-RPC dengan kode -32004, dipetakan ke HTTP 429 Too Many Requests dengan header berikut:

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

Asisten AI yang berperilaku baik menghormati Retry-After. Dalam penggunaan interaktif biasa, Anda seharusnya tidak mencapai batas ini. Batas ini ada terutama untuk melindungi dari otomatisasi yang tidak terkendali. Jika beban kerja sah penyewa Anda memerlukan ambang batas yang lebih tinggi, silakan hubungi Manajer Akun Vertice Anda.

Bagaimana Claude.ai menampilkan respons batas kecepatan

---

Ketika batas kecepatan tercapai selama percakapan Claude, klien Claude.ai dapat menampilkan respons kepada pengguna akhir sebagai pesan kesalahan alat generik daripada pesan batas kecepatan eksplisit. Respons pada tingkat kabel sesuai spesifikasi; teks permukaan yang ditampilkan kepada pengguna ditentukan oleh asisten AI, bukan oleh Vertice. Jika Anda mengalami kesalahan seperti itu, tunggu beberapa detik sebelum mencoba lagi.

9. Ukuran respons alat

---

Konektor menargetkan batas respons 25.000 token yang ditentukan oleh panduan Direktori Konektor Anthropic. Untuk menjaga hasil tetap dapat digunakan untuk kueri yang sangat besar, pemotongan jaring pengaman diterapkan pada sekitar 20.000 token; jika ini aktif, respons menyertakan footer eksplisit yang menunjukkan bahwa pemotongan terjadi dan cara mempersempit kueri. Dalam penggunaan normal, orkestrasi Vertice yang mendasarinya dirancang untuk melakukan paginasi pada operasi daftar besar dan Anda seharusnya tidak melihat footer pemotongan.

10. Penanganan data

---

Deskripsi postur keamanan AI Vertice yang lebih luas — SOC 2 Type 2, enkripsi, isolasi penyewa, penyedia model, dan kontrol akurasi — dijelaskan dalam Kebijakan Privasi Konektor MCP AI kami. Materi keamanan tambahan tersedia di Portal Kepercayaan Vertice.

Penting

Ketika Anda mengajukan pertanyaan kepada asisten AI eksternal mana pun yang memanggil konektor, prompt Anda dan respons konektor dikirim ke penyedia asisten AI tersebut. Kebijakan privasi dan ketentuan mereka mengatur apa yang mereka lakukan dengan data tersebut.

Vertice tidak mengontrol atau mengaudit pemrosesan hilir oleh penyedia asisten AI. Silakan tinjau kebijakan penyedia asisten AI sebelum mengaktifkan konektor.

11. Dukungan

---

Alasan	Saluran
Masalah fungsional, bantuan pengaturan	Dukungan Vertice ([email protected])
Pertanyaan akun	Manajer Akun Anda
Pertanyaan privasi, permintaan hak subjek data	[email protected]
Pengungkapan kerentanan keamanan	[email protected] — lihat juga Kebijakan Pengungkapan Kerentanan kami

12. Pertanyaan yang sering diajukan

---

Apakah konektor mengirim data Vertice saya ke penyedia asisten AI saya? Saat Anda mengajukan pertanyaan kepada asisten AI eksternal yang memanggil konektor, prompt Anda dan respons alat konektor dikirim ke infrastruktur penyedia asisten AI (misalnya, ke Anthropic untuk konektor Claude.ai). Ini adalah sifat yang tidak dapat dihindari dari konektor MCP. Vertice tidak mengontrol atau mengaudit apa yang dilakukan penyedia asisten AI dengan data tersebut — hal itu diatur oleh perjanjian Anda dengan penyedia asisten AI. Kami sangat menyarankan Anda untuk meninjau kebijakan privasi penyedia asisten AI sebelum mengaktifkan konektor.

Apakah konektor dapat melihat riwayat obrolan Claude saya atau data lain di dalam Claude?

Tidak. Konektor hanya menerima amplop permintaan MCP eksplisit yang dikirim oleh Claude — nama alat dan parameter alat. Konektor tidak memiliki akses ke memori Claude, ringkasan percakapan, percakapan sebelumnya, atau file yang diunggah ke Claude.

Apakah konektor akan membuat perubahan pada data Vertice saya tanpa persetujuan saya?

Alat yang melakukan penulisan membawa anotasi destructiveHint dan readOnlyHint=false MCP yang eksplisit, yang memberi sinyal kepada asisten AI yang kompatibel untuk meminta konfirmasi kepada pengguna sebelum memanggilnya. Claude mengikuti pola ini. Jika Anda menggunakan asisten AI yang tidak menghormati anotasi ini, gunakan konektor hanya dengan alat baca atau nonaktifkan.

Bisakah dua pengguna pada tenant yang sama berbagi konfigurasi konektor?

Setiap pengguna akhir mengautentikasi secara individual dengan identitas mereka sendiri. URL konektor bersifat per-tenant; koneksinya sendiri bersifat per-pengguna. Setiap pengguna hanya melihat apa yang diizinkan oleh peran Vertice mereka.

Apakah konektor berfungsi secara offline atau di lingkungan yang terisolasi (air-gapped)?

Tidak. Konektor adalah layanan yang dihosting. Konektor memerlukan konektivitas HTTPS masuk dari infrastruktur penyedia asisten AI. Tidak ada opsi on-premises atau self-hosted.

Di mana saya bisa melaporkan bug atau meminta alat baru?

Laporan bug dan permintaan fitur disalurkan melalui tim Dukungan Vertice. Masalah keamanan harus dilaporkan langsung ke [email protected].