Menü
MCP 服务配置指南，包括添加、连接、排查 MCP 服务器
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
多模态服务指南，包括图片生成、视频生成、语音合成、音乐生成的配置与使用
系统概述，介绍 Protocol Proxy 的定位、核心能力和典型使用场景
供应商管理指南，包括创建供应商、配置 API Key、密钥轮换
监控与日志指南，包括用量统计、请求日志、系统日志查看
智控助手使用指南，包括对话、技能管理、斜杠命令、快捷键
系统诊断工具，包括健康检查、日志分析、代理诊断、MCP 诊断
| name | guide-mcp |
| description | MCP 服务配置指南，包括添加、连接、排查 MCP 服务器 |
| trigger | 用户询问 MCP 怎么配置、MCP 是什么、MCP 服务连接失败、如何添加工具扩展、MCP 工具怎么用 |
MCP (Model Context Protocol) 服务器可以为 AI 对话提供额外的工具能力扩展。
MCP 是一种 AI 工具标准协议，允许 AI 连接外部工具和服务。例如：
filesystem, github-tools）启动本地程序作为 MCP 服务器，适合本地安装的 MCP 服务。
| 配置项 | 含义 | 示例 |
|---|---|---|
| 命令 | 启动 MCP 服务器的可执行文件或包管理器 | npx, node, python, uvx |
| 参数 | 传递给命令的参数，每个空格分隔一个参数 | -y @modelcontextprotocol/server-filesystem /tmp |
| 环境变量 | 传递给进程的环境变量（可选） | GITHUB_TOKEN=xxx |
连接远程运行的 MCP 服务器，适合连接远程部署的 MCP 服务。
| 配置项 | 含义 | 示例 |
|---|---|---|
| URL | MCP 服务器的 HTTP 端点地址 | https://mcp.example.com/mcp |
| 请求头 | 发送到服务器的 HTTP 请求头（可选） | Authorization: Bearer xxx |
控制 MCP 服务是否启用。关闭后该服务不会在智控助手中可用。
大多数官方 MCP 服务器只支持 stdio 模式。系统预置了这些配置，可通过
get_mcp_presets一键添加。
| # | 名称 | 命令 | 参数 | 用途 | 注意 |
|---|---|---|---|---|---|
| 1 | Filesystem | npx | -y @modelcontextprotocol/server-filesystem /目录 | 读写指定目录文件 | 必须指定至少一个目录 |
| 2 | Memory | npx | -y @modelcontextprotocol/server-memory | 知识图谱记忆 | — |
| 3 | Chrome DevTools | npx | -y chrome-devtools-mcp | 浏览器自动化、Lighthouse 审计 | 29 个工具 |
| 4 | Context7 | npx | -y @upstash/context7-mcp | 语义搜索代码文档 | — |
| 5 | Sequential Thinking | npx | -y @modelcontextprotocol/server-sequential-thinking | 结构化思维链推理 | — |
| 6 | Open WebSearch | npx | -y open-websearch | 网页搜索（Bing/Baidu/DuckDuckGo） | 必须设环境变量 MODE=stdio，否则端口冲突会崩溃 |
| 7 | Stagehand | npx | -y stagehand-mcp | 浏览器自动化 | — |
| 8 | A2ASearch | npx | -y a2asearch-mcp | 搜索 MCP 生态 | — |
| 9 | OpenChrome | npx | -y openchrome-mcp | CDP 浏览器控制 | — |
| 10 | Pretext PDF | npx | -y pretext-pdf-mcp | 生成 PDF | — |
| # | 名称 | 命令 | 参数 / 环境变量 | 用途 |
|---|---|---|---|---|
| 11 | Slack | npx | -y @modelcontextprotocol/server-slack + SLACK_BOT_TOKEN + SLACK_TEAM_ID | Slack 消息和频道 |
| 12 | Google Drive | npx | -y @modelcontextprotocol/server-gdrive | Google Drive 文件（需 OAuth2） |
| 13 | PostgreSQL | npx | -y @modelcontextprotocol/server-postgres postgresql://user:pass@host:5432/db | 数据库查询 |
| 操作 | 说明 |
|---|---|
| 连接 | 启动 MCP 服务器进程，建立工具连接。连接后才能在智控助手中使用 |
| 断开 | 停止 MCP 服务器进程，释放资源 |
| 工具列表 | 查看该服务提供的所有工具，了解可用的操作能力 |
| 状态 | 含义 |
|---|---|
| 未连接 | 服务未启动，需要点击「连接」启动 |
| 连接中 | 正在启动服务，请稍候 |
| 已连接 | 服务运行正常，工具可用 |
| 连接失败 | 启动失败，查看日志排查问题 |
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 命令不存在 | npx/uvx 未安装 | 确认 Node.js 或 Python 已安装 |
| 包名错误 | npm 名称与文档不同 | 先 npx -y <包名> 测试；正确包名见下表 |
| 权限不足 | Token 或环境变量错误 | 检查环境变量配置 |
| 端口冲突 | 某些服务默认启动 HTTP 服务器 | 设 MODE=stdio 或 PORT=其他端口 |
| 连接断开 | 状态异常 | 删除配置，重新添加并连接 |
| HTTP 方式失败 | URL 不可达 | 检查网络和防火墙 |
| 传输模式报错 | 官方 MCP 只支持 stdio | 使用本地进程方式配置 |
易错包名对照：
| 错误写法 | 正确包名 |
|---|---|
@context7/mcp-server | @upstash/context7-mcp |
@anthropic-ai/mcp-sequential-thinking | @modelcontextprotocol/server-sequential-thinking |
open-websearch-mcp | open-websearch |
查看连接错误：点击「连接」→ 等待「连接失败」→ 打开「系统日志」查看详细信息。更多诊断流程见 /diagnostics（MCP 诊断章节）。
安装 MCP 服务器（如果是本地方式）
# 示例：安装文件系统服务器
npx -y @modelcontextprotocol/server-filesystem
在系统中添加 MCP 服务
连接 MCP 服务
在智控助手中使用