Lewati ke konten utama

Membangun Konektor Kustom melalui Server MCP Jarak Jauh

Diperbarui kemarin

Konektor khusus menggunakan remote MCP tersedia di Claude dan Claude Desktop untuk pengguna dengan paket Pro, Max, Team, dan Enterprise.

Membangun Server MCP Jarak Jauh

Untuk memulai dengan server jarak jauh, mulai dengan sumber daya berikut:

Sumber daya lainnya (seperti ini) juga dapat membantu untuk mempelajari pertimbangan saat membangun, menerapkan, dan mengatasi masalah server jarak jauh.

Selain itu, beberapa solusi seperti Cloudflare menyediakan hosting server MCP jarak jauh dengan autoscaling bawaan, manajemen token OAuth, dan deployment.

Dukungan MCP

Platform

  • Server MCP jarak jauh didukung di Claude dan Claude Desktop untuk paket Pro, Max, Team, dan Enterprise.

    • Untuk mengonfigurasi server MCP jarak jauh untuk digunakan di Claude Desktop, tambahkan melalui Settings > Connectors. Claude Desktop tidak akan terhubung ke server jarak jauh yang dikonfigurasi langsung melalui claude_desktop_config.json.

  • Sejak Juli, Claude untuk iOS dan Android juga mendukung server MCP jarak jauh!

    • Pengguna dapat menggunakan tools, prompts, dan resources dari server jarak jauh yang telah mereka tambahkan melalui claude.ai. Pengguna tidak dapat menambahkan server baru langsung dari Claude Mobile.

Transport dan Auth

  • Claude mendukung server jarak jauh berbasis SSE dan Streamable HTTP, meskipun dukungan untuk SSE mungkin akan dihentikan dalam beberapa bulan mendatang.

  • Claude mendukung server jarak jauh berbasis authless dan OAuth.

Dukungan Auth

  • Claude mendukung spesifikasi auth 3/26 dan (sejak Juli) spesifikasi auth 6/18.

  • Claude mendukung Dynamic Client Registration (DCR).

    • Server OAuth dapat memberi sinyal kepada Claude bahwa klien DCR telah dihapus dan Claude harus mendaftarkan ulang klien dengan mengembalikan HTTP 401 dengan error invalid_client dari token endpoint, seperti yang dijelaskan dalam RFC 6749.

    • Sejak Juli, pengguna juga dapat menentukan ID klien dan rahasia klien khusus saat mengonfigurasi server yang tidak mendukung DCR.

  • URL callback OAuth Claude adalah https://claude.ai/api/mcp/auth_callback dan nama klien OAuth-nya adalah Claude.

    • URL callback ini mungkin akan berubah menjadi https://claude.com/api/mcp/auth_callback di masa depan – jika Anda memilih untuk allowlist URL callback klien MCP, harap allowlist URL callback ini juga untuk memastikan server Anda terus bekerja dengan Claude.

  • Claude mendukung token expiry dan refresh – server harus mendukung fungsionalitas ini untuk memberikan pengalaman terbaik bagi pengguna.

Lihat di sini untuk alamat IP yang digunakan Claude untuk koneksi inbound dan outbound ke server MCP. Developer server yang ingin melarang MCP Client non-Claude dapat allowlist alamat IP ini, URL callback OAuth Claude, dan/atau nama klien OAuth Claude.

Fitur Protokol

  • Claude mendukung tools, prompts, dan resources.

    • Claude mendukung hasil tool berbasis teks dan gambar.

    • Claude mendukung resources berbasis teks dan biner.

  • Claude belum mendukung resource subscriptions, sampling, dan kemampuan lanjutan atau draft lainnya.

Menguji Server MCP Jarak Jauh

Cara terbaik untuk menguji dan memvalidasi server adalah dengan mencoba menambahkannya ke Claude.

Alternatifnya, gunakan alat inspector. Ini akan memungkinkan Anda memvalidasi:

  • bahwa server Anda berhasil menginisialisasi dan menyelesaikan alur

Apakah pertanyaan Anda terjawab?