Lewati ke konten utama

Direktori Konektor Anthropic - Pertanyaan Umum

Diperbarui lebih dari satu minggu yang lalu

Apa itu MCP?

MCP adalah singkatan dari Model Context Protocol, standar terbuka yang dibuat oleh Anthropic yang memungkinkan aplikasi AI untuk terhubung ke alat dan sumber data. Untuk informasi lengkap tentang MCP dan cara memulai, silakan lihat panduan MCP jarak jauh kami: Getting Started with Custom Connectors Using Remote MCP.

Apa itu Direktori Konektor?

Direktori Konektor bertujuan untuk menampilkan server Model Context Protocol yang bekerja dengan Claude di semua platform kami - Claude web, Claude Desktop, aplikasi Claude mobile kami, Claude Code, dan API kami. Direktori Konektor berfungsi sebagai pusat tunggal di mana pengguna dapat menemukan server MCP yang telah ditinjau oleh Anthropic.

Bagaimana cara saya mendapatkan MCP saya terdaftar di direktori?

Anda dapat mengisi formulir tinjauan server Direktori Konektor kami dan kami akan menghubungi Anda tentang langkah selanjutnya jika MCP Anda akan menjadi kecocokan yang baik untuk direktori pada saat ini.

Apakah ada standar yang harus dipatuhi MCP saya untuk dimasukkan dalam direktori?

Ya, server harus mematuhi standar keamanan, keselamatan, dan kompatibilitas yang diuraikan dalam Kebijakan Direktori MCP kami. Kepatuhan terhadap standar ini tidak menjamin penyertaan dalam direktori.

Saya telah mengisi formulir pengajuan tetapi belum mendengar kabar, berapa lama waktu yang diperlukan?

Meskipun kami berusaha untuk meninjau setiap pengajuan secepat mungkin, karena minat yang luar biasa besar, kami tidak dapat menjanjikan bahwa kami akan menerima pengajuan Anda atau merespons secara individual.

1. Autentikasi dan Otorisasi

Apakah OAuth 2.0 diperlukan jika kami tidak memerlukan autentikasi pengguna?

OAuth 2.0 hanya diperlukan jika autentikasi diperlukan untuk server MCP. Server yang tidak memerlukan autentikasi tidak memerlukan OAuth.

Apakah Claude mendukung alur OAuth mesin-ke-mesin (kredensial klien)?

Tidak. Alur kredensial klien murni (OAuth mesin-ke-mesin dengan hanya client_id/client_secret dan tanpa interaksi pengguna) tidak didukung. Kami dapat menyediakan client_id/client_secret statis untuk Claude, tetapi pengguna masih harus menyelesaikan alur persetujuan OAuth untuk mengautentikasi akun individual mereka. Ini berfungsi di claude.ai dan Claude Desktop, tetapi bukan Claude Code karena Claude Code membuat koneksi langsung dari komputer pengguna ke server MCP Anda (dan dengan demikian tidak memiliki akses ke kredensial statis).

Bisakah kami mengidentifikasi pengguna individual tanpa menerapkan OAuth?

Tidak. OAuth adalah satu-satunya cara untuk mengidentifikasi pengguna secara unik. Kami tidak meneruskan alamat IP, ID pengguna, atau metadata lainnya dari pengguna akhir ke server MCP.

Di mana komunikasi server MCP terjadi - sisi klien atau server Anthropic?

Itu tergantung pada permukaan produk. Komunikasi terjadi melalui server Anthropic (claude.ai, Claude Desktop), browser pengguna, atau klien lokal pengguna (Claude Code). Saat ini tidak ada metode koneksi terpusat di semua permukaan.

Bisakah pengguna mengautentikasi dengan kredensial pribadi dari dalam akun Claude perusahaan?

Ya. Pengguna mengautentikasi dengan server MCP berdasarkan per-server. Mereka dapat menggunakan kredensial autentikasi pribadi untuk server MCP bahkan ketika masuk ke claude.ai dengan akun perusahaan.

Bisakah kami menerapkan OAuth per-alat alih-alih OAuth per-server?

Tidak. OAuth terjadi ketika klien terhubung ke server MCP, bukan pada tingkat alat. Anda dapat memberlakukan izin tingkat alat berdasarkan autentikasi pengguna setelah koneksi server dibuat.

Ketika pengguna memutuskan sambungan alat MCP, apakah token OAuth dicabut?

Token dihapus dari sistem Anthropic tetapi bukan dari sistem Anda sendiri. Token akses dan penyegaran di penyedia identitas Anda tetap valid hingga kedaluwarsa, dan cookie sesi tidak dihapus (karena merupakan tingkat browser, di luar kontrol Claude).

Bagaimana layanan MCP kami dapat memberi sinyal kepada Claude bahwa sesi pengguna tidak valid?

Kembalikan respons 401 Unauthorized. Untuk memicu regenerasi penuh kredensial klien DCR, kembalikan kesalahan invalid_client sesuai dengan RFC 6749 bagian 5.2.

Apakah client_id/client_secret diperlukan untuk alur OAuth standar?

Tidak. Kredensial klien tidak diperlukan untuk alur OAuth standar dengan autentikasi pengguna.

2. Pembatasan Laju dan Pencegahan Penyalahgunaan

Bagaimana cara kami menerapkan pembatasan laju per-pengguna tanpa OAuth?

Pembatasan laju per-pengguna memerlukan OAuth. Tanpa OAuth, pilihan Anda adalah:

  • Opsi 1: Tidak ada autentikasi dengan pembatasan laju global

  • Opsi 2: Daftar putih IP menggunakan IP statis Claude

Bisakah kami menggunakan daftar putih IP untuk membatasi akses server MCP hanya untuk pengguna Claude?

Kami sangat merekomendasikan menggunakan OAuth dan tidak menggunakan daftar putih IP. Namun, ini dimungkinkan menggunakan alamat IP statis yang tersedia di https://docs.claude.com/en/api/ip-addresses.

Batasan penting:

  • Hanya berfungsi untuk claude.ai dan Claude Desktop. Server MCP Anda tidak akan berfungsi di Claude Code.

  • IP egress dapat berubah - pemberitahuan perubahan sebelumnya akan diposting di dokumen

  • Tidak direkomendasikan sebagai satu-satunya ukuran keamanan, tetapi dapat digunakan ketika OAuth tidak layak

Apakah Claude menyediakan pembatasan laju atau perlindungan DDoS untuk server MCP?

Tidak. Pemilik server MCP harus menerapkan pembatasan laju dan ukuran pencegahan penyalahgunaan mereka sendiri.

3. Batas Teknis dan Kendala

Berapa ukuran token maksimum untuk hasil alat MCP?

25.000 token. Gunakan paginasi, penyaringan, atau parameter batas untuk mengurangi ukuran respons jika diperlukan.

Apa batas waktu habis untuk alat MCP?

Waktu habis bervariasi menurut komponen:

  • Claude Code: Dapat dikonfigurasi melalui pengaturan MCP_TOOL_TIMEOUT

  • Claude.ai dan Claude Desktop: 300 detik (5 menit)

4. Pengajuan Direktori dan Persyaratan

Jenis paket Claude mana yang dapat mengakses Konektor?

Semua pengguna dapat mengakses konektor, kecuali untuk konektor khusus, yang hanya tersedia untuk paket berbayar (Pro, Max, Team, dan Enterprise).

Apakah kami memerlukan paket Claude tertentu untuk mengirimkan MCP ke direktori?

Tidak. Organisasi apa pun dapat mengirimkan ke direktori terlepas dari jenis paket.

Apakah kami perlu memberikan Anthropic akun pengujian?

Jika server Anda memerlukan autentikasi / akun untuk digunakan, kami akan memerlukan Anda untuk memberikan kami akun pengujian untuk tujuan QA awal. Menyertakan data dummy dalam akun juga membantu untuk memeriksa fungsionalitas.

Berapa banyak alat yang harus disediakan server MCP?

Tidak ada persyaratan minimum atau maksimum. Kami merekomendasikan agar Anda memulai dengan serangkaian alat yang berguna dan memperluas kemampuan seiring waktu.

Apa persyaratan kinerja untuk server MCP?

Saat ini tidak ada persyaratan SLA khusus. Namun, konektor dengan masalah kinerja atau keandalan dapat dihapus dari direktori.

Apa alasan paling umum pengajuan MCP ditunda atau ditolak?

Masalah teratas: Anotasi alat yang hilang (30% penolakan)

Persyaratan: Semua alat HARUS menyertakan readOnlyHint atau destructiveHint

Dampak: Penolakan langsung, memerlukan perubahan kode.

Tidak opsional: Persyaratan kepatuhan per Kebijakan Direktori MCP

Contoh:

{
"name": "read_data",
"readOnlyHint": true
}

5. Privasi Data dan Hukum

Telemetri apa yang dikumpulkan Anthropic dari panggilan alat MCP?

Telemetri mencakup semua parameter dan data yang diteruskan ke panggilan alat serta respons dari server MCP.

Apakah data MCP digunakan untuk melatih model Claude?

Kami hanya melatih data konsumen ketika pengguna secara eksplisit memilih untuk ikut serta. Lihat https://www.anthropic.com/news/updates-to-our-consumer-terms untuk detail. Kami tidak melatih pada paket Team/Enterprise.

Bisakah server MCP mengidentifikasi SKU Claude mana yang digunakan pengguna?

Tidak. Server MCP tidak dapat menentukan SKU Claude yang digunakan.

Apa arti 'URL Perjanjian Pemrosesan Data' dalam formulir pengajuan?

Berikan URL ke syarat pemrosesan data perusahaan Anda yang berlaku untuk layanan MCP. Ini tidak perlu spesifik MCP - DPA standar Anda dapat diterima.

Apakah konektor tersedia secara global? Bisakah kami membatasi berdasarkan geografi?

Konektor tersedia untuk pengguna Claude secara global. Pembatasan geografis tidak didukung. Anda dapat memandu pemahaman pengguna dan Claude tentang batasan geografis apa pun untuk deskripsi MCP atau deskripsi alat Anda jika diperlukan (misalnya, 'hanya organisasi AS yang tersedia').

Di mana saya dapat menemukan Syarat Layanan Direktori MCP dan kebijakan data?

Sumber daya utama:

Apa persyaratan kepatuhan perlindungan data (misalnya GDPR, CCPA, LGPD) untuk server MCP?

Server MCP harus menangani kepatuhan secara independen dari Claude. Jika pengguna menggunakan hak perlindungan data hukum dengan layanan Anda, Anda harus menangani ini di pihak Anda.

Di mana saya harus menyertakan kebijakan privasi untuk konektor lokal (ekstensi desktop)?

Di .mcpb Anda, ada dua lokasi yang diperlukan:

1. README.md - Tambahkan bagian "Kebijakan Privasi" dengan URL atau teks lengkap.

2. manifest.json - Tambahkan array privacy_policies dengan URL HTTPS (memerlukan manifest_version 0.2+)

Contoh:

{
"manifest_version": "0.2",
"privacy_policies": ["https://your-domain.com/privacy"],
...
}

Harus mencakup: Data apa yang dikumpulkan, bagaimana penggunaan/penyimpanannya, berbagi pihak ketiga, retensi, dan informasi kontak. ⚠️ Kebijakan privasi yang hilang akan menyebabkan penolakan langsung.

6. Pengalaman Pengguna dan Branding

Bagaimana cara kami memperbarui ikon konektor kami?

Kami menggunakan favicon yang disediakan Google, jadi Anda dapat menyesuaikan URL ikon konektor Anda dengan memperbarui favicon untuk URL konektor Anda. Anda dapat memverifikasi ikon yang akan kami gunakan di https://www.google.com/s2/favicons?domain=<YOUR_CONNECTOR_URL>&sz=64

Pastikan untuk menguji setiap ukuran favicon (16, 32, 48, 64, 96, 128) dengan memperbarui bagian &sz= dari URL.

Konektor jarak jauh:

  • Jika menggunakan URL ikon khusus: Perbarui ikon di URL yang disediakan.

  • Jika mengandalkan deteksi otomatis: Ikon ditarik dari favicon yang diindeks Google di URL server MCP Anda. Perbarui favicon Anda dan tunggu Google untuk mengindeks ulang.

Jika tidak, berikan kami URL dengan favicon yang ingin Anda gunakan sebagai ikon Anda.

Konektor lokal (ekstensi desktop): Ganti `icon.png` di paket Anda dan distribusikan ulang paket `.mcpb` yang diperbarui kepada pengguna.

Apakah deskripsi konektor di Claude mendukung markdown?

Ya. Pemformatan Markdown didukung dalam deskripsi konektor.

Bisakah kami menyertakan persyaratan akun dan tautan pendaftaran dalam detail konektor?

Ya. Silakan sertakan bahasa persyaratan akun (misalnya, 'akun terdaftar gratis diperlukan') dan hyperlink ke halaman pendaftaran dalam detail konektor.

Bagaimana cara kami memastikan pengguna melihat Syarat Layanan kami sebelum terhubung?

Terapkan layar OAuth. Ini adalah satu-satunya cara untuk menjamin tampilan TOS. Tanpa OAuth, pengguna secara teoritis dapat menambahkan konektor ke Claude Desktop dengan langsung mengedit claude_desktop_config.json.

Bisakah kami menampilkan bahasa persetujuan dengan tautan TOS/Pemberitahuan Privasi selama instalasi?

Sertakan bahasa dalam deskripsi konektor, tetapi tidak ada alur persetujuan khusus atau popup. Gunakan layar OAuth untuk memastikan pengguna melihat dan menyetujui syarat.

7. Implementasi Teknis

Apakah transportasi SSE dapat diterima, atau harus kami menggunakan HTTP yang dapat dialirkan?

Anda harus menggunakan HTTP yang dapat dialirkan.

Bisakah kami menambahkan deskripsi tingkat server atau hanya deskripsi tingkat alat?

Hanya deskripsi tingkat alat yang saat ini didukung. Tidak ada deskripsi tingkat server. Ini memerlukan pengulangan panduan pengarahan di seluruh deskripsi alat individual. Kami menyadari ini tidak nyaman dan sedang mengeksplorasi perbaikan.

Bagaimana cara kami membuat server MCP lokal (.mcpb) tersedia di Claude Code?

Gunakan pasar plugin. Node.js direkomendasikan daripada Python atau bahasa lain untuk MCP lokal karena kompatibilitas yang lebih baik dengan runtime bawaan Claude Desktop.

Apa praktik terbaik observabilitas untuk MCP lokal di Claude Desktop?

MCP lokal hanya dapat mencatat ke ~/Library/Logs/Claude/mcp*.log. Pengguna harus secara manual berbagi file log untuk pemecahan masalah. Transmisi log langsung dari server MCP lokal tidak didukung karena kendala keamanan.

8. Pengujian dan Debugging

Daftar putih IP tidak berfungsi. Bagaimana cara kami men-debug masalah koneksi?

Sementara hapus daftar putih IP untuk memverifikasi konfigurasi lainnya benar. Jika koneksi berfungsi tanpa daftar putih, masalahnya adalah dengan konfigurasi penyaringan IP.

Pengujian apa yang harus kami selesaikan sebelum mengirimkan ke direktori?

Pengujian penting mencegah 80% penundaan pengajuan. Lihat panduan kami untuk mengirimkan konektor jarak jauh dan lokal untuk praktik terbaik dan daftar periksa pra-pengajuan.

9. Pola Implementasi Umum

Pendekatan autentikasi apa yang harus kami gunakan untuk MCP kami?

Pilih berdasarkan persyaratan keamanan dan kendala Anda:

Opsi 1: Tidak Ada Auth + Pembatasan Laju Global

Terbaik untuk: Data publik dengan risiko penyalahgunaan rendah

  • Implementasi paling sederhana, berfungsi di semua permukaan Claude

  • Tidak ada pembatasan laju per-pengguna, dapat diakses oleh internet publik

  • Dapat menambahkan daftar putih IP untuk membatasi lalu lintas hanya Claude

Opsi 2: OAuth Penuh dengan Pendaftaran Pengguna

Terbaik untuk: Keamanan perusahaan, data sensitif, pembatasan laju per-pengguna

  • Paling aman, berfungsi di semua permukaan, identifikasi pengguna penuh

  • Memerlukan sistem pendaftaran pengguna, implementasi lebih kompleks

  • Pendekatan yang direkomendasikan untuk sistem produksi

Opsi 3: Daftar Putih IP

Kami sangat merekomendasikan Opsi 2 daripada Opsi 3, tetapi jika menerapkan OAuth benar-benar tidak layak, Anda masih dapat mendapatkan akses terbatas hanya untuk pengguna Claude

  • Tidak ada kemampuan untuk mengidentifikasi pengguna individual, tetapi membatasi permintaan dari claude.ai dan Claude Desktop.

  • Server MCP tidak akan berfungsi dengan Claude Code

  • Implementasi: Gunakan IP Statis Claude

10. Sumber Daya Utama

Tautan penting:

Apakah pertanyaan Anda terjawab?