name: mcp-integration description: Claude Code 模型上下文协议 (MCP) 集成的中央权威。覆盖 MCP 服务器安装 (HTTP, SSE, stdio 传输), 服务器管理 (添加, 列出, 移除), 安装范围 (本地, 项目, 用户), 插件提供的 MCP 服务器, 企业 MCP 配置, MCP 资源和 @ 提及, MCP 提示作为技能, OAuth 认证, 环境变量扩展, Claude Code 作为 MCP 服务器, 输出限制, 和 MCP 安全。协助连接外部工具, 配置 MCP 服务器, 管理认证, 和解决 MCP 问题。100% 委托给 docs-management 技能以获取官方文档。 user-invocable: false allowed-tools: Read, Glob, Grep, Skill
MCP 元技能
🚨 强制性：首先调用 docs-management
停止 - 在提供任何关于 MCP（模型上下文协议）的响应之前：
- 调用
docs-management技能- 查询 用户的特定主题
- 基于 官方文档加载的内容 EXCLUSIVELY 提供所有响应
跳过此步骤会导致过时或不正确的信息。
验证检查点
在响应之前，验证：
- [ ] 我是否调用了 docs-management 技能？
- [ ] 官方文档是否已加载？
- [ ] 我的响应是否完全基于官方文档？
如果任何复选框未选中，停止并首先调用 docs-management。
概述
Claude Code 模型上下文协议 (MCP) 集成的中央权威。此技能使用 100% 委托给 docs-management - 它不包含任何重复的官方文档。
架构： 纯委托与关键词注册表。所有官方文档通过 docs-management 技能查询访问。
何时使用此技能
关键词： MCP, Model Context Protocol, MCP 服务器, MCP 工具, MCP 资源, MCP 提示, HTTP 传输, SSE 传输, stdio 传输, MCP 安装, MCP 范围, 本地范围, 项目范围, 用户范围, .mcp.json, 插件 MCP 服务器, 企业 MCP, managed-mcp.json, OAuth 认证, MCP 资源, @ 提及, mcp__server__prompt, MCP 输出限制, MAX_MCP_OUTPUT_TOKENS, claude mcp serve
使用此技能当：
- 安装或配置 MCP 服务器
- 理解 MCP 传输类型 (HTTP, SSE, stdio)
- 管理 MCP 服务器范围 (本地, 项目, 用户)
- 使用插件提供的 MCP 服务器
- 设置企业 MCP 配置
- 使用 MCP 资源与 @ 提及
- 执行 MCP 提示作为斜杠命令
- 认证远程 MCP 服务器 (OAuth)
- 配置环境变量扩展在 .mcp.json
- 使用 Claude Code 作为 MCP 服务器
- 管理 MCP 输出限制
- 解决 MCP 连接问题
docs-management 查询的关键词注册表
查询 docs-management 技能获取官方文档时使用这些关键词：
核心概念
| 主题 | 关键词 |
|---|---|
| 概述 | “MCP”, “Model Context Protocol”, “MCP overview” |
| MCP 功能 | “what you can do with MCP”, “MCP capabilities” |
| 热门服务器 | “popular MCP servers”, “MCP servers table” |
安装和传输
| 主题 | 关键词 |
|---|---|
| 安装概述 | “installing MCP servers”, “MCP server configuration” |
| HTTP 传输 | “HTTP transport MCP”, “remote HTTP server”, “–transport http” |
| SSE 传输 | “SSE transport MCP”, “Server-Sent Events transport” |
| Stdio 传输 | “stdio transport MCP”, “local stdio server” |
| Windows 设置 | “Windows MCP servers”, “cmd /c npx” |
服务器管理
| 主题 | 关键词 |
|---|---|
| 命令 | “claude mcp add”, “claude mcp list”, “claude mcp remove”, “/mcp command” |
| JSON 配置 | “add-json MCP”, “MCP JSON configuration” |
| 从桌面导入 | “add-from-claude-desktop”, “import MCP servers” |
安装范围
| 主题 | 关键词 |
|---|---|
| 范围概述 | “MCP installation scopes”, “MCP scope levels” |
| 本地范围 | “local scope MCP”, “project-specific user settings” |
| 项目范围 | “project scope MCP”, “.mcp.json file” |
| 用户范围 | “user scope MCP”, “cross-project MCP” |
| 范围优先级 | “MCP scope precedence”, “scope hierarchy” |
插件集成
| 主题 | 关键词 |
|---|---|
| 插件 MCP 服务器 | “plugin-provided MCP servers”, “plugin MCP configuration” |
| 插件功能 | “CLAUDE_PLUGIN_ROOT”, “plugin MCP lifecycle” |
企业配置
| 主题 | 关键词 |
|---|---|
| 企业设置 | “enterprise MCP configuration”, “managed-mcp.json” |
| 允许列表/拒绝列表 | “allowedMcpServers”, “deniedMcpServers”, “MCP restrictions” |
| 企业路径 | “enterprise MCP paths”, “managed MCP locations” |
资源和提示
| 主题 | 关键词 |
|---|---|
| MCP 资源 | “MCP resources”, “@ mentions MCP”, “reference MCP resources” |
| MCP 提示 | “MCP prompts”, “mcp__servername__promptname”, “MCP skills” |
认证
| 主题 | 关键词 |
|---|---|
| OAuth 设置 | “MCP OAuth”, “authenticate remote MCP”, “/mcp authentication” |
| 令牌管理 | “MCP token refresh”, “clear MCP authentication” |
高级配置
| 主题 | 关键词 |
|---|---|
| 环境变量 | “environment variable expansion”, “.mcp.json variables”, “${VAR}” |
| 输出限制 | “MCP output limits”, “MAX_MCP_OUTPUT_TOKENS”, “output warning” |
| Claude 作为服务器 | “claude mcp serve”, “Claude Code as MCP server” |
工具搜索和自动模式 (v2.1.7+)
| 主题 | 关键词 |
|---|---|
| 自动模式默认 | “MCP tool search auto mode”, “ENABLE_TOOL_SEARCH”, “auto mode default” |
| 自动阈值语法 | “auto:N syntax”, “MCP threshold percentage”, “context threshold” |
| 启用/禁用 | “/mcp enable”, “/mcp disable”, “tool search toggle” |
行为变化 (v2.1.7): MCP 工具搜索自动模式现在默认启用，上下文阈值为 10%。使用 auto:N 语法配置自定义阈值 (0-100%)。
行为变化 (v2.1.6): MCP 服务器的 @-提及语法已移除。使用 /mcp enable <server> 代替。
安全
| 主题 | 关键词 |
|---|---|
| MCP 安全 | “MCP security”, “MCP prompt injection”, “trust MCP servers” |
快速决策树
你想做什么？
- 添加远程 MCP 服务器 -> 查询 docs-management: “installing MCP servers”, “HTTP transport MCP”
- 添加本地 MCP 服务器 -> 查询 docs-management: “stdio transport MCP”, “local stdio server”
- 理解范围 -> 查询 docs-management: “MCP installation scopes”, “scope precedence”
- 与团队共享 MCP -> 查询 docs-management: “project scope MCP”, “.mcp.json file”
- 跨项目使用 MCP -> 查询 docs-management: “user scope MCP”, “cross-project MCP”
- 配置插件 MCP -> 查询 docs-management: “plugin-provided MCP servers”
- 设置企业 MCP -> 查询 docs-management: “enterprise MCP configuration”, “managed-mcp.json”
- 使用 OAuth 认证 -> 查询 docs-management: “MCP OAuth”, “/mcp authentication”
- 参考 MCP 资源 -> 查询 docs-management: “MCP resources”, “@ mentions MCP”
- 使用 MCP 提示 -> 查询 docs-management: “MCP prompts”, “MCP skills”
- 将 Claude 暴露为 MCP 服务器 -> 查询 docs-management: “claude mcp serve”
- 解决 MCP 问题 -> 查询 docs-management: “MCP troubleshooting” + 特定问题
主题覆盖
传输类型和安装
- HTTP 传输 (推荐用于远程服务器)
- SSE 传输 (已弃用，使用 HTTP)
- Stdio 传输 (本地进程)
- Windows 特定设置 (cmd /c 包装器)
- 双破折号 (–) 参数解释
- MCP_TIMEOUT 环境变量
服务器管理命令
claude mcp add(带传输标志)claude mcp list(显示所有服务器)claude mcp get(服务器详情)claude mcp remove(删除服务器)/mcp命令 (会话内状态)claude mcp add-json(JSON 配置)claude mcp add-from-claude-desktop(导入)claude mcp reset-project-choices(批准重置)
范围配置
- 本地范围 (默认, 用户/项目私有)
- 项目范围 (.mcp.json, 版本控制)
- 用户范围 (跨项目, 私有)
- 范围优先级 (本地 > 项目 > 用户)
- –scope 标志使用
环境变量扩展
- ${VAR} 语法
- ${VAR:-default} 带默认值的语法
- 支持的扩展位置 (命令, 参数, 环境, URL, 头)
- 缺失变量处理
插件 MCP 服务器集成
- 插件 .mcp.json 配置
- 插件.json 中的内联 mcpServers
- CLAUDE_PLUGIN_ROOT 变量
- 自动生命周期管理
- 支持多种传输类型
企业 MCP 管理
- managed-mcp.json 文件位置 (macOS, Windows, Linux)
- allowedMcpServers 配置
- deniedMcpServers 配置
- 允许列表/拒绝列表优先级
- 企业范围优先级
MCP 资源系统
- @ 提及语法用于资源
- 资源路径格式 (@server:protocol://path)
- 多个资源引用
- 自动完成中的模糊搜索
- 资源内容类型
MCP 提示作为技能
- /mcp__servername__promptname 格式
- 带参数执行提示
- 从服务器动态发现
- 名称规范化 (空格转下划线)
认证机制
- OAuth 2.0 支持
- /mcp 命令用于认证
- 令牌存储和刷新
- 清除认证选项
- HTTP 服务器认证
输出限制和配置
- 默认 25,000 令牌限制
- 10,000 令牌时警告
- MAX_MCP_OUTPUT_TOKENS 配置
- 更高限制的用例
Claude Code 作为 MCP 服务器
claude mcp serve命令- Claude Desktop 集成
- 配置格式
- 暴露的工具 (View, Edit, LS, 等.)
- 可执行路径配置
委托模式
标准查询模式
用户问: "如何添加 MCP 服务器？"
1. 调用 docs-management 技能
2. 使用关键词: "installing MCP servers", "claude mcp add"
3. 加载官方文档
4. 基于官方文档 EXCLUSIVELY 提供指导
多主题查询模式
用户问: "我想与团队共享 MCP 服务器并使用 OAuth 认证"
1. 调用 docs-management 技能，带多个查询:
- "project scope MCP", ".mcp.json file"
- "MCP OAuth", "/mcp authentication"
2. 从官方文档合成指导
故障排除模式
用户报告: "我的 MCP 服务器在 Windows 上无法连接"
1. 调用 docs-management 技能
2. 使用关键词: "Windows MCP servers", "cmd /c npx"
3. 检查官方文档的 Windows 特定要求
4. 从官方文档引导用户完成 Windows 设置
故障排除快速参考
| 问题 | docs-management 关键词 |
|---|---|
| 服务器无法连接 | “installing MCP servers”, 特定传输类型 |
| Windows 连接错误 | “Windows MCP servers”, “cmd /c” |
| 认证失败 | “MCP OAuth”, “/mcp authentication” |
| 范围不工作 | “MCP installation scopes”, “scope precedence” |
| 环境变量未扩展 | “environment variable expansion”, “.mcp.json variables” |
| 输出太大 | “MCP output limits”, “MAX_MCP_OUTPUT_TOKENS” |
| 插件 MCP 未加载 | “plugin-provided MCP servers”, “plugin MCP lifecycle” |
| 企业限制 | “allowedMcpServers”, “deniedMcpServers” |
仓库特定说明
此仓库使用 MCP 服务器用于：
- context7 MCP: 库文档查找
- firecrawl MCP: 网页抓取和搜索
- microsoft-learn MCP: Microsoft/Azure 文档
- perplexity MCP: AI 驱动搜索
- Ref MCP: 文档参考查找
MCP 服务器在项目设置中配置，应遵循 Claude Code 官方文档中记录的模式。
审计 MCP 配置
此技能提供 mcp-auditor 代理用于正式审计的验证标准。
关键：CLI-优先发现 (强制性)
总是在搜索配置文件之前运行 claude mcp list FIRST。这是强制性的因为：
- 文件位置可以在 Claude Code 版本之间改变
- 用户配置在
~/.claude.json中 (NOT~/.claude/.mcp.json- 此路径不存在) mcpServers键可能在文件中很深 (第 200+ 行) - 部分读取时容易错过- CLI 显示运行时状态 - 文件可能不反映实际运行情况
# 步骤 1: 获取配置服务器的权威列表
claude mcp list
# 步骤 2: 获取特定服务器详情 (显示范围和配置)
claude mcp get <服务器名称>
常见发现错误：
| 错误 | 为什么失败 | 正确方法 |
|---|---|---|
只搜索 .mcp.json 文件 |
用户 MCP 在 ~/.claude.json 中，不是单独文件 |
先使用 CLI，然后验证文件 |
只读取 ~/.claude.json 的前 N 行 |
mcpServers 可能在文件中很深 (第 200+ 行) |
先 grep 查找 mcpServers 键 |
| 忽略 CLI 发现 | 文件可能不反映运行时状态 | 总是以 claude mcp list 开始 |
错误路径 ~/.claude/.mcp.json |
此路径不存在；用户配置是 ~/.claude.json |
检查官方文档获取当前路径 |
审计资源
| 资源 | 位置 | 目的 |
|---|---|---|
| 审计框架 | references/audit-framework.md |
查询指南和评分标准 |
评分类别
| 类别 | 分数 | 关键标准 |
|---|---|---|
| 配置结构 | 25 | 有效 JSON, 必需字段 |
| 服务器条目 | 25 | 有效服务器配置, 正确格式 |
| 传输配置 | 20 | 有效传输类型, 正确设置 |
| 认证 | 15 | 正确认证, 无暴露密钥 |
| 范围合规 | 15 | 正确范围 (项目/用户/插件) |
阈值： 85+ = 通过, 70-84 = 通过但带警告, <70 = 失败
相关代理
mcp-auditor 代理 (Haiku 模型) 使用此技能执行正式审计：
- 通过
skills: mcp-integration自动加载此技能 - 使用审计框架和 docs-management 获取规则
- 生成结构化审计报告
- 由
/audit-mcp命令调用
外部技术验证
当审计引用外部技术 (脚本, 包, 运行时) 的 MCP 配置时，审计员必须在标记发现之前使用 MCP 服务器验证声明。
需要 MCP 验证的技术：
- .NET/C# 脚本：使用 microsoft-learn + perplexity 验证
- Node.js/npm 包：使用 context7 + perplexity 验证
- Python 脚本/包：使用 context7 + perplexity 验证
- Shell 脚本：使用 perplexity 验证
- 任何版本特定声明：总是使用 perplexity 验证
验证规则：
永远不要在不首先执行以下操作的情况下标记技术使用为不正确：
- 查询适当的 MCP 服务器获取当前文档
- 使用 perplexity 验证最近变化 (特别是 .NET 10+)
- 在发现中记录 MCP 来源
陈旧数据警告：
- microsoft-learn 可能返回缓存/过时文档
- 总是将 microsoft-learn 与 perplexity 配对用于版本验证
- 信任 perplexity 获取版本号和最近发布功能
参考
参考文件：
官方文档 (通过 docs-management 技能)：
- 主要: “mcp” 文档
- 相关: “plugins”, “hooks”, “settings”, “security”
仓库特定：
- MCP 配置：项目级 .mcp.json 或本地设置
- 技能配置：
.claude/settings.json
版本历史
-
v1.2.0 (2026-01-16): 工具搜索和自动模式关键词 (v2.1.6-v2.1.9)
- 添加 “工具搜索和自动模式 (v2.1.7+)” 关键词部分
- 自动模式默认行为变化 (10% 阈值)
- auto:N 语法用于自定义阈值
- 记录 @-提及移除 (v2.1.6) - 使用 /mcp enable 代替
-
v1.1.0 (2025-12-25): 审计框架增强
- 添加外部技术验证指导
- 增强 CLI-优先发现文档
- 改进 MCP 审计的评分准则
-
v1.0.0 (2025-11-26): 初始发布
- 纯委托架构
- 全面关键词注册表
- 快速决策树
- 所有 MCP 功能的主题覆盖
- 故障排除快速参考
最后更新
日期： 2026-01-16 模型： claude-opus-4-5-20251101