> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> 用组织专属 URL 和 OAuth 将 Claude Desktop 等 MCP 客户端接入 Flowglad，使用 Page、Skill 等功能。

将兼容 MCP 的 agent 连接到 Flowglad，即可使用您组织的业务知识和运营上下文。

该连接器可以查找和编辑 Page、读取文件和已连接的记录、创建 Task、管理可复用的 Skill，以及创建或运行 Automation。可用的工具取决于所连接的身份、已授予的权限以及已启用的产品功能。

## 应用模板

当 `templates.apply` 出现在 `tools/list` 中时，提供已发布的 `templateId` 和现有的 `spaceId`，即可创建该模板的所有资源。Application、Automation 和普通文件副本属于该 Space；Skill 属于组织。文件会使用其配置的文件名保存在 Space 根目录中，并且绝不会覆盖现有文件。同名冲突会导致该组件失败，而相互独立的组件可以继续。文件完成表示其字节和元数据已持久保存；这不会等待索引完成。

您还可以选择提供 `connections`，它是由 `{ connector, connectionId }` 对象组成的数组，每个提供商最多一个连接。所提供的连接必须可访问、兼容，并在需要时已分配给该 Space。省略连接会使资源处于等待配置状态。响应会推荐符合条件的连接；如果没有可用连接，则会建议创建一个连接。

创建过程在单个 Trigger.dev 任务中按依赖顺序运行，各组件的结果会记录在任务元数据和输出中。整个任务的自动重试已禁用；失败或中断的任务可能会留下部分资源。响应会确认创建已加入队列，并包含计划的组件和连接建议；它不会确认资源已创建完成。请使用这些资源的 list/get 工具查找并检查它们。如果其他组件失败，已成功创建的资源仍会保留。

应用模板会推迟可执行验证，并且不会激活或运行其资源。每次应用调用都会创建新的副本，包括重试。请使用资源工具检查已创建的内容。

## 连接之前

您需要：

* 一个有权访问目标组织的 Flowglad 账号。
* 您组织的生产环境 MCP URL。
* 一个支持通过 Streamable HTTP 和 OAuth 连接远程 MCP 服务器的 agent 或客户端。
* 完成预期工作所需的组织和 Space 权限。
* 相关 Space 已可使用的任何源 Connection 或文件。

[Flowglad 首页](https://www.flowglad.com/)上公布的定价部分显示，Free、Plus 和 Max 方案均包含 MCP。组织和 Space 权限、OAuth 授权以及已连接数据源的访问权限仍然适用。

必须先在 Flowglad 中配置与外部业务系统的连接并将其开放给目标 Space，agent 才能使用它们。请参阅 [Connectors](/docs/cn/connectors.md) 和 [Spaces](/docs/cn/spaces.md)。

## 查找您的组织 URL

生产环境连接器使用组织专属的 URL：

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

将 `{orgId}` 替换为您实际的 Flowglad 组织 ID。保留完整的 ID，包括其 `org_` 前缀。不要输入花括号或虚构的组织 ID。

在 Flowglad 中，打开 **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**。复制其中显示的组织 MCP URL。远程 URL 请使用 **Website** 说明；单独的 **Desktop app** 标签页包含命令行设置说明。

如果您无法访问这些设置，请联系您的 Flowglad 管理员或[支持团队](mailto:support@flowglad.com)。

此连接器请使用组织 URL。连接专属的 URL 可能只公开较少的工具集，不能与此处描述的组织 URL 互换使用。

## 从 Claude Desktop 连接

观看 [Claude Desktop 设置视频](https://youtu.be/6qqSnrqDJ2o)，或按照以下步骤操作。

[如何将 Flowglad 连接到 Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

使用 Claude Desktop 的自定义连接器流程添加 Flowglad，并授权其访问您的账号。

**1. 打开自定义连接器表单。**

在 Claude Desktop 中，前往 **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**。

**2. 添加 Flowglad 连接器。**

输入 **Flowglad** 作为连接器名称，或选择其他名称。

将完整的组织 MCP URL 粘贴到 URL 字段中。您可以从 [Settings > MCP](https://dashboard.flowglad.com/settings/mcp) 复制它。它应类似于：`https://dashboard.flowglad.com/api/mcp/orgs/org_...`

不要更改任何其他连接器设置。选择 **Add** 继续。在某些版本中，Claude Desktop 可能将此按钮标记为 **Continue**。

**3. 授予 Claude 访问 Flowglad 的权限。**

继续完成连接流程，授权 Claude 访问您的 Flowglad 账号。出现提示时，请登录、确认目标 Flowglad 组织，并在授权前查看所请求的访问权限。

流程完成后，返回 Claude Desktop 并确认 Flowglad 连接可用。让 Claude 检查 Flowglad 连接并列出您可以访问的 Space。

OAuth 动态客户端注册是预期的连接方式。不要在服务器 URL 中添加密码、访问令牌、API 密钥或客户端密钥。

这些说明介绍的是将 Flowglad 直接作为自定义连接器进行连接；是否在目录中上架是另一回事。

## 连接其他 MCP 客户端

将相同的组织 URL 添加为远程 Streamable HTTP MCP 服务器。使用您的 Flowglad 账号完成客户端的 OAuth 流程，然后验证组织和可用工具。

各客户端的支持情况不同。服务器连接成功并不意味着客户端会自动导入 Flowglad Skill。Skill 发现扩展和 `skills.list` 工具是不同的接口。有关支持的发现和包管理行为，请参阅 [Skills](/docs/cn/skills.md)。

## 数据处理

Flowglad MCP 的使用受 [Flowglad 隐私政策](https://www.flowglad.com/privacy-policy)约束。组织管理员可以在 [Settings > Audit](https://dashboard.flowglad.com/settings/audit) 中查看对您组织发起的所有 MCP 工具调用。

## 故障排查

| 症状 | 下一步 |
| - | - |
| 登录前连接失败 | 检查完整的 HTTPS URL 和组织 ID。确认客户端支持带 OAuth 的远程 MCP。 |
| 登录成功但无法开展工作 | 检查所选组织、Space membership、MCP 授权以及该 Space 可用的 Connection。 |
| 写入工具不可用或被拒绝 | 确认所需的组织和 Space 权限。如果需要新授予的 OAuth scope，请重新连接。 |
| 无法读取已连接的 provider | 确认其授权处于有效状态，且该 Connection 已开放给目标 Space。 |
| 找不到 Page 或文件 | 确认 Space 正确、其直接访问和链接访问权限，以及数据源仍然可用。 |
| 操作返回 job 或 run ID | 在报告成功或重试之前，检查其最终生命周期或运行状态。 |
| 写入超时 | 在重试之前检查其是否已完成。某些操作每次调用都会创建新记录或将工作加入队列。 |
| 访问过期或被撤销 | 通过 OAuth 重新连接，并验证目标组织和授权。如果仍无法重新连接，请联系支持团队。 |

有关一般安全信息，请参阅 [Security](/docs/cn/security.md) 和我们的 [Trust Center](https://trust.flowglad.com)。如果您在连接时遇到任何问题，请[联系我们](mailto:support@flowglad.com)。

联系支持团队时，请提供时间、客户端、受影响的工具、安全的错误代码以及请求 ID（如有）。切勿提供密码、bearer token、cookie、签名的上传/下载 URL 或客户数据。


## Related topics

- [Skills](/docs/cn/skills.md)
- [欢迎](/docs/cn/agents/introduction.md)
- [Automations](/docs/cn/automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.