> ## 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，即可運用您組織的業務知識與營運脈絡。

此 connector 可以尋找並編輯 Page、讀取檔案與已連線的紀錄、建立 Task、管理可重複使用的 Skill，以及建立或執行 Automation。可用的工具取決於已連線的身分、授予的權限與已啟用的產品功能。

## 套用範本

當 `tools/list` 中提供 `templates.apply` 時，請提供已發布的 `templateId` 與既有的 `spaceId`，以建立範本的所有資源。應用程式、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 授權以及已連線來源的存取權仍然適用。

連線到外部業務系統的 Connection 必須先在 Flowglad 中設定並開放給預定的 Space，agent 才能使用。請參閱 [Connectors](/docs/zh-Hant/connectors.md) 與 [Spaces](/docs/zh-Hant/spaces.md)。

## 找到您的組織 URL

正式環境的 connector 使用組織專屬的 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)。

此 connector 請使用組織 URL。Connection 專屬的 URL 可能只會公開較少的工具，無法與此處所述的組織 URL 互換使用。

## 從 Claude Desktop 連線

觀看 [Claude Desktop 設定影片](https://youtu.be/6qqSnrqDJ2o)，或依照下列步驟操作。

[如何將 Flowglad 連線到 Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

使用 Claude Desktop 的自訂 connector 流程新增 Flowglad，並授權存取您的帳號。

**1. 開啟自訂 connector 表單。**

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

**2. 新增 Flowglad connector。**

輸入 **Flowglad** 作為 connector 名稱，或選擇其他名稱。

將完整的組織 MCP URL 貼到 URL 欄位。您可以從 [Settings > MCP](https://dashboard.flowglad.com/settings/mcp) 複製。它看起來應該像這樣：`https://dashboard.flowglad.com/api/mcp/orgs/org_...`

不要變更任何其他 connector 設定。選取 **Add** 以繼續。在某些版本中，Claude Desktop 可能會將此按鈕標示為 **Continue**。

**3. 授予 Claude 存取 Flowglad 的權限。**

繼續完成連線流程，授權 Claude 存取您的 Flowglad 帳號。出現提示時，請登入、確認預定的 Flowglad 組織，並在授權之前檢閱所要求的存取權。

流程完成後，返回 Claude Desktop 並確認 Flowglad 連線已可使用。請 Claude 檢查 Flowglad 連線，並列出您可以存取的 Space。

OAuth Dynamic Client Registration 是預定的連線方式。不要在伺服器 URL 中加入密碼、存取權杖、API 金鑰或用戶端密鑰。

這些說明描述的是將 Flowglad 直接連線為自訂 connector；目錄中的可用性則是另一回事。

## 連線其他 MCP 用戶端

將相同的組織 URL 新增為遠端 Streamable HTTP MCP 伺服器。使用您的 Flowglad 帳號完成用戶端的 OAuth 流程，然後確認組織與可用的工具。

各用戶端的支援程度不一。成功連線到伺服器，並不代表用戶端會自動匯入 Flowglad Skill。Skill 探索擴充功能與 `skills.list` 工具是不同的介面。如需支援的探索與套件管理行為，請參閱 [Skills](/docs/zh-Hant/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，請重新連線。 |
| 無法讀取已連線的供應商 | 確認其授權仍有效，且該 Connection 已開放給預定的 Space。 |
| 找不到 Page 或檔案 | 確認 Space 正確、其直接與連結的存取權，以及來源仍可使用。 |
| 操作回傳 job 或 run ID | 在回報成功或重試之前，先檢查其最終的生命週期或執行狀態。 |
| 寫入逾時 | 重試之前，先檢查它是否已完成。有些操作每次呼叫都會建立新紀錄或將工作加入佇列。 |
| 存取權到期或遭撤銷 | 透過 OAuth 重新連線，並確認預定的組織與授權。如果重新連線仍然失敗，請聯絡支援團隊。 |

如需一般安全性資訊，請參閱 [Security](/docs/zh-Hant/security.md) 與我們的 [Trust Center](https://trust.flowglad.com)。如果您在連線時遇到任何問題，請[與我們聯絡](mailto:support@flowglad.com)。

聯絡支援團隊時，請附上時間、用戶端、受影響的工具、安全的錯誤代碼，以及請求 ID（如有）。切勿附上密碼、bearer 權杖、cookie、已簽署的上傳／下載 URL 或客戶資料。


## Related topics

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


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