Claude 连接器:无需代码,构建自己的连接器

Piotr Grudzień
发布日期 阅读时间约 18 分钟
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