MCP 扩展
MCP 用于连接外部工具。一般用户可以先把 MCP 链接发给 JoyCode，请它封装为插件；需要自行填写和管理连接参数时，再进入“设置 → 扩展管理 → MCP”手动配置。
优先让 JoyCode 创建插件#
直接提供 MCP 链接，并说明希望它完成什么。需要认证或补充信息时，让 JoyCode 明确提示。封装为插件后，后续可以直接调用，也更容易了解它能做什么。
示例：根据 MCP 创建插件
请根据这个 MCP 链接创建一个插件，帮我查询团队待办并总结每天的进展。需要认证或补充信息时告诉我。链接：【粘贴你的 MCP 链接】手动配置快速上手#
- 打开 MCP 页面
进入“设置 → 扩展管理 → MCP”，再点击服务器区域右上角“添加服务器”。
- 选择连接类型
选择 STDIO（在本机启动命令）或 Streamable HTTP（连接服务 URL），填写名称和对应连接信息，再点击“保存”。
- 检查服务器状态
返回列表，确认服务器已出现且开关处于开启状态。需要授权时，点击该行“进行身份认证”。
- 验证实际能力
回到对话，提出一个需要该服务的具体请求，检查真实返回，而不是只看开关。
添加本机命令型服务器 STDIO#
服务提供方给出可在本机执行的命令和参数时，选择 STDIO。启动命令和每个参数分别填写，不要把整条命令连同参数全部写进“启动命令”。例如 node /path/to/server.js 中，node 是启动命令，路径是第一个参数。
安全提示：静态环境变量会以明文保存到配置中，不要在这里填写密码或访问令牌。需要敏感值时，使用运行 JoyCode 的环境中已经存在的环境变量。
添加远程服务器 Streamable HTTP#
服务提供方给出 Streamable HTTP 地址时，填写完整 URL。Bearer Token 位置填写的是环境变量名，不是真实令牌；Header 也优先从环境变量读取，避免把敏感值明文写进配置。
终端中临时设置的变量不一定会传给从桌面启动的 JoyCode。保存后如果认证失败，先确认变量存在于 JoyCode 的运行环境，再检查服务地址和账号。
保存后管理与排错#
| 遇到的情况 | 处理方式 |
|---|---|
| 编辑或启停 | 点击服务器行右侧齿轮修改连接信息，使用开关启用或停用。不能直接切换 STDIO 与 Streamable HTTP 类型，需要改类型时重新添加。 |
| 保存后未生效 | 查看页面顶部反馈。提示运行时未自动重新加载时，按页面提供的重启入口处理；没有入口时，重启 JoyCode 后再检查。 |
| 需要登录 | 服务器行出现“进行身份认证”或“重新进行身份认证”时，点击并完成授权，再返回检查状态。 |
| 项目配置只读 | 标记为“项目配置 · 只读”的服务器只能查看；到所属项目的配置来源处理。来自插件的 MCP 在对应插件中配置。 |
| 无法保存 | 按表单下方提示修正名称、命令、URL、变量名或重复 Header。保存按钮只在信息有效且已经修改后可用。 |
| 开关已开但仍不可用 | 核对本机命令与运行环境、远程 URL 和认证信息，再在对话中试用具体能力。 |
表格可左右滑动查看完整内容。