Ini adalah panduan lengkap untuk mengirimkan server MCP jarak jauh Anda ke Direktori MCP Anthropic untuk distribusi dan penemuan yang lebih luas.
Prasyarat
Sebelum pengiriman server, Anda harus memiliki:
Server MCP jarak jauh yang berfungsi dan telah diuji sepenuhnya
Autentikasi OAuth 2.0 yang diimplementasikan (jika autentikasi diperlukan)
Semua alat dengan anotasi keamanan yang tepat
Penyebaran siap produksi
Saluran dukungan khusus (email atau web)
Akun pengujian yang disediakan dengan data sampel
Dokumentasi komprehensif
Baru mengenal pengembangan MCP jarak jauh? Lihat Memulai dengan Konektor Kustom Menggunakan Remote MCP terlebih dahulu. Untuk praktik terbaik teknis dan detail protokol, lihat Dokumentasi Protokol MCP.
Catatan: Panduan ini mencakup server MCP jarak jauh (cloud-hosted, HTTPS). Untuk ekstensi desktop lokal, lihat Panduan Pengiriman Server MCP Lokal.
1. Ikhtisar Direktori
Apa manfaat dari penyertaan direktori?
Penemuan dan kepercayaan:
Terdaftar di Direktori MCP resmi Anthropic yang dapat diakses dari Claude.ai
Dapat diakses oleh pengguna Claude di semua platform (web, desktop, mobile)
Visibilitas profesional untuk layanan Anda
Pengalaman pengguna:
Koneksi satu klik dari direktori
Terintegrasi dengan antarmuka konektor Claude
Presentasi standar di semua platform
Alur OAuth ditangani dengan mulus
Dukungan dan kredibilitas:
Tinjauan Anthropic tentang kualitas, keamanan, dan kepatuhan
Terdaftar bersama konektor terverifikasi lainnya
Visibilitas komunitas dan umpan balik
Saluran distribusi profesional
Platform Claude mana yang mendukung server MCP jarak jauh?
Semua platform Claude utama:
Claude.ai (web) - Dukungan penuh dengan OAuth
Claude Desktop - Dukungan penuh dengan OAuth
Claude Code - Koneksi langsung dari mesin pengguna (dengan dukungan OAuth)
Claude API - Dukungan integrasi
Aplikasi Claude Mobile - Dukungan konektor
2. Persyaratan Wajib
Semua persyaratan di bagian ini wajib untuk persetujuan direktori. Kehilangan salah satu dari ini akan menghasilkan penolakan atau permintaan revisi.
Apakah anotasi keamanan diperlukan?
YA - Setiap alat HARUS memiliki anotasi keamanan yang akurat.
Diperlukan pada setiap alat:
readOnlyHint: true - Untuk alat yang hanya membaca data
destructiveHint: true - Untuk alat yang memodifikasi data atau memiliki efek samping
Lihat MCP Protocol - Anotasi Alat untuk skema lengkap dan detail implementasi.
Tidak opsional. Ini adalah persyaratan keras yang berasal dari Kebijakan Direktori MCP.
Cara memutuskan anotasi mana:
Perilaku Alat | Anotasi | Contoh |
Hanya membaca data | readOnlyHint: true, destructiveHint: false | search, get, list, fetch, read |
Menulis/memodifikasi data | destructiveHint: true, readOnlyHint: false | create, update, delete, send |
Membuat file sementara | destructiveHint: true | Bahkan penulisan sementara dihitung |
Mengirim permintaan eksternal | destructiveHint: true | Email, notifikasi, webhook |
Cache hanya secara internal | readOnlyHint: true | Optimasi internal OK |
Anotasi tambahan yang direkomendasikan:
title - Nama alat yang dapat dibaca manusia untuk tampilan UI (meningkatkan pengalaman pengguna)
Apakah saya perlu menyediakan akun pengujian?
YA - Jika server Anda memerlukan autentikasi.
Apa yang harus disediakan:
Kredensial akun pengujian (nama pengguna/kata sandi atau kunci API)
Data sampel di akun (diperlukan untuk pengujian fungsional)
Instruksi pengaturan untuk lingkungan pengujian
Batasan akses (jika ada)
Akun pengujian harus memiliki:
Akses ke semua alat yang sedang ditinjau
Data sampel yang representatif
Izin yang sesuai untuk pengujian fungsionalitas penuh
Status aktif selama periode tinjauan dan seterusnya
Cara menyediakan:
Sertakan kredensial dalam formulir pengiriman (idealnya dibagikan melalui metode aman, seperti tautan 1Password)
Pastikan akun tetap aktif selama dan setelah tinjauan untuk tinjauan pasca-penerimaan berkala
Berikan akses yang cukup untuk pengujian komprehensif
Apakah OAuth 2.0 diperlukan?
YA - Jika server Anda memerlukan autentikasi.
Persyaratan implementasi OAuth:
Harus menggunakan alur kode otorisasi OAuth 2.0
Sertifikat dari otoritas yang diakui
Daftar putih klien MCP lokal (misalnya Claude Code, MCP Inspector) URL callback:
http://localhost:6274/oauth/callback
http://localhost:6274/oauth/callback/debug
Daftar putih URL callback Claude:
Konfigurasi URI pengalihan yang tepat
Masalah OAuth umum yang harus dihindari:
Kesalahan URI pengalihan tidak valid (pastikan kedua URL callback ada di daftar putih)
Permintaan HEAD tanpa token (tangani dengan baik setelah alur OAuth)
Panduan implementasi: Lihat Kerangka Kerja Otorisasi OAuth 2.0 untuk detail implementasi OAuth lengkap.
Apakah ada persyaratan firewall?
YA - Harus daftar putih alamat IP Claude untuk kompatibilitas claude.ai
Untuk server di belakang firewall, daftar putih alamat IP dari https://docs.claude.com/en/api/ip-addresses.
Diperlukan untuk: Claude.ai dan Claude Desktop
Tidak diperlukan untuk: Claude Code (terhubung langsung dari mesin pengguna)
Penting: Daftar putih IP saja tidak direkomendasikan sebagai ukuran keamanan. Gunakan OAuth 2.0 untuk autentikasi kapan pun memungkinkan.
Dokumentasi apa yang diperlukan?
Dokumentasi server komprehensif dengan bagian spesifik.
Bagian yang direkomendasikan:
Deskripsi Server - Penjelasan jelas tentang apa yang dilakukan server Anda
Fitur - Kemampuan kunci dan kasus penggunaan
Instruksi Pengaturan - Cara pengguna terhubung dan mengonfigurasi
Autentikasi - Pengaturan OAuth dan persyaratan (jika berlaku)
Contoh Penggunaan - Minimum 3 contoh kerja dengan prompt (diperlukan)
Kebijakan Privasi - Tautan ke kebijakan privasi lengkap
Dukungan - Cara pengguna dapat mendapatkan bantuan atau melaporkan masalah
Contoh struktur dokumentasi:
# Server MCP [Nama Layanan Anda]
## Deskripsi
[Deskripsi singkat tentang integrasi layanan dan kemampuan]
## Fitur
- Fitur 1: [deskripsi dan nilai]
- Fitur 2: [deskripsi dan nilai]
- Fitur 3: [deskripsi dan nilai]
## Pengaturan
1. Kunjungi [Direktori MCP Anthropic](https://claude.com/connectors)
2. Temukan dan terhubung ke [Layanan Anda]
3. Selesaikan autentikasi OAuth
4. Konfigurasikan pengaturan yang diperlukan
## Autentikasi
Server ini memerlukan autentikasi OAuth. Anda akan membutuhkan:
- Akun [Layanan Anda] yang valid
- [Izin spesifik atau jenis akun apa pun]
## Contoh
[Lihat bagian minimum 3 contoh di bawah]
## Kebijakan Privasi
Lihat kebijakan privasi kami: https://domain-anda.com/privacy
## Dukungan
- Email: [email protected]
- Dokumentasi: https://domain-anda.com/mcp-docs
- Masalah: https://github.com/perusahaan-anda/mcp-server/issues
Berapa banyak contoh penggunaan yang diperlukan?
MINIMUM tiga contoh kerja yang mendemonstrasikan fungsionalitas inti.
Apa yang memenuhi syarat sebagai contoh yang baik:
Menunjukkan prompt/permintaan pengguna yang realistis
Mendemonstrasikan fungsionalitas server aktual
Mencakup output atau perilaku yang diharapkan
Alur kerja yang jelas dan dapat dipahami
Mencakup kemampuan yang berbeda
Format contoh:
## Contoh
### Contoh 1: Cari dokumen
**Prompt pengguna:** "Temukan laporan proyek terbaru di ruang kerja saya"
**Yang terjadi:**
- Server mencari ruang kerja Anda
- Mengembalikan dokumen yang cocok dengan metadata
- Menyediakan tautan akses cepat
### Contoh 2: Buat konten baru
**Prompt pengguna:** "Buat daftar tugas baru untuk kampanye pemasaran"
**Yang terjadi:**
- Server membuat daftar tugas baru
- Menambahkan struktur awal berdasarkan konteks
- Mengembalikan tautan ke daftar yang baru dibuat
### Contoh 3: Perbarui data yang ada
**Prompt pengguna:** "Perbarui status proyek menjadi 'Sedang Berlangsung' dan tambahkan pencapaian hari ini"
**Yang terjadi:**
- Server menemukan proyek
- Memperbarui bidang status
- Menambahkan pencapaian dengan tanggal saat ini
- Mengonfirmasi perubahan yang dibuat
Persyaratan:
Minimum 3 contoh (tidak ada maksimum)
Mencakup alat/kemampuan yang berbeda
Menunjukkan interaksi pengguna yang realistis
Mendemonstrasikan proposisi nilai
Sertakan dalam dokumentasi server
Apa persyaratan kesiapan produksi?
Server harus dalam status Ketersediaan Umum (GA).
Siap produksi berarti:
Server stabil dan andal dalam produksi
Tidak ditandai sebagai "beta," "alpha," atau "pengembangan"
Semua fitur sepenuhnya diimplementasikan dan diuji
Penanganan kesalahan yang tepat dan kegagalan yang elegan
Infrastruktur yang dapat diskalakan dan pemantauan
Dokumentasi lengkap dan saluran dukungan
Tidak dapat disertakan: Versi beta, server pengembangan, atau layanan akses terbatas.
Apa persyaratan teknis yang harus dipenuhi?
Harus memenuhi standar kepatuhan teknis inti.
Transportasi dan Kinerja:
Harus mendukung transportasi HTTP yang dapat dialirkan (dukungan SSE mungkin tidak digunakan lagi)
Waktu respons cepat dengan ketersediaan tinggi
Penanganan kesalahan yang elegan dengan pesan yang membantu
Respons yang efisien token (maksimal 25.000 token per hasil alat)
Keamanan dan Data:
HTTPS/TLS dengan sertifikat yang valid
CORS dikonfigurasi dengan benar untuk klien browser
Dukungan untuk semua asal klien Claude yang diperlukan
Kumpulkan hanya data yang diperlukan untuk fungsionalitas
Tidak ada pengumpulan data percakapan yang tidak perlu
Praktik data yang mematuhi privasi
3. Proses Pengiriman
Bagaimana cara saya mengirimkan server MCP jarak jauh saya?
Ikuti proses pengiriman langkah demi langkah ini:
1. Daftar periksa pra-pengiriman:
Verifikasi persyaratan wajib:
[ ] Semua alat memiliki anotasi readOnlyHint ATAU destructiveHint
[ ] OAuth 2.0 diimplementasikan (jika autentikasi diperlukan)
[ ] Server dapat diakses melalui HTTPS
[ ] Alamat IP Claude ada di daftar putih (jika server di belakang firewall)
[ ] Dokumentasi komprehensif dipublikasikan
[ ] Kebijakan privasi dipublikasikan dan dapat diakses
[ ] Saluran dukungan khusus (email atau web)
[ ] Akun pengujian siap (jika autentikasi diperlukan)
[ ] Server siap produksi (status GA)
Uji server Anda:
[ ] Berfungsi dengan benar dari Claude.ai
[ ] Berfungsi dengan benar dari Claude Desktop
[ ] Berfungsi dengan benar dari Claude Code (jika tidak ada pembatasan IP)
[ ] Alur OAuth selesai dengan sukses
[ ] Semua alat berfungsi seperti yang didokumentasikan
[ ] Pesan kesalahan membantu dan ramah pengguna
[ ] Kinerja dapat diterima di bawah beban
2. Lengkapi formulir pengiriman:
Formulir pengiriman: Formulir Tinjauan Server Direktori MCP
Informasi yang diperlukan: Detail server, tautan dokumentasi, kredensial pengujian, contoh (minimum 3), dan informasi kontak. Formulir menyediakan daftar lengkap.
Meskipun kami berusaha meninjau setiap pengiriman secepat mungkin, karena banyaknya minat kami tidak dapat menjanjikan bahwa kami akan menerima pengiriman Anda atau merespons secara individual.
4. Masalah Umum
Apa alasan paling umum untuk permintaan revisi?
Ini adalah masalah teratas berdasarkan data pengiriman:
1. Anotasi alat yang hilang
Masalah: Alat kehilangan anotasi keamanan yang diperlukan
Perbaikan: Tambahkan readOnlyHint atau destructiveHint ke SEMUA alat
Dampak: Penolakan langsung, memerlukan perubahan kode
Pencegahan: Validasi semua alat sebelum pengiriman
2. Masalah implementasi OAuth
Masalah: Alur OAuth gagal atau memiliki kesalahan konfigurasi
Penyebab umum:
URL callback yang hilang di penyedia OAuth
Konfigurasi URI pengalihan tidak valid
Kesalahan konfigurasi firewall
Perbaikan: Uji alur OAuth secara menyeluruh dengan MCP Inspector, Claude Code atau Claude.ai
Dampak: Tidak dapat menyelesaikan pengujian fungsional, menunda persetujuan
3. Dokumentasi tidak lengkap
Masalah: Contoh yang hilang, instruksi pengaturan yang tidak jelas, atau bagian yang diperlukan hilang
Perbaikan: Berikan minimum 3 contoh terperinci dan lengkapi semua bagian dokumentasi
Dampak: Permintaan revisi, menunda persetujuan
Pencegahan: Ikuti template dokumentasi dengan tepat
4. Masalah kesiapan produksi
Masalah: Server ditandai sebagai "beta" atau menunjuk