Dokki Docs logo

工作区连接器

连接器是命名的、工作区范围的 MCP 凭证。它们允许外部客户端和代理使用受控的 Dokki 端点,而无需使用您的浏览器会话。

视觉指南

谁可以管理连接器

只有工作区管理员可以从 工作区 → 扩展 → 连接器 创建、列出或撤销连接器。设置路由仍可用于直接管理。

连接器类型

  • 文档 公开工作区资源:文档、表格、工件、文件、预览、搜索、知识图谱、标签、文件夹、共享以及工作区频道协调。

  • 发布 公开工作区公共站点的发布和自定义域名管理。

  • 记忆 公开工作区范围的长期记忆工具,用于添加、搜索、列出和删除持久事实。

范围与认证模型

每个连接器 URL 都包含工作区 ID、连接器 ID 和 API 密钥令牌。令牌在创建时仅显示一次。之后 Dokki 仅存储哈希和可见前缀,因此在关闭对话框之前请复制生成的令牌或客户端配置。

连接器是工作区锁定的。为一个工作区创建的文档连接器无法读取另一个工作区的资源。发布连接器无法管理另一个工作区的公共站点。

客户端代码片段

创建后,Dokki 可以复制可直接粘贴的代码片段,用于 MCP 客户端,如 Claude Desktop、Codex CLI 和 Codex App 环境配置。该片段嵌入了自包含的连接器 URL。

撤销与状态

撤销连接器会将其状态设置为已撤销,而不是删除该行,因此工作区会保留轻量级的审计跟踪。连接器列表显示活动、过期和已撤销的凭证,以及创建日期和最后使用日期(如有)。

何时创建独立的连接器

  • 为不同的外部客户端或自动化任务使用独立的连接器。

  • 仅对应该管理公共站点状态的客户端使用发布连接器。

  • 如果令牌暴露、复制到错误的环境或不再需要,请立即撤销凭证。