QVeris MCP Server 集成指南
通过 MCP 将 Claude Code、Cursor 等智能体环境连接到 QVeris 的已验证能力。
QVeris MCP 服务器的作用
QVeris MCP 服务器是兼容的 MCP 客户端和 QVeris 功能路由网络之间的集成层，而不是静态工具目录。
面向智能体的发现
AI智能体用自然语言描述他们需要什么。 QVeris 返回与成本、延迟和成功率匹配的排名功能 — 无预编码端点。
已验证能力
超过 15 个类别的 10,000 多个预先验证的工具。每个能力都有质量信号：成功率、平均执行时间和计费规则。
统一协议接入
一台 MCP 服务器使您的代理能够访问市场数据、投资研究、合规性检查、加密数据等——所有这些都通过标准模型上下文协议进行。 [参考链接]
结构化执行
每个调用都在沙盒环境中运行，具有结构化 JSON 响应、唯一执行 ID、账单详细信息和剩余信用余额。
执行前检查
发现和检查始终是免费的。代理在将积分投入呼叫之前会审查架构、成本和质量指标。
生产接入评估
99.99% 的正常运行时间、低于 500 毫秒的 p95 延迟、RBAC 访问控制和完整的审计跟踪 — 所有 QVeris 集成方法的基础设施相同。 [1] [参考链接]
接入流程
AI 智能体如何通过 QVeris MCP 服务器和功能路由网络连接到外部功能。
接入条件
配置 QVeris MCP 服务器集成之前您需要什么。
QVeris访问权限
具有有效 API 凭据的 QVeris 帐户。 QVeris 使用带有 Bearer Token 的 API 密钥身份验证。需要有效的 QVERIS_API_KEY 或 QVeris 凭据。免费帐户包括当前定价页公布的账户额度。
兼容MCP客户端
支持模型上下文协议的AI智能体环境或编码工具。 Claude Code 和 Cursor 已确认兼容。其他与 MCP 兼容的客户端也可以工作。
配置细节
官方 QVeris MCP 服务器命令和任何必需的参数。这些值应从您的 QVeris 仪表板或官方文档中获取。有关预期结构，请参阅下面的示例配置部分。
版本兼容
| 组件 | 最低版本 | 建议版本 | 说明 |
|---|---|---|---|
| Node.js | 18 LTS | 22 LTS | 执行npx所需环境 |
| MCP协议 | 2024-11-05 | 2024-11-05 | 当前稳定版本 |
| @qverisai/mcp | 最新版本 | 最新版本 | 核对npm版本标签，生产环境锁定已验证版本 |
| Claude Code | 0.x | 1.x+ | 1.x版本支持MCP v1 |
| Cursor | 0.40.x | 0.45.x+ | 0.40版本增加MCP支持 |
配置指南
QVeris MCP 服务器集成过程的分步演练。
确认QVeris访问权限
如果您还没有注册 QVeris 帐户，请在 qveris.ai 上注册。免费帐户包括当前定价页公布的账户额度。从 QVeris 仪表板获取您的 API 密钥。需要有效的 QVERIS_API_KEY 或 QVeris 凭据。 [参考链接]
添加 QVeris MCP 服务器配置
将 QVeris MCP 服务器条目添加到 MCP 客户端的配置中。配置结构遵循标准 MCP 服务器格式。有关预期的 JSON 结构，请参阅下面的示例配置部分。确切的命令和参数值需要从官方 QVeris 文档中确认。 [参考链接]
连接您的 AI 智能体或 MCP 兼容客户端
启动或重新启动与 MCP 兼容的 AI 智能体环境（Claude Code、Cursor 或其他兼容客户端）。客户端应从您的配置中检测到 QVeris MCP 服务器。验证连接是否处于活动状态 - 您的代理现在应该将 QVeris 功能视为可用工具。
发现可用能力
要求您的代理使用自然语言查找功能。例如，您的代理可以查询“美国股票的市场数据”或“KYC 验证工具”。 QVeris 返回与成本估算、延迟和成功率匹配的排名功能。发现始终免费且不消耗积分。
检查能力架构和要求
在调用功能之前，您的代理可以检查其完整参数架构、计费规则、示例使用情况和质量指标。这一步始终是免费的。代理应验证输入参数是否与预期模式匹配，并且成本是否适合可用信用余额。
使用结构化参数调用功能
一旦代理选择并检查了功能，它就会提交包含所需参数的结构化调用。 QVeris 在沙盒环境中执行调用并返回结构化 JSON 响应，其中包含结果数据、唯一执行 ID、账单详细信息和剩余信用余额。
查看响应、日志或执行输出
您的代理收到结构化 JSON 输出，可立即在下游工作流程中使用。每个调用都会返回一个execution_id、search_id和session_id以进行完整的审计跟踪和调试。
配置示例
QVeris MCP 服务器配置条目的预期结构。将占位符值替换为您的实际 QVeris 凭据和官方服务器命令。
// ~/.claude/settings.json or Cursor MCP config
{
"mcpServers": {
"qveris": {
"command": "npx",
"args": ["-y", "@qverisai/mcp"],
"env": {
"QVERIS_API_KEY": "sk-xxx"
}
}
}
}claude mcp add qveris -s user -e QVERIS_API_KEY=sk-xxx -- npx @qverisai/mcp代理如何通过 MCP 使用 QVeris 功能
连接后，您的 AI 智能体将遵循发现 → 检查 → 调用工作流程进行每个功能交互。
发现
Agent 用自然语言描述它需要什么（“AAPL 本季度的盈利数据”）。 QVeris 返回与工具 ID、预期成本、延迟估计和成功率匹配的排名。始终免费——不消耗积分。
检查
代理审查候选功能的完整参数架构、计费规则和质量指标。零成本决策点——代理可以在进行呼叫之前比较多种功能。
调用
代理提交结构化参数。 QVeris 在沙箱中执行，返回结构化 JSON 及结果、唯一的execution_id、账单详细信息和剩余信用余额。仅在成功呼叫时消耗积分。
// Step 1: Discover — agent queries available capabilities
{"capabilities": [
{"id": "financial-stock-price-realtime",
"name": "Real-Time Stock Price",
"cost_credits": "5 per call",
"avg_latency_ms": "320",
"success_rate": "99.2%"}
]}
// Step 2: Inspect — review schema and cost before committing
{"schema": {"properties": {"symbol": {"type": "string", "description": "Ticker symbol (e.g. AAPL)"}},
"required": ["symbol"]},
"cost_per_call": "5 credits",
"avg_execution_ms": "320"}
// Step 3: Call — execute with parameters
{"symbol": "AAPL"}
// Response
{"result": {"symbol": "AAPL", "price": "189.50", "currency": "USD", "last_updated": "2026-05-28T20:15:30Z"},
"execution_id": "exec_abc123",
"credits_used": "5",
"credits_remaining": "995"}适用场景
QVeris MCP 服务器增加价值的常见环境和工作流程。应根据官方 QVeris 文档验证平台支持。
Claude Code
Anthropic 的官方 CLI 代理。已确认为 QVeris MCP 服务器的兼容 MCP 客户端。您的 Claude Code 代理可以直接在基于终端的编码工作流程中发现并调用 QVeris 功能。
Cursor
支持 MCP 的 AI 优先 IDE。确认为兼容环境。连接 QVeris MCP 服务器，让您的 Cursor 代理在开发会话期间访问经过验证的工具、API 和实时数据。
金融智能体
执行投资研究、市场情报、风险评估和合规检查的代理。通过 MCP 访问市场数据、收益、KYC、制裁筛查、加密数据等。
投资研究流程
自动执行收益分析、估值模型数据检索和市场情报收集。 QVeris 将每个研究查询路由到经过验证的财务数据功能。
企业内部智能体
通过 MCP 将内部企业 AI 智能体连接到 QVeris 功能，以进行文档处理、数据丰富、合规性检查以及具有完整审计跟踪的外部 API 访问。
智能体SaaS产品
构建 SaaS 产品，其中 AI 智能体需要动态访问外部工具和数据。 QVeris MCP 服务器提供一个集成点，而不是管理数十个第三方 API 集成。
除列出的平台外，也可能存在其他兼容客户端；接入前核对当前支持情况。浏览工作流指南 →
最佳实践
有关将 QVeris MCP 服务器有效且安全地集成到 AI 智能体工作流程中的建议。
从一小部分功能开始
从与代理的主要任务相关的一组重点功能开始。随着您了解每个功能域的成本、延迟和可靠性特征，逐渐扩展。
执行前检查模式
在调用功能之前，请务必检查参数架构、计费规则和质量指标。检查是免费的，可以防止预期参数与实际参数之间代价高昂的不匹配。
保护认证凭据
安全地存储您的 QVeris API 密钥。使用环境变量或秘密管理器。切勿在可能提交版本控制的配置文件中对凭据进行硬编码。
跟踪执行和输出
记录每个调用的execution_id、search_id 和session_id 值。这些标识符可实现完整的审计跟踪重建、成本跟踪和调试。
独立的测试和生产工作流程
使用单独的 QVeris 会话或 API 密钥进行测试和生产。这可以防止测试调用消耗生产信用预算并保持审计跟踪干净。
使用前验证输出
对于财务、合规性或其他受监管的工作流程，请先验证结构化输出，然后再将其用于下游决策。 QVeris 提供数据和执行跟踪 - 您的代理逻辑仍应验证结果是否满足您的要求。
故障排查
常见的集成场景和解决路径。确切的错误消息和代码应根据官方 QVeris 文档进行验证。
身份验证或访问问题
验证您的 QVeris API 密钥有效且未过期。需要有效的 QVERIS_API_KEY 或 QVeris 凭据。检查您的帐户是否有可用积分。确认 API 密钥在 MCP 服务器环境配置中正确传递。
MCP客户端找不到服务器
确认 QVeris MCP 服务器命令正确且服务器进程正在运行。验证您的 MCP 客户端配置文件位于正确的位置并且具有有效的 JSON 语法。进行配置更改后重新启动 MCP 客户端。
未发现所需能力
尝试更广泛或措辞不同的自然语言查询。发现与功能描述和元数据相匹配——重新表述查询可能会显示相关功能。确保您的帐户计划包括对您正在搜索的功能类别的访问权限。
参数结构不匹配
再次检查功能以确认当前参数模式。能力模式可以由提供商更新。确保您的代理在调用之前以正确的类型传递所有必需的参数。
工具调用失败
检查结构化错误响应以获取详细信息。常见原因包括积分不足、速率限制、参数无效或提供商暂时不可用。查看特定错误上下文的执行响应。
速率限制或权限问题
免费帐户的速率限制为 10 个请求/分钟； Pro 帐户每分钟有 100 个请求。如果您达到速率限制，请考虑升级您的计划。对于权限问题，请验证您的帐户层是否包含对所请求功能的访问权限。
本指南如何比较
了解概念页面、本集成指南和替代集成方法之间的区别。
概念页面与集成指南
| 维度 | MCP概念页 | 本集成指南 |
|---|---|---|
| 核心问题 | 什么是MCP服务器？ | 如何使用QVeris MCP服务器？ |
| 内容类型 | 概念解释 | 实用接入指南 |
| 用户意图 | 了解与学习 | 实施与连接 |
| 配置步骤 | 无或很少 | 包含配置结构的七步流程 |
| 代码与配置 | 概念示例 | 结构明确的占位配置示例 |
| 故障排查 | 未包含 | 六种常见问题及处理路径 |
| 适用场景 | MCP新用户 | 准备通过MCP接入QVeris的用户 |
QVeris MCP 服务器与替代集成方法
| 维度 | QVeris MCP服务器 | 手动集成API | 静态MCP工具目录 | 通用API市场 |
|---|---|---|---|---|
| 发现 | ✓自然语言 | ✗需要预先编写端点代码 | ◐仅关键词搜索 | ◐按类别浏览 |
| 成本预览 | ✓调用前 | ✗无预览 | ✗仅计费页面 | ✗不提供 |
| 质量信号 | ✓成功情况与延迟 | ✗无 | ✗仅供应商声明 | ✗未验证 |
| 协议 | ✓统一MCP连接 | ✗每个API单独接入 | ✗多个不同API | ✗无统一协议 |
| 审计记录 | ✓execution_id与会话追踪 | ◐取决于供应商 | ✗有限 | ✗无 |
| 执行 | ✓沙箱隔离 | ◐仅直接调用 | ✗因配置而异 | ✗无 |
| 面向智能体 | ✓面向智能体设计 | ✗面向开发者设计 | ✗面向开发者设计 | ✗面向开发者设计 |
本指南是如何构建的
本集成指南是一份技术文档，旨在供开发人员和 AI 智能体工程师通过模型上下文协议集成 QVeris 功能。内容基于公开的 QVeris 文档、MCP 规范和观察到的集成模式。
研究方法
- 官方平台材料中记录的 QVeris 能力路由网络分析
- 模型上下文协议规范审查 (2024-11-05) 及其实施要求
- 与兼容的 MCP 客户端文档（Claude Code、Cursor）交叉引用以获取集成模式
- 配置示例源自整个生态系统中使用的标准 MCP 服务器模式
- 基于 QVeris 发布的服务描述的指标定义（正常运行时间、延迟、成功率）
指标定义
- avg_latency_ms — 平均往返执行时间（以毫秒为单位），从请求接收到响应传递进行测量。来源：能力检查期间返回的 QVeris 能力元数据。
- success_rate — 在过去 30 天的时间范围内无错误完成的调用的百分比。来源：QVeris 功能元数据。
- 正常运行时间 — 可通过 API 访问 QVeris 平台的时间百分比。官方材料声称为99.99%。
- cost_credits — 每次成功调用消耗的 QVeris 积分数。因功能复杂性和提供商定价而异。
- 请求/分钟 — API 速率限制。免费帐户：10 个请求/分钟。专业帐户：100 请求/分钟。来源：QVeris 定价页面。