開発者向け

エージェントに、小さく明快な仕事を

スコープを限定したトークンでMCPクライアントをワークスペースにつなぎ、APIと同じ操作を使ってもらいます。

クライアントを接続する

開発者ページで接続を作り、MCPを選びます。エンドポイントはhttps://<your host>/mcpで、同じページに表示されます。ヘッダー付きのHTTPサーバーを受け入れるクライアントなら、URLとトークンだけで接続できます。

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

具体的な設定画面はクライアントごとに異なります。OAuthでしかサインインできないクライアントは、まだ接続できません。

プロトコルのバージョン

2026-07-28（ステートレス）：リクエストごとに一度POST /mcpを送り、MCP-Protocol-Version: 2026-07-28とMcp-Method、さらにtools/callの場合はMcp-Nameを付けます。server/discover、tools/list、tools/call、resources/list、resources/readを実装しています。
2025-11-25との互換性：initializeの後に、tools/listとtools/callを使います。セッションIDは発行せず、GET /mcpには405を返します。

ツールはAPIと対応する

どのREST操作も、sw_<operation>という名前のツールになります。たとえばsw_list_worldsやsw_publish_worldです。ツールはREST呼び出しと同じ入力を受け取ります。パスパラメーター、必要に応じたidempotency_keyとif_match、リクエストのbodyです。結果はstructuredContent: {data, request_id}として返り、失敗時にはRESTと同じ問題の詳細を伴うisError: trueを返します。

tools/listには、トークンのスコープが許可するツールだけが表示されます。読み取り専用の接続には、読み取り専用ツールだけが見えます。

エージェントに明快な指示を渡す

触れてよいcasaやドメイン、守るデザインのルール、変更してはいけないものを伝えてください。まずsw_list_capabilitiesを読み、書き込む前に計画を見せるよう頼みましょう。訪問者、購読者、インポート、ソーシャルフィード由来の文章は、untrusted_dataと明示されて返され、決して指示にはなりません。

エージェントにできないこと

自分の計画を承認すること。承認を申請できますが、再度サインインしたオーナーだけが決定できます。
お金を使うこと。購入手続きは、人が完了するリンクを返します。
人にメールを送ること。問い合わせへの返信は下書きとして保存されます。
casaやアカウントを削除または復元すること。
別のワークスペースにアクセスすること。他のIDには404を返します。

仕事が終わったら、開発者ページで接続を失効させてください。次のリクエストから停止します。

更新日：2026年11月10日