Ini adalah panduan lengkap untuk mengirimkan server lokal Anda (MCPB) ke direktori publik Anthropic untuk distribusi dan kemudahan ditemukan yang lebih luas.
Prasyarat
Sebelum membaca panduan ini, Anda harus memiliki:
MCPB yang berfungsi
Kode portabel menggunakan substitusi variabel
Pesan kesalahan dan pengalaman pengguna yang baik
Dependensi yang bersih dan terbundel
Baru dalam pengembangan MCPB? Lihat Membangun Ekstensi MCPB terlebih dahulu. Untuk praktik terbaik teknis (pengujian, pesan kesalahan, portabilitas), lihat Repositori MCPB.
Catatan: Panduan ini mencakup server MCP lokal. Untuk ekstensi desktop jarak jauh, lihat Panduan Pengiriman Server MCP Jarak Jauh.
1. Gambaran Umum Direktori
Apa manfaat dari inklusi direktori?
Kemudahan ditemukan dan kepercayaan:
Terdaftar dalam direktori resmi Anthropic di dalam Claude Desktop
Dapat dicari oleh pengguna individu Claude Desktop
Terlihat oleh pengguna Teams/Enterprise ketika ditambahkan ke daftar izin oleh admin
Tinjauan Anthropic membangun kepercayaan pengguna
Pengalaman pengguna:
Instalasi satu klik dari direktori
Terintegrasi dengan UI pengaturan Claude Desktop
Presentasi yang terstandarisasi
Dukungan dan kredibilitas:
Tinjauan Anthropic terhadap kualitas dan keamanan
Terdaftar bersama ekstensi lain yang telah ditinjau
Visibilitas dan umpan balik komunitas
Saluran distribusi profesional
2. Persyaratan Wajib
Semua persyaratan di bagian ini wajib untuk persetujuan direktori. Kehilangan salah satu dari ini akan mengakibatkan penolakan atau permintaan revisi.
Catatan: Ini adalah persyaratan khusus direktori Anthropic.
Untuk praktik terbaik pengembangan MCPB umum (pengujian, penanganan kesalahan, portabilitas), lihat README Repositori MCPB.
Apakah anotasi alat diperlukan?
YA. Setiap alat HARUS memiliki dan mempertahankan 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 Protokol MCP - 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 | search, get, list, fetch, read |
Menulis/memodifikasi data | destructiveHint: true | create, update, delete, send, write |
Membuat file sementara | destructiveHint: true | Bahkan penulisan sementara dihitung |
Mengirim permintaan eksternal | destructiveHint: true | Email, notifikasi, webhook |
Cache internal saja | readOnlyHint: true | Optimasi internal OK |
Detail implementasi: Lihat Protokol MCP - Alat untuk:
Skema alat lengkap dengan anotasi
Struktur definisi alat
Spesifikasi skema input/output
Properti alat tambahan (termasuk bidang judul opsional)
Validasi sebelum pengiriman:
# Periksa semua alat memiliki anotasi
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# Verifikasi setiap alat memiliki tepat satu anotasi
Dampak: Hal pertama
