在 Claude 中连接 QVeris MCP：自定义连接器配置指南
通过自定义连接器接入 QVeris，完成 OAuth 授权与工具权限设置，在 Claude 对话中使用专业数据与工具。
开始之前
通过自定义连接器，将 Claude 接入 QVeris Hosted MCP。本文通过四个主要步骤，介绍添加连接器、配置认证、账号授权、确认权限和在对话中启用 QVeris 的流程，无需安装本地服务器或编辑 JSON 配置文件。
准备好 Claude 账号，以及 QVeris 账号或已有 API Key。组织工作区需要确认自定义连接器权限。菜单名称和功能可用性可能因账号与产品版本而异。
服务器地址使用 https://mcp.qveris.ai/mcp，保留末尾的 /mcp。采用 OAuth 认证和 Streamable HTTP 传输协议。
第一步：添加 QVeris 自定义连接器
在 Claude 左侧打开 Customize → Connectors → Yours，点击右上角 Add → Add custom connector。
在弹窗中将名称填写为 QVeris，服务器地址填写为 https://mcp.qveris.ai/mcp，保留末尾的 /mcp，然后点击 Continue。
https://mcp.qveris.ai/mcp
在 Authentication 中选择 Sign in now，在 OAuth client 中保留 Use Claude’s published identity，无需填写 client ID 或 client secret。
Request headers 留空，在 Advanced → Transport 中保留 Streamable HTTP，然后点击 Add。如果 Claude 显示未连接页面，点击 Connect 进入 QVeris 授权流程。
第二步：选择账号或 API Key 授权
在 QVeris 授权页确认应用名称为 Connect Claude。选择以下任一方式验证身份，查看权限后完成授权。
方式 A：Use account
选择 Use account，登录希望供 Claude 使用权限的 QVeris 账号，查看请求的权限后点击 Allow and continue。登录在 QVeris 页面完成，不要在聊天中输入密码。
方式 B：Use API Key
在同一个 QVeris 官方授权页选择 Use API Key，在 QVeris API Key 输入框中填写已有密钥，然后点击 Continue with API Key 完成验证。
验证通过后，查看请求的权限，点击 Allow and continue，返回 Claude。不要将密钥粘贴到聊天、MCP 地址或支持消息中。
此方式仍使用 OAuth。API Key 在 QVeris 授权页验证访问权限，Claude 完成的仍是 OAuth 连接，不会接收你的 API Key。Request headers 保持为空，本流程无需配置 Authorization: Bearer 请求头。
第三步：确认连接成功与工具权限
返回 Claude 后，确认出现“Connected to QVeris.”提示、Disconnect 按钮及 Tool permissions 工具列表。如果仍显示 Connect，请先完成授权。
查看可用工具及其权限。只读工具分组选择 Needs approval 后，Claude 使用相关工具时会请求批准。连接成功不代表收费工具免费，也不代表已获得所有供应商的数据权限。
第四步：在对话中启用 QVeris
新建对话，点击输入框旁的＋按钮，展开 Connectors，打开 QVeris 开关。蓝色开关表示当前对话已启用。
接下来描述需要的数据或任务，说明时间范围和输出格式。检查 MCP 是否实际调用时，在提示词中明确要求使用 QVeris，并按下文查看工具活动。
验证 QVeris：发现工具 → 检查 → 调用
启用 QVeris 后，先验证工具发现。选择当前对话中的 QVeris MCP，输入以下请求：
仅使用当前对话选择的 QVeris MCP，发现一个查询伦敦当前天气的工具，暂不执行数据查询。
本例中，Claude 调用了 Discover QVeris capabilities，返回 Current Weather（WeatherAPI），并列出工具标识、必填参数 q，以及每次调用 1 credit 的费用信息。右侧 Context 中也显示 QVeris MCP。这说明工具发现已执行；回复明确说明尚未执行天气查询。
接下来检查工具：“请对发现的工具进行检查或 Probe，展示必填参数、供应商、只读行为和当前 credits 报价，暂不执行查询。”使用实际返回的工具标识与参数结构。本例费用仅供参考，以当前报价为准。
确认输入与报价可接受后，批准一次调用：“我批准按显示费用，使用已检查的工具执行一次伦敦天气只读查询，不要自动重复。”
最后展开工具活动，核对执行状态、来源、观测时间与返回的天气数据，必要时查看 QVeris 用量。工具发现成功仅代表 Discover 已完成，仍需继续检查并验证天气查询结果。
排查连接和回调失败
先确认问题发生在哪个环节：添加连接器、在 QVeris 授权、返回 Claude，还是执行工具。不同环节需要分别检查，不能仅凭连接失败提示判断原因。
没有自定义连接器入口
检查 Customize → Connectors 入口及账号、组织权限。组织账号可联系管理员确认是否允许使用自定义连接器。入口缺失不代表 QVeris 端点故障。
批准授权后未返回 Claude，或仍显示未连接
确认服务器地址为 https://mcp.qveris.ai/mcp，且已完成 Allow and continue。返回原来的 Claude 账号与工作区，查看连接器状态。如果浏览器提示打开 Claude，按提示完成跳转；若仍显示 Connect，通过现有连接器重新认证。
回调报错或授权页面加载失败
先记录错误码和发生环节。页面提供 Continue 或重试入口时，先完成该操作，再尝试重连现有连接器。问题持续时，可在隐私浏览窗口登录同一账号与工作区，重新尝试一次授权。这些是排查手段，不保证修复；不要反复重建连接器或无依据地切换 OAuth 客户端设置。
API Key 验证失败
在 QVeris 账号中检查密钥状态，确认填写时没有多余空格。在官方授权页完成 Continue with API Key 验证后，还需查看权限并点击 Allow and continue。不要将密钥改填到 MCP 地址、聊天或请求头中绕过验证。
已连接，但工具未调用或没有返回数据
确认当前对话已启用 QVeris，所需工具未被禁用。先执行 Discover，再检查工具参数与报价，最后批准 Call。核对供应商可用性、账号权限及用量限制。如果执行结果不确定，先查看调用状态再重试，避免重复请求。
授权过期或持续失败
收到重新登录提示时，通过现有连接器完成认证。授权有效时 OAuth 可续期访问权限，但授权到期或撤销后仍可能需要重新登录。持续失败时，向支持团队提供 UTC 失败时间、错误码、页面显示的请求 ID、所用 Claude 客户端及失败步骤。不要发送密码、API Key、Cookie、令牌、授权码、HAR 文件或包含凭据的回调地址。
常见问题
需要修改本地 JSON 文件吗？
不需要。本文通过 Claude 界面配置远程 MCP 自定义连接器。
需要填写 Authorization 请求头吗？
本文的 OAuth 流程无需填写，Request headers 留空，在 QVeris 页面完成授权即可。
Add 和 Connect 是同一步吗？
不是。Add 保存连接器配置；如果随后显示未连接页面，还需要点击 Connect 完成授权。
连接勾选标记能证明查询成功吗？
勾选标记表示连接状态。需要通过实际工具执行记录与返回数据确认查询成功。