Beri agen Anda tugas kecil yang jelas

Hubungkan klien

Buat koneksi di halaman Pengembang dan pilih MCP. Endpoint-nya adalah https://<your host>/mcp (ditampilkan pada halaman yang sama). Klien yang menerima server HTTP dengan header hanya membutuhkan URL dan token:

{
  "mcpServers": {
    "small-world": {
      "url": "https://<your host>/mcp",
      "headers": { "Authorization": "Bearer sw_mcp_..." }
    }
  }
}

Layar pengaturan persis berbeda untuk setiap klien. Klien yang hanya dapat masuk melalui OAuth belum dapat terhubung.

Versi protokol

• 2026-07-28 (tanpa status): satu POST /mcp untuk setiap permintaan dengan MCP-Protocol-Version: 2026-07-28, Mcp-Method, dan untuk tools/call, Mcp-Name. server/discover, tools/list, tools/call, resources/list, serta resources/read sudah diimplementasikan.
• Kompatibilitas 2025-11-25: initialize, lalu tools/list dan tools/call. Tidak ada id sesi yang diterbitkan, dan GET /mcp menjawab 405.

Alat mencerminkan API

Setiap operasi REST merupakan alat bernama sw_<operation>, misalnya sw_list_worlds atau sw_publish_world. Alat menerima masukan yang sama dengan panggilan REST: parameter jalur, idempotency_key dan if_match jika diperlukan, serta body permintaan. Hasil dikembalikan sebagai structuredContent: {data, request_id}, dan kegagalan sebagai isError: true dengan detail masalah yang sama seperti REST.

tools/list hanya menampilkan alat yang diizinkan cakupan token Anda, sehingga koneksi hanya baca melihat alat hanya baca.

Beri agen arahan yang jelas

Jelaskan casa atau domain yang boleh disentuh, aturan desain yang harus dipertahankan, dan hal yang tidak boleh diubah. Minta agen membaca sw_list_capabilities terlebih dahulu dan menunjukkan rencana sebelum menulis. Teks yang berasal dari pengunjung, pelanggan, impor, atau umpan sosial dikembalikan dengan tanda untrusted_data dan tidak pernah merupakan instruksi.

Hal yang tidak dapat dilakukan agen

• Menyetujui rencananya sendiri: agen dapat meminta persetujuan, tetapi hanya pemilik yang memutuskannya setelah masuk ulang.
• Membelanjakan uang: proses pembayaran mengembalikan tautan yang diselesaikan seseorang.
• Mengirim email kepada orang: balasan pertanyaan disimpan sebagai draf.
• Menghapus atau memulihkan casa dan akun.
• Mengakses ruang kerja lain: id lain menjawab 404.

Ketika pekerjaan selesai, cabut koneksi di halaman Pengembang. Koneksi berhenti pada permintaan berikutnya.