Lewati ke konten utama

Panduan Pengajuan Server MCP Lokal

Diperbarui minggu ini

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

Apakah pertanyaan Anda terjawab?