如何通过 MCP 将 Shortcut 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Shortcut、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Shortcut + Gemini

让你的 AI 在 Shortcut 中工作：用 Shortcut 的搜索运算符搜索故事，读取包含任务、评论和历史的故事，以及史诗、迭代、目标、团队、工作流和标签，并在你确认后创建、更新和评论故事。使用个人 API 令牌。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

SHORTCUT_API_TOKEN

步骤 1 — 获取凭证

1. 在 Shortcut 中点击你的头像，打开 Settings → Your Account → API Tokens（https://app.shortcut.com/settings/account/api-tokens）。
2. 输入一个名称，例如 AnythingMCP，然后点击 Generate Token。令牌只显示一次。
3. 把它粘贴到 SHORTCUT_API_TOKEN，然后安装连接器。令牌通过 Shortcut-Token 请求头发送，只发给 Shortcut。
4. 用 shortcut_get_current_member 检查设置：它会显示你是谁、你的提及名和所在的工作区。

令牌以你的身份操作：在创建它的工作区内、按你的权限运行。AI 写的故事和评论都显示在你名下。如果你在多个 Shortcut 工作区工作，请为每个工作区各创建一个令牌。

修改需经你同意：shortcut_create_story、shortcut_update_story 和 shortcut_add_story_comment 会立即修改工作区并通知关注者。AI 会先给你看故事、字段或评论内容，等你明确同意。shortcut_delete_story 在安装时处于关闭状态：删除的故事无法恢复，用 shortcut_update_story 归档更稳妥。

像在 Shortcut 里一样搜索：shortcut_search_stories 和 shortcut_search_epics 支持 Shortcut 的搜索运算符。你用日常语言提问，AI 来拼出查询：

• owner:jane、requester:jane、team:"Mobile"、epic:"Checkout redesign"、iteration:"Sprint 12"、label:"customer"、state:"In Progress"、type:bug、estimate:3。
• is:started、is:done、is:blocked、is:overdue、has:owner、has:deadline、has:comment。
• 日期：created:2026-10-01..2026-10-15、updated:today、completed:yesterday、due:*..2026-10-31。
• 在运算符前加感叹号表示排除，例如 owner:jane is:started !is:archived type:bug。

可以读取的内容：包含描述、任务、评论、链接和完整变更历史（谁在什么时候移动了什么）的故事，带评论的史诗，迭代，目标，团队，含各状态的工作流，标签，项目和成员。移动故事时，AI 会先查到对应的工作流状态再设置。

分页和限制：搜索默认返回 25 条结果，每页最多 250 条。只能翻阅前 1000 条匹配结果，所以 AI 会优先缩小查询范围。每个令牌每分钟 200 次请求。

常见错误：401：令牌错误或已被删除，请重新生成。404：该 ID 在此工作区中不存在。400 或 422：某个值不被接受，例如来自另一个工作流的状态；Shortcut 会在消息中指出。

不包括：删除史诗、迭代、标签或评论，Docs，文件和附件，编辑自定义字段，故事模板，Webhook，任务以及故事之间的关联。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Shortcut 的工具。

可用工具

示例提示

• “我现在手上有哪些事？列出我已开始但还没完成的故事，附上所属史诗和迭代。”
• “Sprint 12 里完成了哪些 bug？还有哪些没解决？”
• “给我看故事 4521 的历史：是谁、在什么时候把它移到 Ready for Review 的？”
• “为 Payments 团队创建一个 bug 故事‘过期银行卡导致结账失败’，状态 Unstarted，负责人 Jane。创建前先给我看。”
• “在故事 4521 下评论修复已部署到 staging，并把它移到 Ready for Review。先跟我确认。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT