MCP¶

MCP 任務讓你在工作流程 (Workflow) 的某個步驟裡，呼叫某台 MCP (Model Context Protocol) 伺服器所提供的「工具」。MCP 伺服器是一種以標準協定對外提供工具的服務，例如把公司既有的 API、Lambda 函式或自訂 Python 程式碼包成可呼叫的工具。透過這個任務，你可以把那些工具當成工作流程的一步來執行。

這頁能幫你做什麼¶

在工作流程中直接呼叫 MCP 伺服器提供的某個工具。
把上一步的資料整理成工具需要的參數後傳入，並把工具回傳結果交給下一步。
重複使用已建立好的 MCP 伺服器資源，擴充工作流程能做的事。

開始前¶

需要先建立 MCP 伺服器資源

這個任務只負責「呼叫」，不負責建立工具。請先到資源頁建立並設定好一台 MCP 伺服器，裡面定義要提供哪些工具。建立方式見 MCP 伺服器資源。若該伺服器採 OAuth 登入認證，需先完成授權才能載入工具清單。

操作步驟¶

在工作流程編輯器中新增一個 MCP 任務（如何新增請見任務使用指南）。

上圖是全部設定完成後的樣子（伺服器、工具都選好，「輸入」已依工具規格展開）。剛加上節點時「MCP 伺服器」與「工具」都還是空的，照下面的步驟一格一格填。
點選節點，右側開啟設定表單，停在「設定」分頁。
在「名稱」欄位為這個步驟取一個好辨識的名字。
在「MCP 伺服器」欄位右側點鉛筆圖示（），開啟「MCP 伺服器」挑選對話框，從中選擇你建立好的 MCP 伺服器資源。選取時請點該列「名稱」以外的任一格（或列前面的圓鈕）——點「名稱」會在新分頁開啟該資源的詳細頁，不會選取它（見資源挑選欄位）。
選好伺服器後，下方會出現「工具」欄位。它不是可以直接展開的下拉選單——點這個欄位（或右側的鉛筆圖示）會開啟工具挑選對話框，從那台伺服器提供的工具清單裡選一個，再按對話框的「儲存」。
選好工具後，下方才會出現「輸入」欄位，並依該工具自己的輸入規格逐欄顯示（如上圖的「Query」「Library Name」；欄位名稱與下方的說明文字都是工具本身提供的，常常是英文）。逐欄填入要傳給工具的值。

要讓某個參數的值來自上一步，先切成 JSON 模式

逐欄顯示時，每一格都是單純的文字框，格子本身沒有 JSONPath 開關，打進去的內容就是一段固定文字。要動態取值，把滑鼠移到「輸入」這個標籤上，右側會浮出「JSON」與「JSONPath」兩個開關（見任務通用設定 — 欄位的輸入方式切換）：打開「JSON」後整個「輸入」變成 JSON 編輯器，就能用 { "參數名.$": "$.路徑" } 的寫法（鍵名結尾的 .$ 不可省略，規則見傳遞資料 › 動態取值要在鍵名結尾加 .$）；下方「實際範例」那段 JSON 就是這個模式的長相。
1. 設定「下一個狀態」。
2. 可用表單上方的「測試任務」按鈕（）試跑，確認回傳結果符合預期。

完整欄位說明¶

設定分頁¶

欄位	必填	預設	說明
名稱	是	無	這個步驟在工作流程中的識別名稱，須在同一工作流程內唯一。詳見任務通用設定。
MCP 伺服器	是	無	選擇要使用的 MCP 伺服器資源（提供工具的來源）。點欄位右側鉛筆圖示（）開啟「MCP 伺服器」挑選對話框，對話框含搜尋框、搜尋框右側的重新整理（）鈕、伺服器表格（欄位：名稱、ID、類型、狀態、最後更新；「狀態」顯示「就緒」才是可以直接用的伺服器，若該台需要 OAuth 授權而尚未完成授權，狀態不會是「就緒」，要先到資源頁完成授權）、「＋」建立鈕，以及「取消」與「儲存」按鈕；在表格選一台再按「儲存」即套用。也可切換成由工作流程輸入動態帶入伺服器 ID。
工具	是	無	要呼叫的工具。不是可以直接展開的下拉選單——點這個欄位或右側的鉛筆圖示會開啟工具挑選對話框，清單來自上方所選伺服器實際提供的工具，選完按「儲存」。選定後系統會依該工具的輸入規格自動產生下方「輸入」欄位的範本。也可切換成由工作流程輸入動態帶入工具名稱。
輸入	否	依工具規格自動產生的範本	要傳給工具的參數。表單會依工具的輸入規格 (input schema) 逐欄顯示，每欄的名稱與說明文字由工具本身提供（常是英文）；每個欄位可填固定值，或用 JSONPath 從上一步輸出帶入。只有選好工具後才會出現。若填入的內容不符合該工具的輸入規格，欄位會自動切成 JSON 編輯器模式。
下一個狀態	是	無	這步完成後要前往的下一個步驟。詳見任務通用設定。
附註	否	空白	給這個步驟的備註說明，不影響執行。

三個欄位有先後相依關係

必須先選好「MCP 伺服器」，工具選擇器才會出現；選好工具後，「輸入」欄位才會依該工具的輸入規格出現。換掉伺服器或工具時，下方已選的工具與輸入會跟著重設。

執行設定（摺疊區塊）¶

展開「設定」分頁底部的「執行設定」可看到下列共用欄位，完整說明見任務通用設定。

欄位	必填	預設	說明
上傳輸出至外部記憶體	否	關閉	開啟後這步的輸出改存到外部記憶體，適合輸出資料量很大時使用。
在任務開始階段開啟即時輸出串流	否	關閉	開啟後，任務開始時把任務定義以串流方式即時送到執行頁面顯示。
在任務結束階段開啟即時輸出串流	否	關閉	開啟後，任務結束時把結果以串流方式即時送到執行頁面顯示。
錯誤時中止	否	開啟	開啟（預設）代表這步出錯時整個工作流程中止；關閉後改用下方「預設輸出」繼續往下走。
預設輸出	否	無	只在關閉「錯誤時中止」時出現，指定出錯時要改用的替代輸出值。它展開後是一組英文標籤的子欄位（`Errors` ＋這個任務的輸出欄位），見預設輸出的子欄位。

輸入與輸出、錯誤處理¶

切到「輸入與輸出」、「錯誤處理」分頁可調整資料流與重試／捕捉規則，皆為各任務共用設定，完整說明見任務通用設定。

實際範例¶

假設你的 MCP 伺服器提供一個 calculate_discount 工具，依小計與客戶等級算出折扣。

MCP 伺服器：選擇你建立好的伺服器資源
工具：calculate_discount
輸入（打開「輸入」標籤右側的「JSON」開關，改用 JSON 模式填；鍵名結尾要加 .$）：

{
  "subtotal.$": "$.order.subtotal",
  "customer_tier.$": "$.order.tier"
}

執行時平台會把上一步的小計與等級帶入，呼叫工具後把折扣結果交給下一步使用。

下一步¶

先到 MCP 伺服器資源建立並設定要提供的工具。
回到任務使用指南了解共用設定與其他任務類型。