MCP 伺服器¶
這頁能幫你做什麼¶
MCP 伺服器 (MCP Server) 幫你把一組「工具」接到平台，讓 Agent 可以呼叫這些工具去做事，例如查 API、跑資料庫查詢、執行程式碼或呼叫其他 Agent。MCP (Model Context Protocol) 是一種讓 AI 與外部工具溝通的協定。
平台支援兩種接法：連到既有的遠端 MCP 伺服器（Streamable HTTP），或直接在平台內自訂工具（Custom）。建立時先填名稱、選類型，畫面會依類型顯示對應欄位。
開始前¶
前置需求
- Streamable HTTP：需備妥遠端 MCP 伺服器的端點 URL，以及（若需要）認證方式。若採「HTTP 連結器標頭」認證，需先建立一個 HTTP 連結器 (Connector) 來存放共用的驗證標頭。
- Custom：依工具種類可能需先建立其他資源，例如 MySQL／OpenSearch 連結器 (Connector)、檢索器 (Retriever)、要被呼叫的 Agent 等。請參考對應資源頁。
兩種接法怎麼選
- 你已經有一台跑在外部、符合 MCP 協定的伺服器，只想把它接進來 → 選 Streamable HTTP，填好端點 URL 與認證即可。
- 你沒有現成的 MCP 伺服器，想直接在平台裡把幾個動作（呼叫 API、查資料庫、跑程式碼、呼叫 Agent…）包成工具 → 選 Custom，不必另外架伺服器。
操作步驟¶
-
從左側資源選單進入「MCP 伺服器」清單頁，點建立入口（空清單時是有文字的建立按鈕；清單已有項目時是右上角無文字的「+」圖示）開啟建立表單。
-
在「名稱」欄輸入容易辨識的名稱（例如
docs-remote-mcp）。 - 在「類型」下拉選單選擇接法。不同類型會出現不同欄位，選好後的畫面差異見下方完整欄位說明。建立後類型不可更改。
- 依所選類型填入欄位：Streamable HTTP 填端點 URL 與認證類型；Custom 在「自訂工具」表格逐一新增工具。
- 若是採認證的 Streamable HTTP，可點表單右上角的「測試連線」按鈕確認連線正常（見使用效果）。
- 按右上角的「儲存」按鈕完成建立（見步驟 1 圖右上角）。
完整欄位說明¶
主表單先填兩種接法共通的「名稱」與「類型」，選好類型後再填該類型專屬的欄位。
共同欄位（不分類型）¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 | 是 | 無 | MCP 伺服器的識別名稱。最多 64 個字，不可用 default 開頭。 |
| 類型 | 是 | 無（需選擇） | 接法，二選一：Streamable HTTP、Custom。兩者的適用情境與專屬欄位見下方兩節。建立後無法修改。 |
類型在建立後鎖定
編輯既有 MCP 伺服器時「類型」為唯讀。需要不同接法請另建一個 MCP 伺服器。
Streamable HTTP¶
連到既有的遠端 MCP 伺服器，使用分段傳輸回應逐步回傳串流內容。工具清單由遠端伺服器提供。
適合：
- 已經有一台符合 MCP 協定、跑在外部的伺服器要接進來。
- 工具邏輯維護在遠端，平台只負責連線與呼叫。
選「Streamable HTTP」後，表單會出現「端點 URL」與「認證類型」：
Streamable HTTP 類型的專屬欄位：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 端點 URL | 是 | 無 | 遠端 MCP 伺服器的網址，需為 http／https 開頭的有效網址。 |
| 認證類型 | 否 | 無（不需認證） | 指定平台連到這個遠端伺服器時如何通過驗證。可清除（清空代表不需認證）；可選「HTTP 連結器標頭」或「OAuth 登入」，見下方「認證類型怎麼選」。 |
認證類型怎麼選¶
| 選項 | 適合 | 選後要做什麼 |
|---|---|---|
| 留空 | 遠端伺服器不需要認證 | 直接連線，無額外欄位。 |
| HTTP 連結器標頭 | 用固定的驗證標頭（例如 API token）認證 | 出現連結器選擇器（只列出 HTTP 類型的連結器），選一個 HTTP 連結器 提供共用標頭。 |
| OAuth 登入 | 遠端伺服器以 OAuth 授權流程登入 | 先完成 OAuth 授權（見下方說明），授權後才能載入工具清單。 |
共用標頭集中放在連結器較安全
採「HTTP 連結器標頭」時，把驗證 token 等共用標頭集中放在 HTTP 連結器 裡，多個 MCP 伺服器、任務與工具就能共用同一把連結器，不必各自重填，也方便集中更換。
OAuth 授權與測試連線
採「OAuth 登入」時，會以 OAuth 授權流程登入遠端伺服器：在「OAuth 授權」對話框點「授權」開啟授權視窗完成登入。未完成授權前無法載入該伺服器的工具清單，也無法測試連線（會提示「請先完成授權，再進行連線測試。」）；若端點 URL 尚未填寫，測試授權時會提示「請先填入端點 URL 再測試授權。」。測試連線的詳細說明見使用效果。
Custom¶
不需要遠端伺服器，直接在平台內定義工具，例如呼叫 HTTPS API、既有 Lambda 函式或自訂 Python 程式碼。
適合：
- 沒有現成的 MCP 伺服器，想直接在平台裡把動作包成工具。
- 工具邏輯由平台既有資源（連結器、檢索器、Agent、Lambda…）組成。
選「Custom」後，表單會出現「自訂工具」表格，在這裡逐一新增工具：
Custom 類型的專屬欄位：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 自訂工具 | 是（至少一個有意義的工具） | 無 | 這個 MCP 伺服器提供的工具清單。點表格右下角的「+」圖示開啟「新增自訂工具」對話框逐一新增；每一列顯示工具的「名稱」與「類型」，可用鉛筆圖示編輯、垃圾桶圖示刪除、左側把手拖曳排序。 |
新增自訂工具：共通欄位¶
點「+」後開啟「新增自訂工具」對話框，每個工具都先填以下共通欄位，再依「類型」顯示專屬欄位：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 | 是 | 無 | 工具名稱，同一個 MCP 伺服器內不可重複。 |
| 描述 | 否 | 無 | 工具用途說明，讓 Agent 判斷何時該用這個工具。 |
| 類型 | 是 | 無（需選擇） | 工具種類，八選一（見下方各種類欄位表）。選定後下方會出現該種類的專屬欄位。 |
| 輸入結構 | 否 | 無 | 定義這個工具接受的輸入參數結構（以結構建構器設定）。僅 HTTP、Lambda、程式碼三種類型會出現此欄位。 |
八種工具類型怎麼選¶
| 工具類型 | 適合 |
|---|---|
| Agent | 把現有 Agent 當成工具呼叫。 |
| Athena | 對 Amazon Athena 資料庫下查詢。 |
| 程式碼 | 用一段自訂 Python 程式碼處理輸入並回傳結果。 |
| HTTP | 呼叫 HTTPS API 端點，支援常見 HTTP 方法。 |
| Lambda | 呼叫一個已經存在的 AWS Lambda 函式。 |
| MySQL | 透過 MySQL 連結器執行參數化 SQL 查詢。 |
| OpenSearch | 透過 OpenSearch 連結器呼叫 OpenSearch API。 |
| 檢索 | 把知識庫檢索功能當成工具，取回相關資訊。 |
以下逐一列出每種類型在「新增自訂工具」對話框中出現的專屬欄位。建立各工具所需的外部資源（連結器、檢索器、Agent、Lambda 函式等）請先在對應資源頁建好，再回到這裡選用。
Agent¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| Agent | 是 | 無 | 要被當成工具呼叫的 Agent，從清單挑選一個已建立的 Agent。 |
Athena¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 連結器 | 是 | 無 | 連到 AWS 的連結器（只列出 AWS 類型的連結器）。 |
| 資料庫 | 否 | 無 | 要查詢的 Athena 資料庫，可清除。 |
| 執行與輸出設定 | 是 | 無（需選擇） | 決定查詢結果怎麼輸出，二選一：「工作群組」（沿用 Athena 工作群組的預設輸出位置）或「輸出位置」（指定 S3 路徑存放結果）。選定後帶出對應欄位。 |
| 工作群組 | 條件 | 無 | 採「工作群組」時出現，指定要用的 Athena 工作群組。 |
| 輸出位置 | 條件 | 無 | 採「輸出位置」時出現，查詢結果輸出的 S3 位置，需以 s3:// 開頭。 |
| 目錄 | 否 | 無 | Athena 資料目錄。 |
| 唯讀 | 否 | 開啟 | 開啟時只允許查詢、不允許寫入。 |
程式碼¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 程式碼 | 是 | 預填範本 | 自訂 Python 程式碼，必須包含名為 handler 的函式，接收輸入資料並回傳結果。表單會預先帶入一段含 handler 的範本可直接改寫。 |
| 輸入結構 | 否 | 無 | 定義這個工具接受的輸入參數結構。 |
HTTP¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 方法 | 是 | 無 | HTTP 方法（GET、POST 等）。 |
| 連結器 | 否 | 無 | 可選用 API 連結器以共用端點與驗證設定；選了會自動帶入該連結器的端點到「網址」。 |
| 網址 | 是 | 無 | 要呼叫的 API 網址，需為 http／https 開頭的有效網址。 |
| 參數 | 否 | 無 | 查詢字串參數，可逐筆新增。 |
| 主體 | 否 | 無 | 請求主體內容。 |
| 輸入結構 | 否 | 無 | 定義這個工具接受的輸入參數結構。 |
| HTTP 標頭 | 否 | 無 | 附帶的 HTTP 標頭，收在「進階設定」摺疊區塊內。 |
Lambda¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| Lambda 函式指定方式 | 是 | 從 Lambda 函式資源選取 | 怎麼指定函式，二選一：「從 Lambda 函式資源選取」（選一個已登記的 Lambda 函式資源）或「輸入函式名稱或 ARN」。 |
| Lambda 函式 | 條件 | 無 | 採「從 Lambda 函式資源選取」時出現，選一個已建立的 Lambda 函式資源。 |
| Lambda 函式名稱 | 條件 | 無 | 採「輸入函式名稱或 ARN」時出現，直接填名稱或 ARN。 |
| 輸入結構 | 否 | 無 | 定義這個工具接受的輸入參數結構。 |
| 傳輸資料 | 否 | 無 | 傳給 Lambda 的輸入資料（JSON）。 |
MySQL¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 連結器 | 是 | 無 | MySQL 連結器（只列出 MySQL 類型的連結器）。 |
| SQL 查詢 | 是 | 無 | 要執行的 SQL 查詢，可帶參數。 |
| SQL 參數 | 否 | 無 | 對應查詢中的參數值（JSON）。 |
| 資料庫 | 否 | 無 | 指定要查詢的資料庫，可清除。 |
| 唯讀 | 否 | 開啟 | 開啟時只允許查詢、不允許寫入。 |
OpenSearch¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 連結器 | 是 | 無 | OpenSearch 連結器（只列出 OpenSearch 類型的連結器）。 |
| 方法 | 是 | 無 | 呼叫 OpenSearch API 使用的 HTTP 方法。 |
| 網址路徑 | 是 | 無 | OpenSearch API 的路徑。 |
| 主體 | 否 | 無 | 請求主體內容（JSON）。 |
| HTTP 標頭 | 否 | 無 | 附帶的 HTTP 標頭，收在「進階設定」摺疊區塊內。 |
| 參數 | 否 | 無 | 查詢字串參數，收在「進階設定」摺疊區塊內。 |
| 使用快取連線 | 否 | 開啟 | 開啟時重用既有連線以提升效能，收在「進階設定」內。 |
| 唯讀 | 否 | 開啟 | 開啟時阻擋 PUT／DELETE 與具破壞性的 POST 端點，收在「進階設定」內。 |
檢索¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 檢索器 | 是 | 無 | 一個或多個用來取回資料的檢索器（或知識庫）。 |
| 排序器 | 否 | 無 | 對檢索結果重新排序的排序器，可清除。 |
| 去除重複結果 | 否 | 開啟 | 開啟時移除重複的文件，收在「進階設定」摺疊區塊內。 |
| 文件數量上限 | 否 | 10 | 限制回傳的文件數量（最少 1），收在「進階設定」摺疊區塊內。 |
切換工具種類會清空已填內容
在同一個工具對話框中切換「類型」時，先前填的專屬欄位與「輸入結構」不會保留。請先確定要用哪一種類型再開始填。
MCP 伺服器詳細頁¶
建立完成後點進某個 MCP 伺服器，詳細頁上方有四個頁籤；下圖為一台採 OAuth 認證的 Streamable HTTP 伺服器「一般」頁籤的「詳細資料」卡片，可看到 ID、名稱、類型、端點 URL、認證類型、狀態與最後更新：
| 頁籤 | 內容 |
|---|---|
| 一般 | MCP 伺服器的基本資料：ID、名稱、類型，以及該類型的設定欄位（Streamable HTTP 的端點 URL／認證類型，或 Custom 的工具設定）、系統資訊、狀態與最後更新。 |
| 工具 | 這個 MCP 伺服器提供的工具清單（Streamable HTTP 為遠端載入、Custom 為自訂工具）。 |
| 依賴資源 | 這個 MCP 伺服器用到的其他資源（例如 HTTP 連結器、被當工具呼叫的 Agent、連結器等）。 |
| 被依賴資源 | 反過來，有哪些資源用到這個 MCP 伺服器（例如掛上它的 Agent 或 MCP 任務）。 |
「詳細資料」卡片右上角的圖示鈕：測試連線（）、編輯（）、複製（）、刪除（），以及收合卡片的箭頭。其中「測試連線」鈕只在採認證的 Streamable HTTP 上出現，見下方使用效果。
使用效果¶
MCP 伺服器不能單獨執行，它的價值在於「把一組工具接給 Agent 呼叫」。Streamable HTTP 可在建立後測試連線確認接得通；Custom 在平台內定義工具、沒有遠端可測，直接掛到 Agent 上使用即可。
測試連線（Streamable HTTP）¶
採認證（HTTP 連結器標頭或 OAuth 登入）的 Streamable HTTP 伺服器有兩個測試連線入口，做的事一樣（用目前設定試連一次），位置不同：
- 建立／編輯表單右上角的文字按鈕：字樣為「測試連線」（測試中顯示「測試中...」）。
- 詳細頁「詳細資料」卡片右上角的圖示鈕：圖示為 ，滑過會顯示「測試連線」（見詳細頁截圖）。
採「OAuth 登入」時，會先開啟「OAuth 授權」對話框完成授權，再進行連線測試。Custom 類型與「未設認證」的 Streamable HTTP 沒有可測試的連線目標，不會出現這顆按鈕。
點下按鈕後，平台會用目前設定去試連：
- 成功：畫面右下角跳出綠色提示「測試連線成功！」，代表這台伺服器接得通。
- 失敗：跳出紅色提示「測試連線失敗！請檢查設定並重試。」，請回頭檢查端點 URL、認證設定或遠端伺服器狀態。
OAuth 要先完成授權、端點要先填好
採 OAuth 時若尚未完成授權就測試，會提示「請先完成授權，再進行連線測試。」；端點 URL 尚未填寫時測試授權會提示「請先填入端點 URL 再測試授權。」。先把端點與授權都備妥，再測試連線。
掛到 Agent 後工具被呼叫¶
驗證接得通後，這個 MCP 伺服器就能在下游被選用，讓它提供的工具實際被呼叫：
- Agent 的 MCP 伺服器工具：把整台 MCP 伺服器掛到 Agent 上，Agent 對話時就能挑選並呼叫上面的工具。
- MCP 任務：在工作流程的任務設定裡選這台 MCP 伺服器與要呼叫的工具。
下一步¶
- MCP 伺服器工具：把 MCP 伺服器掛到 Agent 上。
- MCP 任務：在工作流程中呼叫 MCP 伺服器的工具。
- 連結器 (Connector)：用 HTTP 連結器共用驗證標頭，或建立 AWS／MySQL／OpenSearch 連結器供自訂工具使用。
- 檢索器 (Retriever)：供「檢索」類型自訂工具使用。