跳轉到

教學 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 伺服器

  1. 從側邊欄進入「資源」,點擊「MCP 伺服器」,選擇「建立 MCP 伺服器」。
  2. 填寫建立表單:
    • 名稱:輸入名稱(例如 tutorial_custom_mcp
    • 類型:選擇「Custom」
  3. 暫不儲存,繼續下一步新增工具。

建立 MCP 伺服器表單——類型選擇 Custom

步驟 2:新增 Agent 工具

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

新增自訂工具表單——名稱、描述、類型與 Agent

步驟 3:設定工具的輸入結構

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

新增屬性對話框——message 字串欄位

步驟 4:儲存並記下端點 URL

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

MCP 伺服器詳細頁面——端點 URL


第二部分:在 Claude 連接 MCP 伺服器

步驟 5:開啟 Claude 的 Connectors 設定

  1. 開啟 Claude.ai
  2. 點擊左側工具列底部的「Customize」圖示(briefcase)。

Claude 主頁——點擊 Customize

步驟 6:新增自訂 Connector

  1. 在「Customize」面板中,選擇「Connectors」。
  2. 點擊右上角的「+」按鈕,選擇「Add custom connector」。
  3. 在欄位中貼上步驟 4 複製的端點 URL,完成新增。

Connectors 頁面——新增自訂 Connector

步驟 7:連接 Connector

  1. 在 Connectors 清單中,選擇剛才新增的 connector(labor_law_qa)。
  2. 點擊「Connect」按鈕。

Connector 頁面——Connect 按鈕

步驟 8:使用平台帳號登入

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

LFE 平台登入視窗

步驟 9:確認工具權限

登入成功後回到 Connector 頁面,確認「Tool permissions」區塊顯示工具已列出。

關於 Needs approval

預設權限為「Needs approval」,代表 Claude 每次使用此工具前都會先詢問您。 若要跳過確認,可將權限改為「Always allow」。

Connector 頁面——Tool permissions

步驟 10:在 Claude 中提問

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

Claude 聊天——工具使用權限提示

步驟 11:查看回答

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

Claude 回答——工具已呼叫,回答來自 LFE Agent


總結

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