连接 AI 应用

Claude、ChatGPT、Cursor、Codex 或任何其他支持 MCP 的 AI 客户端，都可以自行连接到 VentionDesk——无需 API 密钥。应用通过您的 VentionDesk 账户登录，连接时由您决定它可以做什么。所有者和员工均可使用；客户门户的客户账户不能连接 AI 应用。

面向国际用户和应用目录的页面（含所有工具列表和示例提示词）：Connect AI apps to VentionDesk。

连接如何进行

1. 填写 URL。 在 AI 应用中添加一个 MCP 服务器（通常称为“connector”或“integration”），URL 为：https://api.ventiondesk.com/mcp。应用不需要其他任何信息——它会自行找到登录入口。
2. 登录。 应用会打开一个浏览器窗口，显示 VentionDesk 登录页。如果已登录，则直接继续。
3. 授权。 VentionDesk 显示一个带有应用名称的授权页面（位于 /oauth/zustimmen）。在那里选择：
   • 工作区（如果您属于多个工作区），
   • 权限——员工只能选择所有者已为 AI 应用开放的权限，
   • 项目——全部（包括将来的项目）或部分项目。
4. 已连接。 授权后返回应用。从此，应用恰好以这些权限工作——而不是以您自己的权限。如果拒绝，连接即中止，不会保存任何内容。

应用获得与代理密钥相同的工具（参见 Claude 与 MCP）；工具可以做什么，由所选权限决定。应用读取的内容会传给其服务商——例如 Anthropic、OpenAI 或 Anysphere。工作区是否可以这样做，由工作区自行决定；对于工单、客户数据和带姓名的工时，通常需要与该服务商签订数据处理协议。

Claude

claude.ai 和 Claude Desktop： 在 Settings › Connectors 下添加自定义连接器，名称填“VentionDesk”，URL 填 https://api.ventiondesk.com/mcp。然后点击“Connect”——登录和授权流程同上。您的套餐和组织是否启用了自定义连接器，由 Anthropic 或您的 Claude 管理员决定。

Claude Code： 在终端中执行

claude mcp add --transport http ventiondesk https://api.ventiondesk.com/mcp

然后在 Claude Code 中调用 /mcp 并登录“ventiondesk”。如果更喜欢使用固定密钥，请参阅 Claude 与 MCP。

像使用 /aufgaben 一样处理任务——在没有文件系统的应用中也可以：“Work on the next open VentionDesk task”。Claude 按与任务 runner 相同的规则领取下一个任务，读取描述、历史记录和项目，仅在需要时获取截图，带凭证反馈结果并结束运行。为此，连接需要“Claude runner”模板的权限（读取并反馈任务、管理运行、读取项目）。

ChatGPT

在设置的 Connectors 下（视版本而定为“Apps & Connectors”；自定义 MCP 服务器需要开发者模式）新建连接器：URL 为 https://api.ventiondesk.com/mcp，认证方式为 OAuth。首次使用时进行登录和授权。哪些套餐允许自定义连接器，由 OpenAI 决定。

Cursor

在 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（仅当前项目）中：

{
  "mcpServers": {
    "ventiondesk": {
      "url": "https://api.ventiondesk.com/mcp"
    }
  }
}

随后 Cursor 会在 Settings › MCP 下显示该服务器，并附有登录提示；点击即开始登录和授权。

Codex

在 ~/.codex/config.toml 中：

[mcp_servers.ventiondesk]
url = "https://api.ventiondesk.com/mcp"

然后执行 codex mcp login ventiondesk——浏览器会打开登录和授权页面。旧版 Codex 只有在打开额外开关后才支持基于 HTTP 的 MCP；如有疑问，请查看所用 Codex 版本的帮助。

其他客户端

所有支持基于 HTTP 的 MCP（“Streamable HTTP”）并支持 OAuth 的客户端都能自行找到入口：对于未登录的请求，https://api.ventiondesk.com/mcp 返回 401，并指向 https://api.ventiondesk.com/.well-known/oauth-protected-resource；VentionDesk 的登录服务就列在那里。客户端会在那里自行注册——无需事先创建任何内容。

客户端请求的 OAuth 权限范围（openid、email、profile）只涉及登录。应用在 VentionDesk 中可以做什么，在授权页面上选择。

断开连接与过期

在 设置 › 我的 AI 应用 下，可以看到您在所有工作区中的连接：应用、权限、项目、连接日期和最近使用时间。“断开” 会立即结束连接——应用已获得的登录凭据此后也会失效。对于自己的连接，VentionDesk 还会撤回登录时的批准；再次连接该应用时，VentionDesk 会重新询问。

连续 90 天未使用的连接会自动结束。需要时重新连接应用即可。

作为 所有者，还可以在那里看到工作区中所有人员的连接，并可断开其中任何一个。所有者还决定员工可以授予 AI 应用哪些权限。默认是“只读”和“Claude runner”模板中的权限——读取项目、任务和部署，反馈任务并记录运行——不涉及任何敏感内容。所有者本人可以授予除“记录访问”以外的所有权限，后者仅限运营方。如果收窄开放范围，它会从应用下一次获取令牌起对现有连接生效——通常在一小时内。

每次连接和断开都会出现在工作区的日志中；应用所做的更改，只要 VentionDesk 有记录，也会出现在那里——均注明应用和人员，例如“AI 应用：Claude · Anna Schmidt”。

AI 应用还是 API 密钥？