Konektor MCP
Fitur konektor Model Context Protocol (MCP) Claude memungkinkan Anda terhubung ke server MCP jarak jauh langsung dari Messages API tanpa perlu klien MCP terpisah.
Fitur ini memerlukan header beta: "anthropic-beta": "mcp-client-2025-04-04"
Fitur utama
- Integrasi API langsung: Terhubung ke server MCP tanpa perlu mengimplementasikan klien MCP
- Dukungan pemanggilan alat: Akses alat MCP melalui Messages API
- Autentikasi OAuth: Dukungan untuk token Bearer OAuth untuk server yang terautentikasi
- Beberapa server: Terhubung ke beberapa server MCP dalam satu permintaan
Batasan
- Dari rangkaian fitur spesifikasi MCP, saat ini hanya pemanggilan alat yang didukung.
- Server harus terekspos secara publik melalui HTTP. Server STDIO lokal tidak dapat terhubung secara langsung.
- Konektor MCP saat ini tidak didukung di Amazon Bedrock dan Google Vertex.
Menggunakan konektor MCP di Messages API
Untuk terhubung ke server MCP jarak jauh, sertakan parameter mcp_servers
dalam permintaan Messages API Anda:
Konfigurasi server MCP
Setiap server MCP dalam array mcp_servers
mendukung konfigurasi berikut:
Deskripsi bidang
Properti | Tipe | Wajib | Deskripsi |
---|---|---|---|
type | string | Ya | Saat ini hanya “url” yang didukung |
url | string | Ya | URL server MCP. Harus dimulai dengan https:// |
name | string | Ya | Pengidentifikasi unik untuk server MCP ini. Ini akan digunakan dalam blok mcp_tool_call untuk mengidentifikasi server dan untuk membedakan alat bagi model. |
tool_configuration | object | Tidak | Mengonfigurasi penggunaan alat |
tool_configuration.enabled | boolean | Tidak | Apakah akan mengaktifkan alat dari server ini (default: true) |
tool_configuration.allowed_tools | array | Tidak | Daftar untuk membatasi alat yang diizinkan (secara default, semua alat diizinkan) |
authorization_token | string | Tidak | Token otorisasi OAuth jika diperlukan oleh server MCP. Lihat Spesifikasi MCP. |
Tipe konten respons
Ketika Claude menggunakan alat MCP, respons akan menyertakan dua tipe blok konten baru:
Blok Penggunaan Alat MCP
Blok Hasil Alat MCP
Beberapa server MCP
Anda dapat terhubung ke beberapa server MCP dengan menyertakan beberapa objek dalam array mcp_servers
:
Autentikasi
Untuk server MCP yang memerlukan autentikasi OAuth, Anda perlu mendapatkan token akses. Beta konektor MCP mendukung pengiriman parameter authorization_token
dalam definisi server MCP.
Konsumen API diharapkan menangani alur OAuth dan mendapatkan token akses sebelum melakukan panggilan API, serta memperbarui token sesuai kebutuhan.
Mendapatkan token akses untuk pengujian
MCP inspector dapat memandu Anda melalui proses mendapatkan token akses untuk tujuan pengujian.
-
Jalankan inspector dengan perintah berikut. Anda memerlukan Node.js yang terinstal di mesin Anda.
-
Di sidebar sebelah kiri, untuk “Transport type”, pilih “SSE” atau “Streamable HTTP”.
-
Masukkan URL server MCP.
-
Di area kanan, klik tombol “Open Auth Settings” setelah “Need to configure authentication?”.
-
Klik “Quick OAuth Flow” dan otorisasi pada layar OAuth.
-
Ikuti langkah-langkah di bagian “OAuth Flow Progress” dari inspector dan klik “Continue” sampai Anda mencapai “Authentication complete”.
-
Salin nilai
access_token
. -
Tempelkan ke dalam bidang
authorization_token
dalam konfigurasi server MCP Anda.
Menggunakan token akses
Setelah Anda mendapatkan token akses menggunakan salah satu alur OAuth di atas, Anda dapat menggunakannya dalam konfigurasi server MCP Anda:
Untuk penjelasan mendetail tentang alur OAuth, lihat Bagian Otorisasi dalam spesifikasi MCP.