> ## 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

> 将兼容 MCP 的 agent 连接到 Flowglad

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

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

## 应用模板

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

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

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

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

## 连接之前

您需要：

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

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

在 agent 使用外部业务系统之前，必须先在 Flowglad 中配置与这些系统的 Connection，并将其开放给目标 Space。请参阅 [Connectors](/docs/zh-CN/connectors.md) 和 [Spaces](/docs/zh-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。特定于 connection 的 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) 复制该 URL。它应类似于：`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 动态客户端注册（Dynamic Client Registration）是预期的连接方式。不要在服务器 URL 中添加密码、访问令牌、API 密钥或客户端密钥。

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

## 连接其他 MCP 客户端

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

客户端的支持情况各不相同。成功连接服务器并不意味着客户端会自动导入 Flowglad Skill。Skill 发现扩展与 `skills.list` 工具是不同的接口。有关受支持的发现和包管理行为，请参阅 [Skills](/docs/zh-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/zh-CN/security.md) 和我们的 [Trust Center](https://trust.flowglad.com)。如果您在连接时遇到任何问题，请[联系我们](mailto:support@flowglad.com)。

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


## Related topics

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


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