MCP¶
MCP 任務讓你在工作流程 (Workflow) 的某個步驟裡，呼叫某台 MCP (Model Context Protocol) 伺服器所提供的「工具」。MCP 伺服器是一種以標準協定對外提供工具的服務，例如把公司既有的 API、Lambda 函式或自訂 Python 程式碼包成可呼叫的工具。透過這個任務，你可以把那些工具當成工作流程的一步來執行。
這頁能幫你做什麼¶
- 在工作流程中直接呼叫 MCP 伺服器提供的某個工具。
- 把上一步的資料整理成工具需要的參數後傳入，並把工具回傳結果交給下一步。
- 重複使用已建立好的 MCP 伺服器資源，擴充工作流程能做的事。
開始前¶
需要先建立 MCP 伺服器資源
這個任務只負責「呼叫」，不負責建立工具。請先到資源頁建立並設定好一台 MCP 伺服器，裡面定義要提供哪些工具。建立方式見 MCP 伺服器資源。若該伺服器採 OAuth 登入認證，需先完成 授權 才能載入工具清單。
操作步驟¶
-
在工作流程編輯器中新增一個 MCP 任務（如何新增請見 Action 使用指南）。
-
點選節點，右側開啟設定表單，停在「設定」分頁。
- 在「名稱」欄位為這個步驟取一個好辨識的名字。
-
在「MCP 伺服器」欄位右側點鉛筆圖示（），開啟「MCP 伺服器」挑選對話框，從中選擇你建立好的 MCP 伺服器資源。
-
選好伺服器後，下方會出現工具選擇器，挑選要呼叫的工具。
- 選好工具後，下方會依工具的輸入規格出現「輸入 (Input)」欄位，填入要傳給工具的參數（可填固定值，也可用 JSONPath 從上一步取值）。
- 設定「下一個狀態」。
- 可用表單上方的測試按鈕（）試跑，確認回傳結果符合預期。
完整欄位說明¶
設定分頁¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 (Name) | 是 | 無 | 這個步驟在工作流程中的識別名稱，須在同一工作流程內唯一。詳見 Action 通用設定。 |
| MCP 伺服器 | 是 | 無 | 選擇要使用的 MCP 伺服器資源（提供工具的來源）。點欄位右側鉛筆圖示（）開啟「MCP 伺服器」挑選對話框，對話框含搜尋框、伺服器表格（欄位：名稱、ID、類型、狀態、最後更新）、「＋」建立鈕，以及「取消」與「儲存」按鈕；在表格選一台再按「儲存」即套用。也可切換成由工作流程輸入動態帶入伺服器 ID。 |
| 工具 (Tool) | 是 | 無 | 選擇要呼叫的工具。選項來自上方所選 MCP 伺服器實際提供的工具清單。選定後系統會依該工具的輸入規格自動產生下方輸入欄位的範本。也可切換成由工作流程輸入動態帶入工具名稱。 |
| 輸入 (Input) | 否 | 依工具規格自動產生的範本 | 要傳給工具的參數。表單會依工具的輸入規格 (input schema) 顯示對應欄位；每個欄位可填固定值，或用 JSONPath 從上一步輸出帶入。只有選好工具後才會出現。 |
| 下一個狀態 (Next State) | 是 | 無 | 這步完成後要前往的下一個步驟。詳見 Action 通用設定。 |
| 附註 (Comment) | 否 | 空白 | 給這個步驟的備註說明，不影響執行。 |
三個欄位有先後相依關係
必須先選好「MCP 伺服器」，工具選擇器才會出現；選好工具後，「輸入」欄位才會依該工具的輸入規格出現。換掉伺服器或工具時，下方已選的工具與輸入會跟著重設。
執行設定（摺疊區塊）¶
展開「設定」分頁底部的「執行設定」可看到下列共用欄位，完整說明見 Action 通用設定。
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 上傳輸出至外部記憶體 | 否 | 關閉 | 開啟後這步的輸出改存到外部記憶體，適合輸出資料量很大時使用。 |
| 在任務開始階段開啟即時輸出串流 | 否 | 關閉 | 開啟後，任務開始時把任務定義以串流方式即時送到執行頁面顯示。 |
| 在任務結束階段開啟即時輸出串流 | 否 | 關閉 | 開啟後，任務結束時把結果以串流方式即時送到執行頁面顯示。 |
| 錯誤時中止 (Abort on Error) | 否 | 開啟 | 開啟（預設）代表這步出錯時整個工作流程中止；關閉後改用下方「預設輸出」繼續往下走。 |
| 預設輸出 (Default Output) | 否 | 無 | 只在關閉「錯誤時中止」時出現，指定出錯時要改用的替代輸出值。 |
輸入與輸出、錯誤處理¶
切到「輸入與輸出」、「錯誤處理」分頁可調整資料流與重試／捕捉規則，皆為各 Action 共用設定，完整說明見 Action 通用設定。
實際範例¶
假設你的 MCP 伺服器提供一個 calculate_discount 工具，依小計與客戶等級算出折扣。
- MCP 伺服器：選擇你建立好的伺服器資源
- 工具：
calculate_discount - 輸入：
{
"subtotal": "$.order.subtotal",
"customer_tier": "$.order.tier"
}
執行時平台會把上一步的小計與等級帶入，呼叫工具後把折扣結果交給下一步使用。
下一步¶
- 先到 MCP 伺服器資源 建立並設定要提供的工具。
- 回到 Action 使用指南 了解共用設定與其他 Action 類型。