Claude 連接器:免寫程式,建立自己的連接器

Piotr Grudzień
發布日期 閱讀時間約 17 分鐘
Claude 中的問題連接到 Fernhill Help 及其退貨政策,預設採用私有訪問

Claude 連接器讓 Claude 使用對話以外的工具和資訊。 本教學將帶你建立自訂連接器,讓它根據自己的說明中心回答問題,無需編寫程式碼或自行執行 MCP 伺服器。

範例使用虛構的戶外用品零售商 Fernhill Outdoor。同事問 Claude:45 天前購買、從未穿過的夾克能退貨嗎?Claude 可以向你的 Quickchat AI Agent Fernhill Help 查詢政策。一個實用的回答需要保留三個細節:60 天期限、原始吊牌要求,以及從收到退貨開始計算的退款時限。

概念圖:Claude 中的夾克退貨問題、Fernhill Help 知識庫,以及回答應保留的三個政策條件 你將建立的效果。此圖展示預期的政策回答;下文的測試會驗證 Agent 和 Claude 是否確實保留這些內容。

你還會詢問說明中心沒有說明的內容:是否配送到瑞士。連接 Fernhill Help 後,Claude 的實際回答如下:

Claude 使用 Ask Fernhill Help,並說明說明中心未確認是否配送到瑞士 連接器的實際使用效果。Claude 區分“沒有記錄的目的地”和“禁止配送”,並引導讀者聯繫 Fernhill 支援。

完成後,你將擁有一個私有連接器,以及一套可重複比較你向 Claude 提了什麼問題、Claude 向 Agent 提了什麼問題,以及最終回傳了什麼的方法。這個比較很重要:我們的退貨測試還發現,Claude 在轉述 Agent 回答時新增了一個條件。

下載 Fernhill 連接器套件,取得本次使用的完整知識內容、Main Prompt、MCP 描述、測試問題、評估標準、記錄結果和空白證據表。這些是可以編輯的參考檔案,並非一鍵匯入包。

螢幕截圖、介面和可複製的示範材料均為英文,便於你重現文中記錄的執行過程。

Claude 連接器是什麼?你需要哪一種?

Claude 自訂連接器是透過 URL 新增的遠端 MCP 伺服器連接。MCP(Model Context Protocol,模型上下文協議)讓 Claude 發現伺服器提供的工具並呼叫它們。在這裡,Quickchat AI 託管伺服器,並提供你的 Agent 的問答工具。

Claude Connectors Directory 列出了可以直接連接的服務。自訂連接器使用你提供的伺服器 URL。新增連接器不會將它提交到 Directory,也不會讓它出現在 Suggested Connector 中。

本次建立涉及兩種用途不同的連接:

你的目標使用的連接提供的能力
根據 Fernhill 說明中心提問使用 Fernhill Help Agent URL 的自訂連接器一個向該 Agent 提問的工具:ask_fernhill
在 Claude 中建立 Agent、編輯知識或檢視對話Claude Directory 中的 Quickchat AI 連接器受你的 Quickchat AI 權限約束的帳戶管理工具

區分向 Fernhill Help 提問的自訂連接器與管理帳戶的 Quickchat AI Directory 連接器的示意圖 先建立上方的連接。本指南後面會介紹可選的帳戶管理快捷方式。

Anthropic Messages API 中的 MCP connector 是面向開發者的獨立功能。本教學不需要 API 金鑰或 API 整合。關於底層協議,請參閱 MCP 詳解。

建立 Claude 自訂連接器需要什麼?

你需要 Claude 帳戶,以及一個你有權設定的 Quickchat AI Agent。首次建立只使用一個 Agent,並保持私有存取。

  1. 建立 Quickchat AI 帳戶,完成所需的電子郵件驗證,然後按下文手動設定。當前 Free 方案包含 MCP。生成回答和執行 Simulation 會消耗 AI credits;請在價格頁面檢視額度和商業使用條款。
  2. 在網頁或桌面端登入 Claude。Claude Free 允許一個自訂連接器;Pro、Max、Team 和 Enterprise 也支援自訂連接器。如果 Free 的名額已被佔用,繼續前先決定是否替換現有連接器。Team 或 Enterprise 使用者請參閱工作區設定方式。
  3. 首次執行使用下文的虛構材料。不需要客戶記錄、訂單系統或退款 API。保持 Actions 和轉交功能關閉,讓 Agent 只負責解釋政策。

Claude 的自訂連接器說明介紹了方案與角色要求。以下步驟展示了我們實際連接時的設定介面。

教學順序是建立 Agent、測試回答、啟用 MCP,然後連接並比較兩端的對話。

第 1 步:如何建立知識 Agent?

建立 Fernhill Help,新增一篇說明中心文章,並用 Main Prompt 指明如何處理缺失的資訊。

  1. 新帳戶選擇 Set up manually。已有帳戶先選擇 Add new AI Agent。
  2. 在 Identity 頁面的 Name your AI Agent 中輸入 Fernhill Help。將以下內容貼上到 Describe what you want your agent to do,然後選擇 Next。這將成為 Agent 的 Main Prompt。
You answer questions about Fernhill Outdoor from this Agent's Knowledge Base. Give a concise, factual answer. When the Knowledge Base does not contain the answer, say that you cannot confirm it and suggest contacting Fernhill support. Do not invent shipping destinations, prices, order details or refund outcomes. The listed shipping regions do not establish whether other destinations are served. For any destination not explicitly covered by the Knowledge Base, say you cannot confirm shipping there and suggest contacting Fernhill support; do not infer a shipping ban.
  1. 在 Knowledge Base 中將網站和文檔輸入留空,然後選擇 Next。在 External apps 和 Deployment 中不勾選任何選項,分別選擇 Next。選擇方案,或選擇 Skip for now 以 Free 方案完成。關閉可選的方案優惠視窗,進入 AI Preview。
  2. 打開 Knowledge Base > Add Article。將自訂文章命名為 Fernhill Outdoor help center,並選擇 Create article。
  3. 在 Edit Article 中,將以下完整來源內容貼上到 Content,然後選擇 Save:
Fernhill Outdoor help center

This is fictional training data. It contains no real customer information.

Shipping: orders ship within two working days to addresses in the European Union and the United Kingdom. Standard delivery takes three to five working days; express delivery takes one to two working days and costs 12 EUR.
Returns: unused items can be returned within 60 days with the original tags. Refunds are issued to the original payment method within ten working days of receipt.
Sizing: jackets follow the European size chart; when between sizes, choose the larger size for layering.
Warranty: Fernhill repairs manufacturing defects free of charge for two years. Normal wear, UV damage and improper washing are not covered.

Quickchat AI 的 Edit Article 面板,Content 中顯示虛構的 Fernhill Outdoor 說明中心文字 將完整來源貼上到 Content。測試中的所有政策事實都來自這篇文章。

  1. 等待文章顯示 Ready。知識更新會自動處理,此設定不需要單獨的發佈步驟。

Quickchat AI Knowledge Base 中 Fernhill Outdoor help center 條目顯示 Ready 狀態 顯示 Ready 後再測試。這是本機示範中實際完成索引的文章。

  1. 回傳 Identity 並檢查 Main Prompt。若與上面的文字不一致,使用 Edit 修改。

Quickchat AI Main Prompt 編輯器顯示 Fernhill 指令,以及禁止推斷配送禁令的明確規則 最終 Main Prompt 包含下文字地測試中完善的配送不確定性指令。

  1. 在 Actions & MCPs 中,讓 Custom Actions 保持為空,並關閉 Human Handoff 和 Smart Data Gathering。

知識內容提供事實,Main Prompt 規定回答方式。60 天退貨期限應寫在文章中,與其他政策一起維護。提示詞中的“保持準確”無法補上未記載的配送目的地。

第 2 步:連接 Claude 前,如何測試 Agent?

先單獨測試 Agent,之後才能區分知識問題、連接器問題和轉述問題。

Quickchat AI 側邊欄選中 Testing,並打開 Fernhill policy checks Testing 位於 Conversations 導航組中。打開資料集即可檢視訊息和執行記錄。

  1. 打開 Testing 並選擇 Create Dataset。命名為 Fernhill policy checks。
  2. 選擇 Paste messages,貼上以下完整文字。--- 分隔符會讓每個問題成為獨立的單輪測試:
Does Fernhill cover UV damage under warranty?
---
I bought a jacket 45 days ago and never wore it. Can I still return it, and how long does the refund take?
---
Does Fernhill ship to Switzerland?
  1. 選擇 Create。在資料集中展開 Evaluation criteria,貼上套件中的 evaluation-criteria.txt,然後選擇 Save。它會檢查政策條件、未記載的目的地,以及是否錯誤聲稱已退款或轉交。
  2. 選擇 Run,再選擇 Start Run。等待完成後打開每個結果。即使評估器打出高分,也要將實際回答與來源對照閱讀。

Quickchat AI 中的 Fernhill policy checks 資料集,顯示三個獨立的測試訊息 每個問題都是獨立案例。可複製文字中的分隔線可防止它們被合併成一個問題。 Quickchat AI Testing 的 Complete policy reference 結果,三個案例均已完成,AI 得分為 5.0/5 這是使用修訂版 Main Prompt 和完整參考標準的最終本機執行。除了分數,還要閱讀每條回答。

測試合格回答必須保留需要調查的結果
紫外線損壞紫外線損壞不在保修範圍內將所有損壞都視為保修涵蓋的製造缺陷
45 天前購買的夾克60 天內;未使用;需要原始吊牌;收到退貨後十個工作日內按原付款方式退款無條件回答“可以”、從今天開始計算退款時間,或聲稱退貨申請已經提交
瑞士來源未確認此目的地;聯繫 Fernhill 支援編造配送時間或費用、明確說可以,或明確斷言禁止配送

Quickchat AI 對話中,Fernhill Help 說明紫外線損壞不在保修範圍內 本機保修測試是直接查找事實。下一個案例測試另一種能力:來源不完整時保留不確定性。

瑞士案例刻意比“不要產生幻覺”更具體。來源提到歐盟和英國,但沒有說它們是僅有的目的地。正確行為是保留這種不確定性。

首次本機測試錯在哪裡?

首次本機執行正確回答了保修和退貨問題,但在瑞士問題上推斷出了來源沒有說明的規則:

瑞士未被列出,因此根據現有資訊,他們不配送到那裡。

Quickchat AI 對話中,Fernhill Help 因瑞士未被列出而錯誤斷定不配送到瑞士 修改提示詞前:一次真實的本機 Simulation 根據不完整的名單推斷出了配送禁令。

原始 Main Prompt 已要求 Agent 不要編造配送目的地。但這條通用規則並未阻止它把兩個已列出的地區當作完整名單。我們保持 Knowledge Base 不變,並在 Main Prompt 中新增了以下指令:

The listed shipping regions do not establish whether other destinations are served. For any destination not explicitly covered by the Knowledge Base, say you cannot confirm shipping there and suggest contacting Fernhill support; do not infer a shipping ban.

第 1 步和下載檔案中的完整 Main Prompt 已包含這段補充。修改提示詞時保持測試問題不變,才能比較實際影響。

下一次本機 Testing 執行的三個回答都與來源一致。瑞士問題的回答說明無法確認是否配送到那裡,並建議聯繫 Fernhill 支援。

Quickchat AI 對話中,Fernhill Help 表示無法確認是否配送到瑞士,並建議聯繫支援 修改提示詞後:最終本機 Simulation 將缺失事實保留為不確定性。這是 Agent 測試,不是 Claude 對話記錄。

儘管回答符合說明中心,該次執行的評估得分仍為 4.7/5。評估器因文章中存在、但評估標準未包含的保修細節而扣分。我們將完整參考事實加入標準,保持預期檢查項不變。可下載的標準已包含此修正。分數有助於找到需要檢查的回答;回答是否正確,最終取決於來源和實際回覆。

Quickchat AI 評估器提示,由於標準缺少參考事實,錯誤地將已有文檔記載的保修細節判為編造 先前評估器的解釋。兩年期限、製造缺陷和洗滌損壞排除條款原本就在來源中,評估標準也需要包含這些事實。

最終本機執行完成三個案例,評估得分為 5.0/5,人工閱讀也確認回答仍與來源一致。這只是在此設定下觀察到的三個案例,不保證每個問題或 Claude 後續的轉述都正確。

第 3 步:如何將 Agent 變成連接器?

啟用 Agent 託管的 MCP 伺服器,為工具編寫準確的描述,並保持登入要求開啟。

  1. 打開 External Apps,選擇 MCP,並開啟 Enable MCP。
  2. 在面板的 Settings 中,保持 Require sign-in (private) 開啟。這個開關控制存取權限,與寫給 Claude 的描述相互獨立。

Quickchat AI MCP 設定中,Enable MCP 和 Require sign-in private 均已開啟 首次建立時保持兩個開關開啟。私有設定獨立於工具描述控制存取。

  1. 選擇 Configure MCP,設定以下欄位:
欄位值
NameFernhill Help
Commandask_fernhill
Description下方完整文字
Answers questions about Fernhill Outdoor shipping, returns, sizing and warranty from its help center. Use this tool for Fernhill policy questions. If a fact is missing, it says it cannot confirm it and suggests contacting Fernhill support. It cannot look up orders, submit returns or issue refunds.

Configure MCP 對話框顯示 Fernhill Help、政策問答描述和 ask_fernhill 命令 這些是 Claude 實際發現的工具資訊,只描述此 Agent 已具備的能力。

描述為 Claude 提供選擇該工具的理由,並界定範圍。“回答 Fernhill 政策問題”比“有幫助的助手”更有用。明確限制也能避免暗示尚未建立的能力:此 Agent 沒有訂單查詢、退貨提交、退款或轉交 Action。

  1. 選擇 Done,再選擇 Connect MCP。複製你自己 Agent 的 URL,格式如下:
https://app.quickchat.ai/mcp/YOUR_AGENT_ID

Connect MCP 對話框以 app.quickchat.ai 託管 URL 格式顯示本機 Fernhill 示範 URL,以及 Copy 按鈕 從此對話框複製自己的 URL。圖中的識別碼屬於本機示範,並不是可安裝的託管連接器。

使用對話框中的準確 URL。上方 YOUR_AGENT_ID 是佔位符。MCP 渠道參考說明了私有/公開控制和託管 URL。

第 4 步:如何向 Claude 新增自訂連接器?

在 Claude 中新增託管的 Agent URL,然後使用有權存取 Fernhill Help 的 Quickchat AI 帳戶完成身份驗證。

  1. 打開 Claude 的 Settings。在 Customize 下選擇 Connectors。
  2. 選擇 + Add > Add custom connector。

Claude Connectors 設定中打開 Add 菜單,並顯示 Add custom connector 從 Settings > Connectors 開始。Add 菜單會打開自訂連接器表單。

  1. 在 Name 中輸入 Fernhill Help。將 Connect MCP 中的 Agent URL 貼上到 MCP server URL,然後選擇 Continue。

Claude Add custom connector 表單中填寫 Fernhill Help 及其託管的 Quickchat AI MCP 伺服器 URL 名稱是 Claude 中的標籤;URL 決定呼叫哪個 Agent。請使用自己的 URL,而非螢幕截圖中的示範 URL。

  1. 在 Authentication 下,保持選中 Sign in now。Claude 為這個私有 Agent 檢測到了此選項。

Claude 身份驗證選項中,Sign in now 被選中並標為 Detected 私有 Agent 的工具需要先登入才能使用。

  1. 在 OAuth client 下,保持選中 Register automatically。將 Request headers 留空,選擇對話框底部的 Add。Quickchat AI 支援自動客戶端註冊,無需提供 client ID、client secret 或 API 金鑰。

Claude OAuth client 選項中,Register automatically 被選中並標為 Detected Register automatically 是為此伺服器檢測到的選項。本設定無需填寫可選的客戶端和標頭欄位。

  1. 在連接器頁面選擇 Connect。若提示登入 Quickchat AI,請使用所有者帳戶或在此 Agent 上具有角色的帳戶,完成授權。

Claude 顯示 Fernhill Help 已新增但尚未連接,並提供 Connect 按鈕 新增連接器和連接帳戶是兩個獨立步驟。此處請選擇 Connect。

  1. 回傳 Claude,確認頁面顯示 Disconnect 和工具 Ask Fernhill Help。首次測試保持 Needs approval。

已連接的 Fernhill Help 設定,顯示 Disconnect,工具權限下 Ask Fernhill Help 為 Needs approval 工具現在可用了。在此介面中,Claude 將其歸到 Write/delete tools;我們的 Agent 沒有設定訂單、退貨或退款 Actions。

  1. 新建聊天。打開 + > Connectors,為此對話啟用 Fernhill Help。

Claude 聊天的 Connectors 菜單中已啟用 Fernhill Help 除了帳戶連接,還要檢查當前對話的連接器開關。

Anthropic 的入門說明涵蓋連接服務和在聊天中啟用服務的方法。Claude 呼叫工具時可能請求批准;下一步會展示此提示。

此步驟請使用託管 URL。Claude 的遠端連接器請求來自 Anthropic 雲端,即使使用桌面或行動應用程式也是如此。localhost 等僅在你自己電腦上有效的地址,雲端連接無法存取。

第 5 步:如何檢查 Claude 實際轉述了什麼?

將 Claude 的最終回答與工具結果及 Quickchat AI Inbox 比較。一個看似合理的回答本身無法證明連接器被使用了。

  1. 在新的 Claude 聊天中傳送以下指令:
Use Fernhill Help to answer the next three questions. Keep the policy conditions and say when the help center does not confirm something.
  1. 先傳送保修問題。如果 Claude 請求使用 Ask Fernhill Help 的權限,選擇 Allow once 批准本次呼叫。等待回答完成後,再逐個傳送退貨和瑞士問題。

Claude 請求使用 Ask Fernhill Help 回答紫外線損壞保修問題,並顯示 Allow once 首次呼叫暫停等待批准。Allow once 讓你先檢查結果,再決定今後呼叫的權限。

  1. 對每個已完成的回答,檢視 Claude 中 Ask Fernhill Help 的工具使用記錄。需要檢查呼叫時,展開詳細資訊。
  2. 在 Quickchat AI 中選擇 Fernhill Help,打開 Inbox。根據時間戳和問題找到 Claude 對話,同時閱讀收到的訊息和 Agent 的回答。
  3. 記錄原始問題、Agent 收到的問題、Agent 的回答和 Claude 的最終回覆。套件包含空白證據表及我們的記錄,可供參考。

在錄製的執行中,三個問題都進入了同一個來自 Claude 的 Inbox 對話,每個收到的問題都與輸入內容一致。下文 Agent 回答來自該託管對話。前面的 Testing 螢幕截圖則來自獨立的本機執行。

Claude 可能在呼叫 Agent 前改寫問題,也可能在收到結果後進行總結。Inbox 記錄的是 Claude 傳送的訊息,未必是使用者原始措辭。客戶端若開啟新的 MCP 工作階段,也可能建立另一個 Inbox 對話,因此除了討論串,還應核對問題和時間。

檢查 1:Claude 是否保留了保修排除條款?

說明中心明確排除紫外線損壞。Claude 呼叫了 Fernhill Help,並保留了這一排除條款:

Claude 使用 Fernhill Help 後回答紫外線損壞問題,保留保修排除條款,並指出未明確說明的細節 Claude 的完整回答說明紫外線損壞不在保修範圍內,並標明無法確認的額外保修細節。

將它與 Inbox 中對應對話的 Agent 回覆比較:

Quickchat AI Inbox 顯示收到 Claude 的紫外線損壞問題,以及 Fernhill Help 的保修回覆 同一 Inbox 交流中的問題和回覆節選。託管 Agent 提供了兩年保修和三項排除條款,Claude 保留了這些內容。

Claude 還指出了來源未回答的問題,例如兩年期限從何時開始。它將這些標為未知資訊,沒有加入政策。

檢查 2:Claude 是否新增了退貨條件?

退貨回答需要更仔細地檢查,因為它同時涉及資格、截止期限和退款時間。

Claude 的完整夾克退貨回答說明 60 天期限、原始吊牌要求和退款時間,並額外表示吊牌必須仍附在商品上 Claude 保留了主要政策事實,卻新增了更嚴格的條件:“原始吊牌也必須仍附在商品上。”

Agent 自己的回答使用了來源中更有限的表述:

Quickchat AI Inbox 顯示 Claude 的夾克退貨問題,以及要求商品未使用並有原始吊牌、但未指定吊牌是否仍附著的回答 同一 Inbox 交流中的問題和回覆節選。Fernhill Help 要求商品未使用並有原始吊牌。此回覆和 Knowledge Base 都未規定吊牌是否必須仍附在商品上。

檢查點觀察結果
收到的問題Agent 收到的購買後 45 天和未穿過的條件均未變化
Agent 回答60 天內、未使用、原始吊牌;收到退貨後十個工作日內按原付款方式退款
Claude 回答保留上述事實,未聲稱提交退貨,但額外要求吊牌仍附在商品上

這是一次工具呼叫成功,但最終回答與政策存在偏差的案例。我們沒有將其標記為完全通過回答檢查。本機 Agent 的 5.0/5 分數沒有評估 Claude 的轉述,事後修改說明中心文字只會掩蓋偏差,無法解決問題。

對於自己的政策,請逐一對照來源檢查資格條件、例外和期限。“附有原始吊牌”和“吊牌仍附在商品上”可能使讀者作出不同決定。

檢查 3:未知的目的地是否仍保持未知?

本教學開頭的瑞士回答來自 Inbox 中這組對應交流:

Quickchat AI Inbox 顯示 Claude 的瑞士問題,Fernhill Help 表示無法確認配送並建議聯繫支援 同一 Inbox 交流中的問題和回覆節選。託管 Agent 保留了知識缺口,Claude 的最終回答也如此。

這正是本機提示詞修改前失敗的案例。現在 Agent 和 Claude 都區分了有記錄的歐盟、英國目的地和未確認的目的地。建議聯繫支援並沒有建立支援工單或轉交對話,我們未設定這兩種能力。

如何改善未通過檢查的回答?

修改導致失敗的部分,然後重複相同問題。

  1. 沒有呼叫工具:確認連接器已啟用,明確點名 Fernhill Help,並檢查 MCP Description 是否說明了何時使用它。
  2. Agent 回答錯誤:檢查來源文章及其 Ready 狀態,然後在 Testing 中重跑案例。先修正來源或 Main Prompt,再考慮修改 Claude 指令。
  3. Agent 回答正確,Claude 回答改變了內容:指出具體偏差,要求 Claude 僅保留有依據的條件,然後重複交流。再次檢查兩端回答。
  4. 缺少後續支援:將 Description 與 Agent 實際行為比較。如果建立了真正的跟進能力,應在此說明;文字本身不會建立轉交 Action,也不保證 Claude 會轉達提議。

針對觀察到的退貨偏差,可以嘗試以下有針對性的追問:

Check your return answer against Fernhill Help. The source says "with the original tags" but does not say they must still be attached. Re-answer using only the policy conditions supported by the tool result. If a condition is not specified, say it is unconfirmed rather than adding it.

這是建議進行的下一項測試,並非錄製執行中已經展示的修正。驗證新回答後,才能認定問題已解決。如果真實政策確實要求吊牌仍附著,請向政策負責人確認,並明確更新來源。

先前的託管 MCP 教學記錄了一個案例:呼叫客戶端原本省略了後續處理,直到工具描述解釋了這項能力。它說明應該檢查自己的交流,不代表一個描述始終能控制 Claude 的輸出。

能否在行動裝置和 Claude Code 中使用連接器?

託管連接器不限於網頁聊天,但每個客戶端仍需要有效連接,並成功呼叫工具。

在行動裝置,完成網頁或桌面端連接後,登入同一個 Claude 帳戶。同一 Fernhill 對話也可以在 iPhone 上檢視:

同一 Fernhill 對話在 iPhone 上的節選,顯示瑞士問題和 Claude 對該目的地尚未確認的回答 在行動裝置檢視已有對話。這張螢幕截圖不能證明手機發起了新的工具呼叫。

要測試新的行動裝置呼叫,請檢查對話的連接器控件,啟用 Fernhill Help,並再次傳送夾克問題。檢查工具呼叫詳情和新的 Inbox 記錄。Anthropic 在跨設備連接器指南中說明了遠端連接器的可用性。

在 Claude Code 中,先打開 /mcp。使用符合條件的 Claude 訂閱帳戶登入後,claude.ai 上已驗證的連接器可以自動顯示。API 金鑰和第三方供應商登入不會匯入這些連接器。如果改為直接設定伺服器,請使用:

claude mcp add --transport http fernhill-help https://app.quickchat.ai/mcp/YOUR_AGENT_ID

將 URL 替換為自己的地址。打開 /mcp 完成驗證並檢查連接,然後提出相同的政策問題。如果同步的連接器已可用,避免重複新增。這條可選路徑遵循 Claude Code MCP 參考;我們的錄製執行覆蓋上面的 Claude 對話,不包含 Claude Code 工作階段。

如何與團隊共享私有連接器?

共享私有連接器既需要 Claude 側可用,也需要在 Quickchat AI 中擁有使用該 Agent 的權限。

私有存取要求 Quickchat AI 登入和 Agent 角色的概念圖,另一個公開端點只提供可公開的知識 Agent 在生成回答前檢查存取權限。對話中的指令不會授予角色。

  1. 在 Quickchat AI 中,透過 Settings > Organization > Team Members 邀請同事加入 Agent。讓對方接受邀請,再確認其出現在成員列表中。選擇協作席位足夠的方案,並授予所需的最小角色;團隊與角色參考說明了各項權限。
  2. 在 Claude Team 或 Enterprise 中,由 Owner 打開 Organization settings > Connectors,選擇 Add > Custom,若有提示再選 Web,然後新增 Agent URL。擁有相應自訂角色的 Enterprise 使用者也能管理組織連接器。之後成員各自使用帳戶連接。
  3. 使用個人 Claude 方案時,每位同事需在方案限額內將自訂連接器新增到自己的帳戶。
  4. 請同事重複一個政策問題。對於私有 Agent,還要使用沒有角色的獨立帳戶測試。在 Claude 中新增 URL 本身不應授予該帳戶存取權限。

完整測試的存取矩陣,包括移除同事後重試已有連接,請參閱 MCP 身份驗證與授權教學。關鍵權限邊界是 Agent 及其可用的知識和 Actions;此設定不會為每篇文章新增獨立的呼叫者權限。

如何製作公開 FAQ 連接器?

公開 MCP 端點允許呼叫者無需登入 Quickchat AI 即可使用 Agent。只應將它用於你打算公開的知識和能力。

Fernhill Help 只包含虛構的公開說明中心。嘗試公開版本前,檢查完整 Knowledge Base 和 Actions。在 External Apps > MCP 中,關閉 Require sign-in (private) 前先閱讀旁邊的說明。將內部退貨流程或客戶資料保存在另一個私有 Agent 中。

Quickchat AI 在 Require sign-in private 旁的提示,說明公開存取以及由所有者承擔訊息用量 提示說明了誰可以連接,以及消耗誰的 credits。主教學保持 Fernhill Help 私有。

在 Claude 內使用此連接器仍需要 Claude 帳戶。在 Claude 之外,其他 MCP 客戶端也能呼叫公開端點。任何持有 URL 的人都能消耗 Agent 所有者的 AI credits,因此共享後應檢查用量。用獨立客戶端工作階段重複三項政策測試,公開練習結束後重新開啟私有開關。

預填安裝連結可讓同事免去手動複製名稱和 URL。它只填好表單,同事仍需檢查並新增連接器。提交到 Directory 屬於獨立的分發步驟,完成本教學不需要進行此操作。

Claude 能幫助設定 Quickchat AI Agent 嗎?

Quickchat AI Directory 連接器可以根據你的帳戶權限建立 Agent、編輯知識並執行測試。這是上述設定工作的可選快捷方式。

透過 Quickchat AI 的 Claude Directory 頁面連接,並完成你自己的 Quickchat AI 登入。將套件中的文字檔案附加到對話,再使用以下設定提示詞:

Use the Quickchat AI account-management connector to prepare a new Agent named Fernhill Help. Show me the intended changes before creating it, and do not change any existing Agent. Use main-prompt.txt as its Main Prompt and fernhill-help-center.txt as its only Knowledge Base article. Wait for the article to be Ready. Keep this demonstration limited to policy answers, with no custom Actions, Human Handoff or Smart Data Gathering. Create a Testing dataset named Fernhill policy checks from test-messages.txt with evaluation-criteria.txt. Ask me before running tests that consume AI credits. After I approve, enable the Agent's MCP channel with private visibility and give me its hosted URL. Tell me which settings I still need to complete in the dashboard, including the exact Description and Command in mcp-settings.json and mcp-description.txt. Do not make the Agent public or claim that Claude is connected to it until I complete and test the custom-connector setup.

在管理介面中核對 Description 和 Command;帳戶管理快捷方式不能替代這些欄位或 Claude 側的授權。獨立的帳戶管理指南介紹更完整的流程,Quickchat AI for Claude則提供安裝入口和範例。

連接器無法工作時應檢查什麼?

修改 Agent 提示詞前,先定位失敗環節。以下是診斷檢查,並不表示每種錯誤都在 Fernhill 建立中發生過。

症狀先檢查有用的下一步
無法新增自訂連接器Claude 方案限額和組織角色檢查 Free 名額,或請組織 Owner 新增
登入完成,但 Agent 不可用Quickchat AI 帳戶及其在此 Agent 上的角色確認 Quickchat AI 帳戶、準確的 Agent URL 和 Enable MCP
Claude 無法存取伺服器URL 是否為公網可存取的 HTTPS 地址使用 Connect MCP 中的託管 URL;僅本機可用的地址無效
已連接,但沒有工具呼叫當前聊天是否已啟用 Fernhill Help啟用它,明確要求使用,並檢查工具呼叫詳情
回答與政策不符哪個環節最先引入差異比較來源、本機測試回答、MCP 結果和 Claude 最終回答

Anthropic 的連接器故障排除參考為伺服器維運人員介紹 OAuth 發現、網路可達性和重定向。請將這些問題與 Knowledge Base 中錯誤或缺失的事實區分開。

三個案例都正常後,將完整設定應用程式到自己的業務:

  1. 用已批准的知識替換虛構文章,並移除 Fernhill 來源。
  2. 更新 Agent 名稱和 Main Prompt,再更新 MCP 的 Name、Description 和 Command。只描述 Agent 實際擁有的知識和 Actions。
  3. 將測試問題和評估標準替換為你自己的已知答案、附帶條件的答案和刻意缺失的事實。
  4. 在 Claude 中重新整理或重新連接,讓工具資訊反映更改,然後重跑 Agent 測試和端到端比較。

當同事能在 Claude 中提出真實的政策問題,你能在 Inbox 追溯回答,而沒有記錄的事實在回覆中仍保持未確認時,這個成果才真正有用。

常見問題

Claude 連接器是什麼?

Claude 連接器讓 Claude 存取外部工具和資訊。自訂遠端連接器透過 URL 將 Claude 連接到 MCP 伺服器。在本教學中,伺服器提供一個向你的 Quickchat AI Agent 提問的工具。

Claude Free 方案能新增自訂連接器嗎?

可以。Claude Free 支援一個自訂連接器。Pro、Max、Team 和 Enterprise 也支援自訂連接器。Quickchat AI 當前的 Free 方案包含 MCP;生成回答和執行 Simulation 會消耗 AI credits。

Claude 連接器和 MCP 伺服器有什麼區別?

連接器是你在 Claude 中新增並啟用的連接。MCP 伺服器是它連接的服務。Quickchat AI 為 Agent 託管伺服器,因此你只需設定 Agent 並複製其 URL,無需編寫伺服器程式碼。

連接器適用於 Claude Desktop 和行動裝置嗎?

遠端自訂連接器適用於 Claude 的網頁、桌面和行動應用程式。先在網頁或桌面端新增,再在行動裝置使用同一帳戶。本機桌面擴展是另一種設定,不會變成可在行動裝置使用的遠端連接器。

Claude Code 能使用 claude.ai 上新增的連接器嗎?

可以。使用符合條件的 Claude 訂閱帳戶登入時,Claude Code 可自動使用 claude.ai 上已驗證的連接器。先檢查 /mcp。API 金鑰和第三方供應商登入不會匯入這些連接器;也可以改為直接設定託管伺服器。

誰能在 Claude Team 或 Enterprise 中新增連接器?

Team 或 Enterprise 的 Owner 可以為組織新增自訂連接器。擁有管理組織庫所需自訂角色權限的 Enterprise 成員也可以新增。隨後各成員單獨連接。存取私有 Quickchat AI Agent 仍需要在該 Agent 上擁有角色。

此連接器會公開我的整個 Quickchat AI 帳戶嗎?

按 Agent 提供的連接器只暴露所選 Agent 的一個問答工具,不會暴露獨立的帳戶管理工具。Agent 能使用其知識和已啟用的 Actions,共享前請檢查兩者。私有存取在 Agent 邊界上控制,並非為每篇文章設定獨立權限。

客戶沒有 Claude 帳戶也能使用我的連接器嗎?

在 Claude 內使用需要 Claude 帳戶。如果將 Agent 的 MCP 端點公開,呼叫者無需登入 Quickchat AI,但任何持有 URL 的人都能呼叫,生成回答會消耗所有者的 AI credits。請將私有資訊保存在獨立的私有 Agent 中。

Quickchat AI Quickchat AI Ask Quickchat AI a question