用途:这是一个模板技能,展示如何封装 MCP 服务器。它解决的核心问题是:技能在无上下文时直接调用 MCP,Claude 会猜测查询语法,遇到分页怪癖、必填参数组合、速率限制或格式限制时容易出错。做法是在调用前先读取 references/<mcp-name>.md 参考文件,把参数语义、已知错误模式、可复制的查询示例写进去,实现零猜测。
主要能力与流程:以 Sentry 为例,步骤为:先读取 references/sentry-mcp.md;再向用户收集范围(时间范围、环境、项目,默认 72 小时、仅生产、全部项目);然后获取活跃未解决问题列表与事件详情,结果上限 50 条;接着按根因而非错误消息分组,统计问题数、首次出现日期、受影响用户数、最可能根因与相关文件路径;最后输出 Markdown 报告,含摘要、问题分组表格、根因、建议排查步骤与范围外说明。
使用方式:复制目录 cp -r examples/skills/mcp-integration-reference examples/skills/<your-skill>/,重命名参考文件为 references/<your-mcp>.md 并替换内容,更新 frontmatter 中的 allowed-tools 以匹配 MCP 工具名,再调整分析步骤。
适用场景:任何查询行为不直观的 MCP,如 Datadog、PagerDuty、Linear、Jira、Posthog、Mixpanel 等。
限制:该技能只检测和描述问题,不修改代码、不创建工单;模糊问题标记为“需调查”而非猜测;不包含信息性日志或警告,除非与错误直接相关。具体 MCP 名称、工具名与参考文件内容需自行替换,资料未提供其他实现细节。