- 重写 index.mdx 为真正的快速开始指南,链接服务商配置 - 新增 chat.mdx(对话模式、权限、上下文管理) - 新增 skills.mdx(技能分类、市场、本地管理) - 新增 design-agent.mdx(单张/批量图片生成、参考图、连续编辑) - 新增 gallery.mdx(素材库浏览、筛选、详情操作) - 重写 providers.mdx — CLI 环境认证 vs 手动添加、cc switch 不生效说明、 国内服务商预设、Anthropic 第三方模型映射、服务商优先级链 - 重写 mcp.mdx — 三种传输类型(stdio/SSE/HTTP)、列表+JSON 双视图 - 重写 assistant-workspace.mdx — 对齐实际设置>助理标签页 - 重写 faq.mdx — 更全面的问答覆盖 - 桥接拆分为 5 页:总览(斜杠命令、全局设置) + Telegram + Discord + 飞书 + QQ - Discord 开发者模式获取 ID 说明移入配置流程 - 飞书长连接模式启动顺序说明 - 所有 UI 按钮/菜单名称改为中文翻译(设置、服务商、技能、桥接等) - 扁平化无子页面的 folder/index.mdx → page.mdx,消除侧边栏多余展开三角 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
74 lines
2.7 KiB
Plaintext
74 lines
2.7 KiB
Plaintext
---
|
||
title: MCP 插件
|
||
description: 通过 Model Context Protocol 为 Claude 接入外部工具。
|
||
---
|
||
|
||
# MCP 插件
|
||
|
||
[Model Context Protocol (MCP)](https://modelcontextprotocol.io) 是连接 AI 助手与外部工具的开放标准。CodePilot 内置 MCP 客户端,支持连接任意 MCP 服务器来扩展 Claude 的能力。
|
||
|
||
## 什么是 MCP?
|
||
|
||
MCP 服务器为 Claude 提供额外的工具,例如:
|
||
|
||
- **文件系统** — 读写文件、搜索目录
|
||
- **数据库** — 直接查询数据库
|
||
- **API 集成** — 连接 GitHub、Jira、Slack 等外部服务
|
||
- **开发工具** — 运行测试、代码检查、依赖管理
|
||
- **自定义工具** — 构建任何你需要的工具
|
||
|
||
## 管理 MCP 服务器
|
||
|
||
从侧边栏点击 **MCP** 进入管理页面。页面提供两种视图:
|
||
|
||
### 列表视图
|
||
|
||
以卡片形式展示所有已配置的 MCP 服务器,每个卡片显示:
|
||
|
||
- 服务器名称
|
||
- 运行状态(已连接 / 已断开 / 错误)
|
||
- 提供的工具列表
|
||
|
||
### JSON 编辑器
|
||
|
||
直接编辑 MCP 配置的 JSON 文件,适合批量配置或从其他工具导入配置。
|
||
|
||
## 添加 MCP 服务器
|
||
|
||
1. 在 MCP 页面点击 **添加服务器**
|
||
2. 填写配置:
|
||
- **名称** — 服务器的描述性名称
|
||
- **传输类型** — 选择连接方式:
|
||
- **stdio** — 本地进程,通过标准输入输出通信(最常用)
|
||
- **SSE** — 通过 Server-Sent Events 连接远程服务器
|
||
- **HTTP (Streamable)** — 通过 HTTP 流式连接
|
||
- **命令**(stdio 类型)— 启动服务器的命令,如 `npx @modelcontextprotocol/server-filesystem`
|
||
- **参数** — 命令行参数
|
||
- **URL**(SSE / HTTP 类型)— 远程服务器的地址
|
||
- **环境变量** — 服务器需要的环境变量(API 密钥等)
|
||
3. 保存后服务器会自动启动
|
||
|
||
## 使用 MCP 工具
|
||
|
||
MCP 服务器连接后,它提供的工具会自动对 Claude 可用。Claude 在处理你的请求时会根据需要调用这些工具。
|
||
|
||
你可以在 MCP 页面查看每个服务器提供的具体工具列表。
|
||
|
||
## 常用 MCP 服务器
|
||
|
||
| 服务器 | 用途 |
|
||
|--------|------|
|
||
| `@modelcontextprotocol/server-filesystem` | 文件系统访问 |
|
||
| `@modelcontextprotocol/server-github` | GitHub 集成 |
|
||
| `@modelcontextprotocol/server-slack` | Slack 集成 |
|
||
| `@anthropic-ai/mcp-server-fetch` | 网页抓取 |
|
||
|
||
更多 MCP 服务器可在 [MCP 官方仓库](https://github.com/modelcontextprotocol/servers) 和社区中找到。
|
||
|
||
## 故障排除
|
||
|
||
- **服务器无法连接** — 检查命令是否正确,所需的 npm 包是否已安装
|
||
- **工具未出现** — 尝试断开并重新连接服务器
|
||
- **权限错误** — 确保 MCP 服务器有权访问所需资源
|
||
- **SSE/HTTP 连接失败** — 检查 URL 是否正确,服务器是否正在运行
|