MCP 伺服器¶
這頁能幫你做什麼¶
MCP 伺服器 (MCP Server) 幫你把一組「工具」接到平台，讓 Agent 可以呼叫這些工具去做事，例如查 API、跑資料庫查詢、執行程式碼或呼叫其他 Agent。MCP (Model Context Protocol) 是一種讓 AI 與外部工具溝通的協定。
平台支援兩種接法：連到外部既有的 MCP 伺服器（類型「外部」），或直接在平台內自訂工具（類型「自定義」）。建立時先填名稱、選類型，畫面會依類型顯示對應欄位。
開始前¶
前置需求
- 外部：需備妥遠端 MCP 伺服器的端點 URL，以及（若需要）認證方式。常見服務可直接從「常用服務」帶入設定，不必自己查端點 URL。
- 自定義：依工具種類可能需先建立其他資源，例如 MySQL／OpenSearch 連結器 (Connector)、知識庫 (Knowledge Base)、檢索器 (Retriever)、要被呼叫的 Agent 等。請參考對應資源頁。
兩種接法怎麼選
- 你要接的是外部或第三方公開的 MCP 伺服器（例如 GitHub、Notion、Context7）→ 選 外部，填好端點 URL 與認證即可。
- 你沒有現成的 MCP 伺服器，想直接在平台裡把幾個動作（呼叫 API、查資料庫、跑程式碼、呼叫 Agent…）包成工具 → 選 自定義，不必另外架伺服器。
操作步驟¶
-
從左側資源選單進入「MCP 伺服器」清單頁，點建立入口（空清單時是有文字的建立按鈕；清單已有項目時是右上角無文字的「+」圖示）開啟建立表單。
清單頁的「服務」欄
「服務」欄顯示這台伺服器連到哪個外部服務：端點 URL 命中常用服務時顯示該服務名稱與圖示（上圖為 Context7）；其他端點顯示網址的主機名稱；「自定義」類型沒有外部服務，顯示「—」。
-
在「名稱」欄輸入容易辨識的名稱（例如
docs-remote-mcp）。 -
在「類型」下拉選單選擇接法。不同類型會出現不同欄位，選好後的畫面差異見下方完整欄位說明。建立後類型不可更改。
下圖是「外部」類型整份填完的樣子（端點 URL 命中 GitHub、認證類型被鎖成「HTTP 連結器標頭」、設定驗證方式改選「建立新連結器」並填了 API 金鑰），也就是走完步驟 4 之後的畫面；剛選好「類型」時只會有「名稱」「標籤」「類型」「端點 URL」「認證類型」五欄，認證類型還是空的：
-
依所選類型填入欄位：「外部」填端點 URL（可用旁邊的「常用服務」一鍵帶入）與認證類型，這些欄位就是步驟 3 圖裡的樣子；「自定義」在「自訂工具」表格逐一新增工具，畫面見自定義。
- 若是採認證的「外部」伺服器，可點表單右上角的「測試連線」按鈕確認連線正常（見使用效果）。
- 按右上角的「儲存」按鈕完成建立（見步驟 3 圖右上角）。
完整欄位說明¶
主表單先填兩種接法共通的「名稱」與「類型」，選好類型後再填該類型專屬的欄位。
共同欄位（不分類型）¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 | 是 | 無 | MCP 伺服器的識別名稱。最多 64 個字，不可用 default 開頭。 |
| 標籤 | 否 | 無 | 分類用的小標，貼上後可在清單頁用「標籤」把同一群資源一次篩出來。填法與數量／長度限制見「標籤」欄位。 |
| 類型 | 是 | 無（需選擇） | 接法，二選一：外部、自定義。兩者的適用情境與專屬欄位見下方兩節。建立後無法修改。 |
類型在建立後鎖定
編輯既有 MCP 伺服器時「類型」為唯讀。需要不同接法請另建一個 MCP 伺服器。
外部¶
連到外部或第三方公開的 MCP 伺服器，使用分段傳輸回應逐步回傳串流內容。工具清單由該伺服器提供。
適合：
- 要接的是第三方服務（GitHub、Notion、Context7…）或公司內另一台已符合 MCP 協定的伺服器。
- 工具邏輯維護在對方那端，平台只負責連線與呼叫。
選「外部」後，表單會出現「端點 URL」與「認證類型」（下圖為從「常用服務」帶入 GitHub 後的樣子）：
外部類型的專屬欄位：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 端點 URL | 是 | 無 | 遠端 MCP 伺服器的網址，需為 http／https 開頭的有效網址。可手動輸入，或按旁邊的「常用服務」從清單帶入。 |
| 認證類型 | 否 | 無（不需認證） | 指定平台連到這台伺服器時如何通過驗證。留空代表不需認證；可選「HTTP 連結器標頭」或「OAuth 登入」，見下方認證類型怎麼選。 |
從「常用服務」帶入設定¶
不確定端點 URL 或該用哪種認證時，按「端點 URL」右側的「常用服務」按鈕，從清單挑一個服務即可一次帶入。
目前提供 15 個服務，依所需的驗證方式分成三類：
| 該服務的驗證方式 | 服務 |
|---|---|
| OAuth 登入 | Notion、Canva、monday.com、Linear、PayPal、Cloudflare、Tavily |
| API 金鑰（存成 HTTP 連結器標頭） | GitHub、Gmail、Google Drive、Google Calendar、Google Maps |
| 不需認證 | DeepWiki、Context7、AWS Knowledge |
挑一個服務後，平台會：
- 把該服務的端點 URL 填進欄位，並在欄位左側顯示該服務的圖示，代表目前設定命中這個服務。
- 依該服務的驗證方式自動選好「認證類型」（OAuth 服務選「OAuth 登入」、API 金鑰服務選「HTTP 連結器標頭」、免認證服務保持留空）。
想確認上表的分類，挑一個服務後回頭看「認證類型」欄自動變成什麼即可：例如選 Notion 會變成「OAuth 登入」、選 GitHub 會變成「HTTP 連結器標頭」、選 Context7 則保持留空。
服務清單很長時用搜尋
對話框上方的搜尋框可用服務名稱或用途說明過濾，例如輸入「文件」會留下說明含「文件」的服務。找不到你要的服務時，直接手動輸入端點 URL 即可，兩種做法建出來的伺服器沒有差別。
手動輸入也會被認出來
命中與否是比對端點 URL（忽略大小寫與結尾的斜線），不是看你有沒有按過「常用服務」。手動貼上同一個網址，同樣會出現服務圖示，清單頁的「服務」欄也同樣顯示該服務名稱。
認證類型怎麼選¶
| 選項 | 適合 | 選後要做什麼 |
|---|---|---|
| 留空 | 遠端伺服器不需要認證 | 直接連線，無額外欄位。 |
| HTTP 連結器標頭 | 用固定的驗證標頭（例如 API token）認證 | 出現「設定驗證方式」，選擇沿用既有的 HTTP 連結器 或當場建立一把新的，見設定驗證方式。 |
| OAuth 登入 | 遠端伺服器以 OAuth 授權流程登入 | 先完成 OAuth 授權（見下方說明），授權後才能載入工具清單。 |
命中需要認證的常用服務時，認證類型會被鎖定
端點 URL 命中需要 OAuth 或 API 金鑰的常用服務時，「認證類型」只留該服務支援的那一種、其餘選項變灰，欄位下方會提示「僅能使用所選預設項目支援的驗證方式。」，也不能清空。這是為了避免組出該服務接受不了的組合（例如對只吃 OAuth 的端點設定標頭認證）。要改成其他認證方式，得先把端點 URL 換成非預設的網址。 命中免認證的服務（DeepWiki、Context7、AWS Knowledge）時不鎖定：認證類型保持留空、兩個選項都可選，若那台伺服器其實需要認證，你仍可自行改設。
OAuth 授權與測試連線
採「OAuth 登入」時，會以 OAuth 授權流程登入遠端伺服器：在「OAuth 授權」對話框點「授權」開啟授權視窗完成登入。未完成授權前無法載入該伺服器的工具清單，也無法測試連線（會提示「請先完成授權，再進行連線測試。」）；端點 URL 還沒填的時候，右上角的「測試連線」鈕是灰的、按不下去（不會有提示告訴你原因，補上端點就會亮起來）。測試連線的詳細說明見使用效果。
設定驗證方式¶
「認證類型」選「HTTP 連結器標頭」後，會多出「設定驗證方式」下拉，決定驗證標頭從哪裡來。不論端點 URL 有沒有命中常用服務，這個下拉一開始都是「使用既有連結器」，要當場建新的請自己改選（上方步驟 3 的圖就是改選成「建立新連結器」的樣子）：
| 選項 | 適合 | 選後出現的欄位 |
|---|---|---|
| 使用既有連結器（預設） | 已經有一把存好驗證標頭的 HTTP 連結器 | 「連結器」挑選器（只列出 HTTP 類型的連結器），必填。 |
| 建立新連結器 | 手上只有一組 token／金鑰，還沒建連結器 | 命中 API 金鑰類常用服務時是單一的「API 金鑰」欄；其他情況是「HTTP 標頭」表格，可逐筆填「鍵」「值」並勾「敏感資訊」。 |
「建立新連結器」是在儲存時才真的建立
選「建立新連結器」時，欄位下方會提示「儲存時將自動建立新的 HTTP 連結器並套用至此 MCP 伺服器。」——填好的金鑰／標頭會等按下「儲存」才被寫成一把新的 HTTP 連結器並掛到這台伺服器上。表單放棄不儲存就不會留下任何連結器。建好之後可在連結器資源頁看到它，也能被其他 MCP 伺服器或工具共用。
共用標頭集中放在連結器較安全
多台 MCP 伺服器要用同一組驗證標頭時，先在 HTTP 連結器 建好一把，再用「使用既有連結器」引用同一把，之後換 token 只要改一個地方。
自定義¶
不需要外部伺服器，直接在平台內定義工具，例如呼叫 HTTPS API、既有 Lambda 函式或自訂 Python 程式碼。
適合：
- 沒有現成的 MCP 伺服器，想直接在平台裡把動作包成工具。
- 工具邏輯由平台既有資源（連結器、知識庫、檢索器、Agent、Lambda…）組成。
- 想把平台上的能力反過來提供給外部用戶端呼叫（儲存後平台會給這台伺服器一個端點 URL，見詳細頁）。
選「自定義」後，表單會出現「自訂工具」表格，在這裡逐一新增工具：
自定義類型的專屬欄位：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 自訂工具 | 是（至少一個有意義的工具） | 無 | 這個 MCP 伺服器提供的工具清單。點表格中的「+」圖示開啟「新增自訂工具」對話框逐一新增；每一列顯示工具的「名稱」與「類型」，可用鉛筆圖示編輯、垃圾桶圖示刪除、左側把手拖曳排序。 |
新增自訂工具：共通欄位¶
點「+」後開啟「新增自訂工具」對話框，每個工具都先填以下共通欄位，再依「類型」顯示專屬欄位：
各類型的資源欄位都是挑選欄位：選取請點該列「名稱」以外的地方
下面八種類型的「Agent」「連結器」「Lambda 函式」「知識庫」等欄位都是唯讀的資源挑選欄位：點欄位（或右側的 ）會開啟挑選對話框。選取時請點該列「名稱」以外的任一格（或列前面的選鈕），再按對話框右上角的「儲存」——點「名稱」會在新分頁開啟那個資源的詳細頁，不會選取它（見資源挑選欄位）。
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 | 是 | 無 | 工具名稱，同一個 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 函式等）請先在對應資源頁建好，再回到這裡選用。
八種類型共用同一個對話框版面（上方固定是「名稱」「描述」「類型」，選好類型後專屬欄位接在下面，部分欄位收在「進階設定」摺疊區塊內），所以只放上方 HTTP 一張圖示意；換成其他類型時，畫面上出現的就是各節表格列出的那些欄位，順序也與表格一致。
Agent¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| Agent | 是 | 無 | 要被當成工具呼叫的 Agent，從清單挑選一個已建立的 Agent。 |
Athena¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 連結器 | 是 | 無 | 連到 AWS 的連結器（只列出 AWS 類型的連結器）。 |
| 資料庫 | 否 | 無 | 要查詢的 Athena 資料庫，可清除。 |
| 執行與輸出設定 | 是 | 無（需選擇） | 決定查詢結果怎麼輸出，二選一：「工作群組」（沿用 Athena 工作群組的預設輸出位置）或「輸出位置」（指定 S3 路徑存放結果）。選定後帶出對應欄位。 |
| 工作群組 | 條件 | 無 | 採「工作群組」時出現，指定要用的 Athena 工作群組。 |
| 輸出位置 | 條件 | 無 | 採「輸出位置」時出現，查詢結果輸出的 S3 位置，需以 s3:// 開頭。 |
| 目錄 | 否 | 無 | Athena 資料目錄。 |
| 唯讀 | 否 | 開啟 | 開啟時只允許查詢、不允許寫入。 |
程式碼¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 程式碼 | 是 | 預填範本 | 自訂 Python 程式碼，必須包含名為 handler 的函式，接收輸入資料並回傳結果。表單會預先帶入一段含 handler 的範本可直接改寫。 |
| 輸入結構 | 否 | 無 | 定義這個工具接受的輸入參數結構。 |
HTTP¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 方法 | 是 | 無 | HTTP 方法（GET、POST 等）。 |
| 連結器 | 否 | 無 | 可選用 HTTP 連結器以套用共用的驗證標頭；端點網址一律在「網址」欄填寫。 |
| 網址 | 是 | 無 | 要呼叫的 API 網址，需為 http／https 開頭的有效網址。 |
| 參數 | 否 | 無 | 查詢字串參數，可逐筆新增。 |
| 主體 | 否 | 無 | 請求主體，畫面上是一張「鍵」「值」表格（不是貼一整段 JSON），要送的每個欄位逐筆填一列。 |
| 輸入結構 | 否 | 無 | 定義這個工具接受的輸入參數結構。 |
| 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 端點，收在「進階設定」內。 |
檢索¶
欄位與 Agent 的檢索工具相同——先指定要查的知識庫，再指定用哪些檢索器去查：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 知識庫 | 是 | 無 | 要查詢的知識庫，挑選一個。 |
| 檢索器 | 是 | 無 | 用來取回資料的檢索器，可挑選多個。 |
| 資料欄位 | 否 | 全部欄位 | 只搜尋知識庫的特定索引欄位；留空則使用全部欄位。僅適用於有欄位結構的資料（CSV／TSV／JSON／JSONL）。 |
| 排序器 | 否 | 無 | 對檢索結果重新排序的排序器，可清除。 |
切換工具種類會清空已填內容
在同一個工具對話框中切換「類型」時，先前填的專屬欄位與「輸入結構」不會保留。請先確定要用哪一種類型再開始填。
MCP 伺服器詳細頁¶
建立完成後點進某個 MCP 伺服器，詳細頁上方有四個頁籤；下圖為一台不採認證的外部伺服器「一般」頁籤的「詳細資料」卡片，可看到 ID、名稱、標籤、類型、端點 URL、狀態、建立者、更新者與最後更新：
| 頁籤 | 內容 |
|---|---|
| 一般 | MCP 伺服器的基本資料：ID、名稱、標籤、類型、端點 URL，以及該類型的設定欄位（外部的認證類型與連結器，或自定義的工具清單）、系統資訊、狀態、建立者、更新者與最後更新。 |
| 工具 | 這個 MCP 伺服器提供的工具清單（外部為向遠端載入、自定義為你設定的自訂工具）。 |
| 依賴資源 | 這個 MCP 伺服器用到的其他資源（例如 HTTP 連結器、被當工具呼叫的 Agent、知識庫等）。 |
| 被依賴資源 | 反過來，有哪些資源用到這個 MCP 伺服器（例如掛上它的 Agent 或 MCP 任務）。 |
「一般」頁籤依設定多顯示幾列：
- 認證類型：只在外部伺服器設了認證時出現（上圖那台沒設認證，所以沒有這一列）。
- 連結器：只在認證類型為「HTTP 連結器標頭」時出現，顯示那把連結器的名稱（不是 ID），點下去會跳到該連結器的資源頁，方便直接去改標頭。
- 端點 URL：外部伺服器顯示你填的遠端網址（命中常用服務時前面帶服務圖示）；自定義伺服器顯示平台給這台伺服器的網址，外部用戶端要用它來連進來。
「詳細資料」卡片右上角的圖示鈕：測試連線（）、編輯（）、複製（）、刪除（），以及收合卡片的箭頭。其中「測試連線」鈕只在採認證的外部伺服器上出現，見下方使用效果。
使用效果¶
MCP 伺服器不能單獨執行，它的價值在於「把一組工具接給 Agent 呼叫」。外部伺服器可在建立後測試連線確認接得通；自定義伺服器在平台內定義工具、沒有遠端可測，直接掛到 Agent 上使用即可。
測試連線（外部）¶
採認證（HTTP 連結器標頭或 OAuth 登入）的外部伺服器有兩個測試連線入口，做的事一樣（用目前設定試連一次），位置不同：
- 建立／編輯表單右上角的文字按鈕：字樣為「測試連線」（測試中顯示「測試中...」）。
- 詳細頁「詳細資料」卡片右上角的圖示鈕：圖示為 ，滑過會顯示「測試連線」（見詳細頁截圖）。
採「OAuth 登入」時，會先開啟「OAuth 授權」對話框完成授權，再進行連線測試。自定義類型與「未設認證」的外部伺服器沒有可測試的連線目標，不會出現這顆按鈕。
點下按鈕後，平台會用目前設定去試連：
- 成功：畫面右下角跳出綠色提示「測試連線成功！」，代表這台伺服器接得通。
- 失敗：跳出紅色提示「測試連線失敗！請檢查設定並重試。」，請回頭檢查端點 URL、認證設定或遠端伺服器狀態。
OAuth 要先完成授權、端點要先填好
採 OAuth 時若尚未完成授權就測試，會提示「請先完成授權，再進行連線測試。」；端點 URL 還沒填時「測試連線」鈕是灰的、按不下去；認證設定沒填完（例如選了「使用既有連結器」卻還沒挑連結器）也一樣是灰的。先把端點與認證都備妥，這顆鈕才會亮。
掛到 Agent 後工具被呼叫¶
驗證接得通後，這個 MCP 伺服器就能在下游被選用，讓它提供的工具實際被呼叫：
- Agent 的 MCP 伺服器工具：把整台 MCP 伺服器掛到 Agent 上，Agent 對話時就能挑選並呼叫上面的工具。
- MCP 任務：在工作流程的任務設定裡選這台 MCP 伺服器與要呼叫的工具。
下一步¶
- MCP 伺服器工具：把 MCP 伺服器掛到 Agent 上。
- MCP 任務：在工作流程中呼叫 MCP 伺服器的工具。
- 連結器 (Connector)：用 HTTP 連結器共用驗證標頭，或建立 AWS／MySQL／OpenSearch 連結器供自訂工具使用。
- 知識庫 (Knowledge Base)、檢索器 (Retriever)：供「檢索」類型自訂工具使用。