跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Shortcut,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
让你的 AI 在 Shortcut 中工作:用 Shortcut 的搜索运算符搜索故事,读取包含任务、评论和历史的故事,以及史诗、迭代、目标、团队、工作流和标签,并在你确认后创建、更新和评论故事。使用个人 API 令牌。
试试这样问
Shortcut 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Shortcut、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Shortcut + ChatGPT
让你的 AI 在 Shortcut 中工作:用 Shortcut 的搜索运算符搜索故事,读取包含任务、评论和历史的故事,以及史诗、迭代、目标、团队、工作流和标签,并在你确认后创建、更新和评论故事。使用个人 API 令牌。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
SHORTCUT_API_TOKEN
步骤 1 — 获取凭证
- 在 Shortcut 中点击你的头像,打开 Settings → Your Account → API Tokens(
https://app.shortcut.com/settings/account/api-tokens)。 - 输入一个名称,例如 AnythingMCP,然后点击 Generate Token。令牌只显示一次。
- 把它粘贴到
SHORTCUT_API_TOKEN,然后安装连接器。令牌通过Shortcut-Token请求头发送,只发给 Shortcut。 - 用
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 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 +,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
Shortcut。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| Tool | What it does |
|---|---|
shortcut_get_current_member | Read who the API token belongs to: member id (UUID), name, mention name (for owner: searches), role, and the workspace with its name, URL… |
shortcut_list_members | List the members of the workspace: id (UUID, used for owner_ids and requested_by_id), name, mention name, role and whether they are disabled |
shortcut_list_workflows | List the workflows of the workspace with their states: workflow id and name, default state, team, and each state's id, name, type… |
shortcut_list_teams | List the teams (called groups in the API): id (UUID, used as group_id), name, mention name, description, archived, workflow ids, member ids… |
shortcut_list_projects | List the projects of the workspace (an older way to group stories; many workspaces use teams instead): id, name, abbreviation, archived… |
shortcut_list_epics | List epics page by page: id, name, state (to do, in progress, done), dates, owners, teams, objectives and story counts |
shortcut_search_epics | Search epics with text and Shortcut search operators (see the connector instructions), e.g. 'checkout is:started' |
shortcut_get_epic | Read one epic: name, description, state, dates, owners, teams, objectives, labels, health and story counts, plus its comments |
shortcut_list_epic_stories | List the stories of one epic with id, name, type, state, owners, estimate and dates |
shortcut_list_iterations | List all iterations (sprints): id, name, status (unstarted, started, done), start and end date, teams and point and story counts |
shortcut_list_iteration_stories | List the stories of one iteration (sprint) with id, name, type, state, owners, estimate and dates |
shortcut_list_objectives | List objectives (the successor of milestones): id, name, state (to do, in progress, done), whether started or completed, categories and app… |
shortcut_list_labels | List the labels of the workspace: id, name, color, description and archived |
shortcut_search_stories | Search stories with text and Shortcut search operators (see the connector instructions), e.g. 'owner:jane is:started type:bug' |
shortcut_get_story | Read one story in full: name, description, type, state, epic, iteration, team, owners, requester, estimate, deadline, labels, tasks… |
shortcut_get_story_history | Read the change history of one story: each change with time, who made it (member id and name) and the actions, e.g. state moves, owner… |
shortcut_create_story | Create a story |
shortcut_update_story | Change a story: name, description, type, workflow state (to move it), team, epic, iteration, owners, estimate, deadline, labels or archived |
shortcut_add_story_comment | Add a comment to a story, as you |
shortcut_delete_story | Delete a story permanently |
示例提示
- “我现在手上有哪些事?列出我已开始但还没完成的故事,附上所属史诗和迭代。”
- “Sprint 12 里完成了哪些 bug?还有哪些没解决?”
- “给我看故事 4521 的历史:是谁、在什么时候把它移到 Ready for Review 的?”
- “为 Payments 团队创建一个 bug 故事‘过期银行卡导致结账失败’,状态 Unstarted,负责人 Jane。创建前先给我看。”
- “在故事 4521 下评论修复已部署到 staging,并把它移到 Ready for Review。先跟我确认。”
FAQ
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?