Ini adalah panduan lengkap untuk mengirimkan server lokal Anda (MCPB) ke direktori publik Anthropic untuk distribusi dan penemuan yang lebih luas.
Prasyarat
Sebelum membaca panduan ini, Anda harus memiliki:
MCPB yang berfungsi
Kode portabel menggunakan substitusi variabel
Pesan kesalahan yang baik dan pengalaman pengguna
Dependensi yang bersih dan terbundel
Baru dalam pengembangan MCPB? Lihat Building MCPB Extensions terlebih dahulu. Untuk praktik terbaik teknis (pengujian, pesan kesalahan, portabilitas), lihat MCPB Repository.
Catatan: Panduan ini mencakup server MCP lokal. Untuk ekstensi desktop jarak jauh, lihat Remote MCP Server Submission Guide.
1. Ikhtisar Direktori
Apa manfaat dari penyertaan direktori?
Penemuan dan kepercayaan:
Terdaftar dalam direktori resmi Anthropic di dalam Claude Desktop
Dapat dicari oleh pengguna Claude Desktop individual
Terlihat oleh pengguna Teams/Enterprise ketika ditambahkan ke daftar izin oleh admin
Tinjauan Anthropic membangun kepercayaan pengguna
Pengalaman pengguna:
Instalasi sekali klik dari direktori
Terintegrasi dengan UI pengaturan Claude Desktop
Presentasi standar
Dukungan dan kredibilitas:
Tinjauan Anthropic tentang kualitas dan keamanan
Terdaftar bersama ekstensi terverifikasi lainnya
Visibilitas komunitas dan umpan balik
Saluran distribusi profesional
2. Persyaratan Wajib
Semua persyaratan di bagian ini wajib untuk persetujuan direktori. Kehilangan salah satu dari ini akan menghasilkan penolakan atau permintaan revisi.
Catatan: Ini adalah persyaratan khusus direktori Anthropic.
Untuk praktik terbaik pengembangan MCPB umum (pengujian, penanganan kesalahan, portabilitas), lihat MCPB Repository README.
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 MCP Protocol - Tool Annotations untuk skema lengkap dan detail implementasi.
Tidak opsional. Ini adalah persyaratan keras yang berasal dari MCP Directory Policy.
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 hanya secara internal | readOnlyHint: true | Optimasi internal OK |
Detail implementasi: Lihat MCP Protocol - Tools 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 yang kami periksa dan alasan paling umum untuk permintaan revisi.
Anot