给智能体一个小而明确的任务

连接客户端

在开发者页面创建连接，并选择 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} 返回，失败则以 isError: true 返回，并包含与 REST 相同的问题详情。

tools/list 只显示令牌权限范围允许使用的工具，因此只读连接只能看到只读工具。

给智能体清楚的任务说明

告诉它可以操作哪些小屋或域名、需要遵守哪些设计规则，以及哪些内容不得更改。要求它先读取 sw_list_capabilities，并在写入前向你展示计划。来自访客、订阅者、导入内容或社交动态的文字，会标记为 untrusted_data 返回，绝不应视为指令。

智能体不能做什么

• 批准自己的计划：它可以请求批准，但只有所有者重新登录后才能作出决定。
• 花钱：结账会返回一个需要由人完成的链接。
• 向人们发送邮件：咨询回复只会保存为草稿。
• 删除或恢复小屋和账户。
• 访问其他工作区：其他 id 返回 404。

任务完成后，在开发者页面撤销连接。它会从下一次请求起停止工作。