> ## 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，即可使用组织的业务知识和运营上下文开展工作。

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

## 应用模板

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

你可以选择以 `{ connector, connectionId }` 对象数组的形式提供 `connections`，每个提供方最多一个 Connection。所提供的 Connections 必须可访问、兼容，并在需要时已分配给该 Space。省略 Connections 会使相关资源处于等待配置状态。响应会推荐符合条件的 Connections；如果没有可用的 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 授权以及已连接源的访问权限仍然适用。

与外部业务系统的连接必须先在 Flowglad 中配置并开放给目标 Space，agent 才能使用。请参阅 [Connectors](/docs/zh-Hans/connectors.md) 和 [Spaces](/docs/zh-Hans/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) 复制该 URL。它应类似于：`https://dashboard.flowglad.com/api/mcp/orgs/org_...`

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

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

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

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

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

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

## 连接其他 MCP 客户端

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

不同客户端的支持情况各不相同。成功连接到服务器并不意味着客户端会自动导入 Flowglad Skills。Skill 发现扩展和 `skills.list` 工具是不同的接口。有关受支持的发现和包管理行为，请参阅 [Skills](/docs/zh-Hans/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 成员资格、MCP 授权以及该 Space 可用的 Connections。 |
| 写入工具不可用或被拒绝 | 确认所需的组织和 Space 权限。如果需要新授予的 OAuth scope，请重新连接。 |
| 无法读取已连接的提供方 | 确认其授权处于有效状态，并且该 Connection 已开放给目标 Space。 |
| 找不到 Page 或文件 | 确认 Space 正确、其直接访问和关联访问权限，以及源仍然可用。 |
| 操作返回了 job 或 run ID | 在报告成功或重试之前，检查其最终生命周期或运行状态。 |
| 写入超时 | 在重试之前检查它是否已经完成。某些操作在每次调用时都会创建新记录或将工作加入队列。 |
| 访问过期或被撤销 | 通过 OAuth 重新连接，并验证目标组织和授权。如果重新连接仍然失败，请联系支持团队。 |

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

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


## Related topics

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


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