OpenWork Connect MCP Server

什么是 OpenWork Connect MCP Server？

OpenWork Connect MCP Server 是 OpenWork 托管的 MCP 网关：只需一个 URL，Claude Code、Codex、Cursor、VS Code、ChatGPT 等 MCP 客户端即可访问你团队共享的技能（skills）以及你在 OpenWork 中连接的工具。

OpenWork 是面向知识工作者的开源桌面应用（支持 macOS、Windows 和 Linux），并为团队提供云端工作区。Connect 让应用之外的智能体也能复用团队已配置好的内容。你只需在 OpenWork 中连接一次 Google Workspace、Microsoft 365、Linear、Slack、Notion、GitHub、HubSpot 或任意 MCP 服务器，所有添加了该网关 URL 的客户端都可以使用它们。技能的修改会在每位队友的下一次调用中生效，并且每次调用都会检查访问权限。

如何使用 OpenWork Connect MCP Server？

端点为 https://api.openworklabs.com/mcp/agent，传输方式为 Streamable HTTP。所有客户端都使用 OAuth：添加 URL 后，客户端会打开浏览器，你在其中登录（或创建免费账号）并选择一个组织。组织会绑定到令牌上。只有在管理员于 OpenWork Cloud 中发布技能并授予你访问权限后，技能才会出现。

Claude Code

claude mcp add --transport http openwork https://api.openworklabs.com/mcp/agent

然后运行 /mcp，选择 openwork，并在浏览器中登录。加上 -s user 可让该服务器在所有项目中可用。

Claude Desktop 与 claude.ai

打开 Settings，进入 Connectors，选择 Add custom connector，粘贴 https://api.openworklabs.com/mcp/agent。按提示登录。

Cursor

OpenWork 提供“Add to Cursor”链接，或将 URL 添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "openwork": {
      "url": "https://api.openworklabs.com/mcp/agent"
    }
  }
}

VS Code

OpenWork 文档给出了以下命令：

code --add-mcp '{"name":"openwork","type":"http","url":"https://api.openworklabs.com/mcp/agent"}'

或将服务器添加到 .vscode/mcp.json：

{
  "servers": {
    "openwork": {
      "type": "http",
      "url": "https://api.openworklabs.com/mcp/agent"
    }
  }
}

然后运行 MCP: List Servers，选择 openwork，再选择 Start Server。

OpenWork 的指南还介绍了 Codex（codex mcp add openwork --url https://api.openworklabs.com/mcp/agent，然后 codex mcp login openwork）、Gemini CLI、OpenCode、ChatGPT、Windsurf 和 Zed 的配置。OpenWork 说明只有 OpenCode 经过了端到端验证，其他客户端遵循其 OAuth 配置规范。

OpenWork Connect MCP Server 的主要功能

• 一个端点适用多个客户端：同一 URL 可用于 Claude Code、Codex、Cursor、VS Code、OpenCode、Gemini CLI 和 ChatGPT。
• 共享技能：智能体能看到每个技能的名称和描述，只有任务需要时才加载完整的 SKILL.md。
• 已连接工具：在 OpenWork 中连接一次的服务，可通过网关提供给所有客户端。
• 实时更新：技能修改会在每位队友的下一次调用中生效，无需重新安装。
• 每次调用都进行访问控制，与令牌绑定的组织关联。
• 支持自托管：自托管部署使用自己的 API 地址，默认为 https://api.<your-den-web-host>/mcp/agent。

OpenWork 的 Connect 页面介绍了四个工具：search_capabilities、execute_capability、list_skills 和 get_skill。由于该端点需要登录，我们的探测未能列出工具。

OpenWork Connect MCP Server 的使用场景

• 在编码智能体中复用团队技能：“列出我们的 OpenWork 技能，并对这个分支使用 release-notes 技能。”
• 从任意客户端访问已连接的服务：“在我们的能力中搜索 Linear，并为这个 bug 创建一个 issue。”
• 整个团队共用一套集成，而不必在每个编辑器中分别配置各个 MCP 服务器。
• 推出更新后的技能：管理员在 OpenWork 中修改后，队友在下一次调用时即可获得新版本。
• 在 Claude Code 和 Cursor 之间切换，同时保留对相同工具的访问。

OpenWork Connect MCP Server 常见问题排查

• 出现 401 或 invalid_grant 错误：在客户端中退出 openwork 服务器的登录，然后重新登录。
• 组织不对：组织绑定在令牌上。退出 openwork 后重新登录，并选择另一个组织。
• 看不到任何技能：只有在管理员于 OpenWork Cloud 中发布技能并授予你访问权限后，技能才会出现。
• 特定客户端的登录问题：OpenWork 只对 OpenCode 做了端到端验证；对于其他客户端，请重新执行其 MCP 认证步骤（例如 Claude Code 中的 /mcp 或 codex mcp login openwork）。