教學 04:將 Agent 發佈為 MCP 伺服器¶
本教學示範如何將平台上已建立的 Agent,透過 Custom MCP 伺服器對外提供服務, 並以 Claude 作為外部用戶端,實際呼叫這個工具。
事前準備
開始本教學前,請先完成教學 02:建立 QA Agent。 您需要在該教學中建立的 tutorial_labor_qa_agent。
您將完成的內容¶
- 在平台上建立一個 Custom 類型的 MCP 伺服器,將 Agent 包裝為可呼叫的工具
- 將 MCP 伺服器的端點 URL 加入 Claude,讓 Claude 能夠使用此工具回答問題
第一部分:建立 Custom MCP 伺服器¶
步驟 1:建立 MCP 伺服器¶
- 從側邊欄進入「資源」,點擊「MCP 伺服器」,選擇「建立 MCP 伺服器」。
- 填寫建立表單:
- 名稱:輸入名稱(例如
tutorial_custom_mcp) - 類型:選擇「Custom」
- 名稱:輸入名稱(例如
- 暫不儲存,繼續下一步新增工具。

步驟 2:新增 Agent 工具¶
- 點擊「新增自訂工具」按鈕。
- 填寫工具設定:
- 名稱:
labor_law_qa(此名稱將出現在外部用戶端的工具清單中) - 描述:說明此工具的用途與適用情境,供呼叫方(如 Claude)判斷何時使用。 例如:
與勞基法相關的問答機器人,在用戶詢問與勞動議題相關的問題時使用。 - 類型:選擇「Agent」
- Agent:選擇
tutorial_labor_qa_agent
- 名稱:
- 點擊「儲存」按鈕。

步驟 3:設定工具的輸入結構¶
- 在工具的「輸入結構」區塊,點擊「+」開啟新增屬性對話框。
- 填寫屬性設定:
- 類型:
字串 - 名稱:
message - 必填:開啟
- 類型:
- 點擊「儲存」按鈕。

步驟 4:儲存並記下端點 URL¶
- 點擊右上角「儲存」按鈕以建立 MCP 伺服器。
- 儲存後系統跳轉至該 MCP 伺服器的詳細頁面。
- 在「端點 URL」欄位,複製完整的 URL,後續步驟需要用到。

第二部分:在 Claude 連接 MCP 伺服器¶
步驟 5:開啟 Claude 的 Connectors 設定¶
- 開啟 Claude.ai。
- 點擊左側工具列底部的「Customize」圖示(briefcase)。

步驟 6:新增自訂 Connector¶
- 在「Customize」面板中,選擇「Connectors」。
- 點擊右上角的「+」按鈕,選擇「Add custom connector」。
- 在欄位中貼上步驟 4 複製的端點 URL,完成新增。

步驟 7:連接 Connector¶
- 在 Connectors 清單中,選擇剛才新增的 connector(
labor_law_qa)。 - 點擊「Connect」按鈕。

步驟 8:使用平台帳號登入¶
系統會彈出登入視窗,輸入您在 Headquarter.ai 平台的帳號與密碼,點擊「登入」按鈕。

步驟 9:確認工具權限¶
登入成功後回到 Connector 頁面,確認「Tool permissions」區塊顯示工具已列出。
關於 Needs approval
預設權限為「Needs approval」,代表 Claude 每次使用此工具前都會先詢問您。 若要跳過確認,可將權限改為「Always allow」。

步驟 10:在 Claude 中提問¶
- 回到 Claude 主頁,在對話框中輸入問題(例如:「醫生排班需要遵守勞基法嗎」)。
- Claude 偵測到相關工具後,會顯示權限確認提示: 「Claude wants to use Labor law qa from labor_law_qa」
- 點擊「Always allow」授權使用。

步驟 11:查看回答¶
稍待片刻,Claude 的回答頂部會顯示「Loaded tools, used labor_law_qa integration」, 代表工具已成功被呼叫。回答內容直接來自您在平台上的 Agent 所查詢的知識庫。

總結¶
| 步驟 | 在哪裡操作 | 做什麼 |
|---|---|---|
| 建立 Custom MCP 伺服器 | Headquarter.ai 平台 | 將 Agent 包裝為對外可呼叫的工具 |
| 新增自訂 Connector | Claude.ai | 以端點 URL 連接平台上的 MCP 伺服器 |
| 登入並授權 | Claude.ai | 以平台帳號驗證身份,設定工具使用權限 |
| 提問並查看結果 | Claude.ai | Claude 呼叫工具,回答來自平台 Agent |