配置 MCP

三步走：拿 API Key → 选你的客户端复制配置 → 验证 listGames。也可以把整段 prompt 丢给 Agent 让它代劳。

第 1 步：创建 API Key

第 2 步：按你的客户端复制配置

把 Bearer 后面的占位符换成你的真实 key。OpenCode 注意版本嵌套差异（v1 是 mcp 直挂，v2 是 mcp.servers）；Antigravity 远程字段必须是 serverUrl。

项目级：<项目根>/opencode.json
全局：~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mui-gamebook": {
      "type": "remote",
      "url": "https://muistory.com/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      },
      "timeout": 120000
    }
  }
}

v2 版把 mui-gamebook 挪到 mcp.servers 下，字段不变；连不上先确认版本。

第 3 步：验证连接

新开一段对话让配置热加载，确认 mui-gamebook 已连接，然后调用 listGames。通了再开始干活，不通先看排错。

排错

Unauthorized = key 错或过期，去 API 密钥页吊销重建；工具列表为空 = 超时太短或端点未部署，timeout 拉到 120000。API Key 只能管理自己的游戏。

直接丢给 Agent 的 prompt

复制下面这段话发给你的 AI Agent（OpenCode / Antigravity），它会按你的客户端自动完成上面三步。

帮我在本地配好 Mui Gamebook（姆伊游戏书）的远程 MCP，让你能帮我创建和管理互动小说游戏。

端点：https://muistory.com/api/mcp

流程：
1. 先问我要 API Key（muistory.com → 工作台 → API 密钥页创建，mgb_ 开头，我复制给你；你拿到后直接用，不要复述完整 key）。
2. 按你的客户端写配置（只写你认得的那一种）：
   - 你是 OpenCode：写 opencode.json（项目级或 ~/.config/opencode/opencode.json），形态 {"mcp":{"mui-gamebook":{"type":"remote","url":"https://muistory.com/api/mcp","enabled":true,"headers":{"Authorization":"Bearer <我的key>"},"timeout":120000}}}（v2 改为 mcp.servers 嵌套）。
   - 你是 Antigravity：写 mcp_config.json（~/.gemini/config/mcp_config.json 或工作区 .agents/mcp_config.json），形态 {"mcpServers":{"mui-gamebook":{"serverUrl":"https://muistory.com/api/mcp","headers":{"Authorization":"Bearer <我的key>"}}}}（注意是 serverUrl 不是 url）。
3. 新开对话验证：确认 mui-gamebook 已连接，调用 listGames，报结果给我。

注意：只用我的 API Key 鉴权，不用 ADMIN_PASSWORD；写剧本时先 dryRun 预览再落库。