用途
Fusion PM MCP 是一个托管式的 MCP 服务器，作为 GitHub REST API 的缓存代理，以 MCP 工具的形式暴露接口，使智能体能够读取项目数据，而不必在每次调用时都触发 GitHub 速率限制。它主要用于将 GitHub 的 issue、Pull Request 等项目管理数据接入智能体（如 Copilot），同时避免频繁调用导致的限流问题。
本技能适用于以下场景：用户询问 Fusion PM MCP 是什么、如何安装或配置、如何验证其是否正常工作，以及如何排查设置失败或结果过期/被限流的问题。典型触发语句包括“what is fusion pm mcp”“help me set up fusion pm mcp”“how do I get GitHub issues/PRs into Copilot without hitting rate limits”。
不适用于：实现或修改 fusion-pm-mcp 服务源码（属于该仓库自身）；通用 Fusion Framework/docs/EDS/后端代码检索（应使用 fusion-mcp）；编写、分类或审查 GitHub issue/PR（在 MCP 工具可用后应使用 fusion-issue-authoring 或仓库特定的审查技能）；以及在未经用户确认的情况下进行破坏性环境变更。
主要能力
该服务器提供的工具（应以 tools/list 实际返回为准，服务器源码是权威来源，优先于任何可能过期的文档）包括：api_get_issue、api_get_parent_issue、api_get_child_issues、api_get_issue_comments、api_list_milestones、api_get_milestone、api_upsert_issue、api_close、api_get_metadata_schema、api_get_pull_request、api_get_pr_comments、api_get_pr_reviews、api_get_pr_review、api_get_review_comments、api_resolve_review_comment。
响应会被缓存，默认 TTL 为 300 秒；没有缓存失效工具，过期结果会在 TTL 结束后自行清除。
使用方式
推荐且唯一推荐的路径是设置托管的生产服务器：无需 Docker、无需本地克隆、无需管理环境变量。VS Code 通过 Microsoft Entra（Equinor 账户）对 MCP 连接进行认证。调用方还需在每次请求中通过 X-GitHub-Token 头提供自己的 GitHub token（每位用户保留自己的身份与速率限制，不应建议使用共享/服务 token）。请使用 references/vscode-mcp-config.md 中的手动配置（该服务器未发布一键安装链接）。不要建议本地 stdio 或完整的 Docker 开发栈——这些仅适用于参与 fusion-pm-mcp 服务本身的贡献者，应引导他们查看该仓库的 CONTRIBUTING.md，而不是在此嵌入设置步骤。
认证流程：首次调用工具时，VS Code 会提示使用 Equinor Entra 账户登录（控制对 MCP 服务器本身的访问）；另外，X-GitHub-Token 头会在每次请求中将调用者自己的 GitHub PAT 传递到 API。两者都必须有效；401 可能来自任一层。
设置前需收集的输入：是否有可用的 GitHub token（gh auth token，或具有 repo 范围的 PAT）——按请求提供，不存储在配置中；目标客户端（以 VS Code 为主）。如果信息缺失，先提出简明的追问。
验证清单
运行 initialize 并确认响应成功；运行 tools/list 并与实际返回的工具名称比对——不要假设固定列表，接口面此前发生过变化；运行一次非破坏性的 tools/call（例如 api_list_milestones 或 api_get_issue）并确认结果非空。
故障排查（按文档顺序）
未认证/很快触发速率限制 → 未配置 X-GitHub-Token 头；未认证调用上限为 60 次/小时。401 或反复出现登录提示 → 通过 VS Code 重新认证（登出/登录，或重新加载 MCP 服务器）；若仍无法解决，应视为设置缺陷而非已知的暂时性问题。结果看起来过期 → 没有失效缓存工具；结果会在缓存 TTL（几分钟）后自行清除。
适用场景与限制
适用场景：将 GitHub 项目管理数据接入智能体、避免 GitHub 速率限制、在 VS Code 中配置托管 MCP 服务器。限制：仅推荐托管生产服务器路径；本地 stdio 与 Docker 开发栈仅供服务贡献者使用；缓存无手动失效手段；认证依赖 Equinor Entra 账户与调用者自带的 GitHub token。
安全与约束
绝不：请求或暴露 GitHub token、PAT 或 Entra 凭据；编造项目文档不支持的设置命令；在没有验证输出的情况下声称设置成功；为托管多用户设置建议单一共享 GitHub token；在未经用户明确确认的情况下运行破坏性命令。始终：优先以官方仓库文档为权威来源；引导用户使用托管生产服务器，除非用户是服务本身的贡献者，此时应链接到该仓库的 CONTRIBUTING.md 而非嵌入设置步骤；推荐按请求使用 X-GitHub-Token 认证而非共享 token；区分已确认事实与假设。
预期输出
返回：Fusion PM MCP 的简短说明及何时使用；针对用户环境的托管设置步骤；验证清单（initialize、tools/list 与实际返回名称比对、一次 tools/call 并期望非空结果）；映射到观察到的症状的故障排查步骤；当设置失败/异常或用户要求时，使用 assets/bug-report-template.md 生成 bug 报告草稿，默认目标为 equinor/fusion-pm-mcp；明确列出假设与缺失信息。
参考
references/vscode-mcp-config.md；assets/bug-report-template.md。