连接器

连接器让 Qoder CN 使用外部服务提供的工具。任务需要访问当前工作区以外的信息或操作项目管理、数据库、文档和自动化服务时，可以使用连接器。

​

安装连接器

1. 在左侧导航栏选择扩展。
2. 打开连接器页签。
3. 按分类浏览，在热门和最新之间切换，或使用搜索。
4. 打开查看详情，检查服务、发布者、能力和所需访问权限。
5. 选择安装，并按页面提示完成登录或配置。

安装后先执行只读请求，确认返回的账号和数据范围正确，再让 Qoder CN 创建、更新或删除外部数据。

​

添加自定义 MCP 服务器

选择添加连接器，打开添加自定义 MCP。该服务器为用户级配置，保存在 ~/.qoder/settings.json 的 mcpServers 字段中。 可以选择以下方式：

• 表单：填写 MCP 名称，选择传输方式，再完成对应字段。
• JSON：粘贴完整配置，并检查命令、参数、URL 和环境变量名。

确认配置后选择添加 MCP。不要把密钥写进任务指令或提交到代码仓库，应使用服务器支持的认证或环境变量机制。

​

在任务中使用连接器

在任务中说明外部系统、目标操作和作用范围。需要明确指定时，输入 / 并从连接器建议中选择。Qoder CN 是否在调用前请求批准，取决于当前访问权限设置和操作类型。

​

验证与排查

1. 确认连接器已安装，并完成所需账号授权。
2. 先执行范围明确的只读操作，核对账号、项目或工作区。
3. 对于自定义 MCP，检查传输方式、命令或 URL、参数、环境变量和网络连接。
4. 确认工具列表能够正常加载后再执行正式任务。

写入失败时，不要立即扩大权限；先确认目标、连接器账号和服务端授权。