跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Zenhub，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
通过 GraphQL API 从 AI 代理操作 Zenhub 看板：工作区、管道及其中的 issue、issue 详情、冲刺及其 issue、史诗及其子 issue、估算；移动 issue、设置估算、规划冲刺、创建 issue 和评论。17 个类型化工具外加一个通用查询工具，个人 API 密钥。
试试这样问
Zenhub 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Zenhub、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
Zenhub + Gemini
通过 GraphQL API 从 AI 代理操作 Zenhub 看板：工作区、管道及其中的 issue、issue 详情、冲刺及其 issue、史诗及其子 issue、估算；移动 issue、设置估算、规划冲刺、创建 issue 和评论。17 个类型化工具外加一个通用查询工具，个人 API 密钥。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
ZENHUB_API_KEY
步骤 1 — 获取凭证
该连接器使用个人 API 密钥访问 Zenhub GraphQL API。密钥以其所属用户身份操作：该用户看不到的工作区和仓库不会出现在任何结果中。
- 在 Zenhub 中打开仪表板的 API 部分（https://app.zenhub.com/settings/tokens），为 GraphQL API 创建一个 Personal API Key。每个用户最多可有 5 个密钥。
- 立即复制密钥（只显示一次），不加
Bearer前缀填入ZENHUB_API_KEY。旧版 REST 令牌在这里无效。 - 调用
zenhub_get_viewer检查密钥，用zenhub_search_workspaces找到工作区，再用zenhub_list_pipelines和zenhub_list_pipeline_issues读取看板。
注意事项：
- 每个密钥每分钟有 90 秒处理时间，最多 30 个并发请求，单个查询的复杂度不得超过 200 点。因此列表工具默认返回 10 到 30 条；翻页时把
pageInfo.endCursor作为after传入。 - Zenhub 的 ID 是不透明字符串。写入工具需要 Zenhub issue 的
id，而不是 issue 编号。 - 类型化工具未覆盖的内容（发布、路线图、依赖、优先级、标签）可用
zenhub_graphql_query或zenhub_graphql_mutation。 zenhub_move_issue、zenhub_set_estimate、zenhub_add_issues_to_sprints、zenhub_create_issue和zenhub_add_comment会修改看板或发布团队可见的内容。
步骤 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" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp（或在终端运行gemini mcp list）—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
Zenhub的工具。
可用工具
| Tool | What it does |
|---|---|
zenhub_get_viewer | Return the Zenhub user behind the API key (id, name, email, GitHub login) and the Zenhub organizations it belongs to |
zenhub_list_organizations | List the Zenhub organizations of the user with their workspaces (id, name, description) |
zenhub_search_workspaces | Find workspaces the user can access by name |
zenhub_get_workspace | Get one workspace: name, description, organization, default repository, connected repositories (Zenhub id, GitHub id, name), the active… |
zenhub_list_pipelines | List the pipelines (board columns) of a workspace in board order: id, name, description and stage (BACKLOG, SPRINT_BACKLOG, DEVELOPMENT… |
zenhub_list_pipeline_issues | List the issues in one pipeline (board column), in board order: id, number, title, state, repository, estimate, plus the total count |
zenhub_get_issue | Get one issue by repository and number: title, body, state, type, estimate, its pipeline in the workspace, sprints, labels, assignees and… |
zenhub_list_sprints | List the sprints of a workspace, newest first: id, name, state, start and end, total and completed story points, closed issue count. state… |
zenhub_list_sprint_issues | List the issues in one sprint: id, number, title, state, repository and estimate, plus the sprint's points |
zenhub_list_epics | List the Zenhub epics of a workspace: id, title, state (open, to do, in progress or closed), start and end dates, estimate, and issue count… |
zenhub_list_epic_issues | List the child issues of one or more Zenhub epics: id, number, title, state, repository and estimate |
zenhub_get_estimate_values | List the estimate values (story point scale) allowed in each repository of a workspace, for example 1, 2, 3, 5, 8 |
zenhub_move_issue | Move an issue to another pipeline (board column) of the workspace that owns the pipeline, at a position (0 = top) |
zenhub_set_estimate | Set the estimate (story points) of an issue, or clear it by leaving value out |
zenhub_add_issues_to_sprints | Add one or more issues to one or more sprints |
zenhub_create_issue | Create an issue in a repository of the workspace (a GitHub repository, or the workspace's Zenhub repository for a Zenhub issue) |
zenhub_add_comment | Post a comment on an issue or epic |
zenhub_graphql_schema_url | Return the URL of the GraphQL schema (SDL) |
zenhub_graphql_schema | Fetch the GraphQL schema: a summary, one type, a search slice or the full SDL |
zenhub_graphql_query | Run an arbitrary GraphQL query |
zenhub_graphql_mutation | Run an arbitrary GraphQL mutation |
zenhub_graphql_subscription | Run an arbitrary GraphQL subscription (if the API supports it) |
FAQ
Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?
