跳轉到
版本 v1.0.13

教學 03:將 Agent 發佈為 MCP 伺服器

本教學示範如何將平台上已建立的 Agent,透過 Custom MCP 伺服器對外提供服務,並以 Claude 作為外部用戶端,實際呼叫這個工具。

事前準備

開始本教學前,請先完成教學 01:建立 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:儲存並記下端點 URL

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

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


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

步驟 4:開啟 Claude 的 Connectors 設定

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

Claude 主頁——點擊 Customize

步驟 5:新增自訂 Connector

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

Connectors 頁面——新增自訂 Connector

步驟 6:連接 Connector

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

Connector 頁面——Connect 按鈕

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

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

LFE 平台登入視窗

步驟 8:確認工具權限

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

關於 Needs approval

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

Connector 頁面——Tool permissions

步驟 9:在 Claude 中提問

  1. 回到 Claude 主頁,在對話框中輸入問題,可直接複製以下範例問題:

    醫生排班需要遵守勞基法嗎
    
  2. Claude 偵測到相關工具後,會顯示權限確認提示:「Claude wants to use Labor law qa from labor_law_qa」

  3. 點擊「Always allow」授權使用。

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

步驟 10:查看回答

稍待片刻,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

帶著走:學會這個之後可以做什麼

你已經把平台上的 Agent 變成任何 MCP 用戶端都能呼叫的工具。除了 Claude,同樣的端點 URL 也能接到其他支援 MCP 的應用或自家系統,讓你在平台上維護的知識與邏輯被多處重複使用。這把平台從「使用者直接操作的介面」延伸成「可被外部服務整合的能力提供者」。

下一步

到目前為止都是用 Agent 來實現問答。最後一個教學換個角度,用固定的工作流程達成類似目標,並比較兩種做法的取捨。