Engineering · Tutorial工程实践 · 教程

Connect QVeris to Cursor with MCP通过 MCP 将 QVeris 接入 Cursor

Step-by-step guide: connect QVeris MCP Server to Cursor and let your AI coding assistant discover and call thousands of real-world APIs — without leaving your IDE.分步指南：将 QVeris MCP Server 连接到 Cursor，让您的 AI 编码助手发现并调用数千个真实世界 API — 无需离开 IDE。

Cursor — project

Get me the current AAPL stock price and add it to the dashboard获取当前 AAPL 股价，并将其添加到仪表盘获取当前 AAPL 股价，并将其添加到仪表盘获取当前 AAPL 股价，并将其添加到仪表盘

I'll fetch the real-time stock data for you.
🔧 QVeris → finance.stock_quote
✓ Executed in 320ms

const stockData = {
symbol: "AAPL", price: 198.52,
change: +2.31, timestamp: "2026-03-25T14:32:07Z"
};

Read the MCP Server Documentation →阅读 MCP Server 文档 →Create a QVeris API Key创建 QVeris API Key

Why Connect QVeris to Cursor?为什么将 QVeris 连接到 Cursor？为什么将 QVeris 连接到 Cursor？为什么将 QVeris 连接到 Cursor？

✗ Without QVeris✗ 未接入 QVeris✗ 未接入 QVeris✗ 未接入 QVeris

AI only knows your codebaseAI 只能理解您的代码库AI 只能理解您的代码库AI 只能理解您的代码库
Can't access live data or external APIs无法访问实时数据或外部 API无法访问实时数据或外部 API无法访问实时数据或外部 API
You write boilerplate for every integration每项集成都要自行编写样板代码每项集成都要自行编写样板代码每项集成都要自行编写样板代码
AI guesses API responses from training dataAI 只能根据训练数据猜测 API 响应AI 只能根据训练数据猜测 API 响应AI 只能根据训练数据猜测 API 响应
Each new data source = new integration work每增加一个数据源，都要重新做集成每增加一个数据源，都要重新做集成每增加一个数据源，都要重新做集成

✓ With QVeris✓ 接入 QVeris✓ 接入 QVeris✓ 接入 QVeris

AI discovers 10,000+ real APIs on demandAI 可按需发现 10,000 多个真实 APIAI 可按需发现 10,000 多个真实 APIAI 可按需发现 10,000 多个真实 API
Live stock, crypto, weather, news in IDE在 IDE 中访问实时股票、加密货币、天气和新闻在 IDE 中访问实时股票、加密货币、天气和新闻在 IDE 中访问实时股票、加密货币、天气和新闻
Zero boilerplate — QVeris handles auth & routing无需样板代码，认证和路由由 QVeris 处理
Real API responses, not training data guesses使用真实 API 响应，而不是训练数据猜测使用真实 API 响应，而不是训练数据猜测使用真实 API 响应，而不是训练数据猜测
New capability = one natural language request一条自然语言请求即可调用新能力一条自然语言请求即可调用新能力一条自然语言请求即可调用新能力

QVeris connects to Cursor via MCP Server — the same protocol Cursor uses for all tool integrations. Setup takes under 5 minutes.QVeris 通过 MCP Server 连接 Cursor，这也是 Cursor 集成各类工具所使用的协议。整个设置不到 5 分钟。QVeris 通过 MCP Server 连接 Cursor，这也是 Cursor 集成各类工具所使用的协议。整个设置不到 5 分钟。QVeris 通过 MCP Server 连接 Cursor，这也是 Cursor 集成各类工具所使用的协议。整个设置不到 5 分钟。

How QVeris Works Inside CursorQVeris 在 Cursor 内部如何工作

💬

You Ask Cursor向 Cursor 提出请求向 Cursor 提出请求向 Cursor 提出请求

Type a request in Cursor's AI chat:
"Get the current Bitcoin price and format it for my dashboard"“获取当前比特币价格，并按我的仪表盘格式整理”“获取当前比特币价格，并按我的仪表盘格式整理”“获取当前比特币价格，并按我的仪表盘格式整理”

→

🔀

QVeris MCP RoutesQVeris MCP 完成路由QVeris MCP 完成路由QVeris MCP 完成路由

Cursor sends the request to QVeris. QVeris discovers the best capability, inspects parameters, and executes against a verified provider.Cursor 把请求发送给 QVeris；QVeris 随即发现最合适的能力、检查参数，并通过经过验证的提供商执行。Cursor 把请求发送给 QVeris；QVeris 随即发现最合适的能力、检查参数，并通过经过验证的提供商执行。Cursor 把请求发送给 QVeris；QVeris 随即发现最合适的能力、检查参数，并通过经过验证的提供商执行。

→

✓

Live Data Returns返回实时数据返回实时数据返回实时数据

Structured JSON flows back. Your AI uses live data to complete the task — with real numbers, not training data estimates.结构化 JSON 返回 Cursor，AI 使用实时数据完成任务，得到的是真实数值，而不是基于训练数据的估算。结构化 JSON 返回 Cursor，AI 使用实时数据完成任务，得到的是真实数值，而不是基于训练数据的估算。结构化 JSON 返回 Cursor，AI 使用实时数据完成任务，得到的是真实数值，而不是基于训练数据的估算。

Set Up QVeris in Cursor: Step by Step在 Cursor 中设置 QVeris：分步教程

Takes less than 5 minutes. No credit card required.整个过程不到 5 分钟，无需信用卡。整个过程不到 5 分钟，无需信用卡。整个过程不到 5 分钟，无需信用卡。

Get Your QVeris API Key获取 QVeris API Key获取 QVeris API Key获取 QVeris API Key

Sign up at qveris.ai — free account includes 1,000 credits. No credit card required. Navigate to Account → API Keys → Create New Key.在 qveris.ai 注册免费账户即可获得 1,000 积分，无需信用卡。进入“账户 → API Keys → 创建新密钥”。在 qveris.ai 注册免费账户即可获得 1,000 积分，无需信用卡。进入“账户 → API Keys → 创建新密钥”。在 qveris.ai 注册免费账户即可获得 1,000 积分，无需信用卡。进入“账户 → API Keys → 创建新密钥”。

① Go to qveris.ai/account?page=api-keys ② Click「Create API Key」 ③ Copy your key: qv-xxxxxxxxxxxxxxxxxxxx

Open Cursor MCP Settings打开 Cursor MCP 设置打开 Cursor MCP 设置打开 Cursor MCP 设置

In Cursor, open Settings and navigate to the MCP configuration section. Cursor's official MCP documentation explains the supported transports and configuration locations.在 Cursor 中打开设置并进入 MCP 配置区域。Cursor 的官方 MCP 文档说明了支持的传输方式和配置文件位置。

Cursor MCP Config

# Navigate to: Cursor → Settings → MCP → Add Server # Or edit directly: ~/.cursor/mcp.json

Add QVeris MCP Server Config添加 QVeris MCP Server 配置添加 QVeris MCP Server 配置添加 QVeris MCP Server 配置

Add the QVeris MCP Server configuration to your Cursor MCP settings file.把 QVeris MCP Server 配置加入 Cursor 的 MCP 设置文件。把 QVeris MCP Server 配置加入 Cursor 的 MCP 设置文件。把 QVeris MCP Server 配置加入 Cursor 的 MCP 设置文件。

~/.cursor/mcp.json

{ "mcpServers": { "qveris": { "command": "npx", "args": ["-y", "@qverisai/mcp"], "env": { "QVERIS_API_KEY": "your-api-key-here" } } } }

Replace your-api-key-here with the key you copied in Step 01.

Restart Cursor and Verify重启 Cursor 并验证重启 Cursor 并验证重启 Cursor 并验证

Restart Cursor to load the QVeris MCP Server. Then verify the connection in Cursor's AI chat.重启 Cursor 以加载 QVeris MCP Server，然后在 Cursor AI 聊天中验证连接。重启 Cursor 以加载 QVeris MCP Server，然后在 Cursor AI 聊天中验证连接。重启 Cursor 以加载 QVeris MCP Server，然后在 Cursor AI 聊天中验证连接。

Cursor AI Chat

# Type this in Cursor AI chat: "Check my QVeris connection and show available capabilities" # Expected response: ✓ QVeris MCP Server connected ✓ 10,000+ capabilities available ✓ Credits remaining: 1,000 ✓ Ready to discover and call tools

See It in Action查看实际效果

Real examples of what you can ask Cursor to do after connecting QVeris.下面是连接 QVeris 后可以直接交给 Cursor 的真实任务示例。下面是连接 QVeris 后可以直接交给 Cursor 的真实任务示例。下面是连接 QVeris 后可以直接交给 Cursor 的真实任务示例。

📈

"Fetch AAPL, MSFT, GOOGL prices and create a comparison table"“获取 AAPL、MSFT 和 GOOGL 的价格，并生成对比表”“获取 AAPL、MSFT 和 GOOGL 的价格，并生成对比表”“获取 AAPL、MSFT 和 GOOGL 的价格，并生成对比表”

✓ Live market data✓ 实时市场数据✓ 实时市场数据✓ 实时市场数据

🌤

"Get current weather in Tokyo and format it as a JSON object"“获取东京当前天气，并整理为 JSON 对象”“获取东京当前天气，并整理为 JSON 对象”“获取东京当前天气，并整理为 JSON 对象”

✓ Real-time weather✓ 实时天气✓ 实时天气✓ 实时天气

💱

"Convert 10,000 USD to JPY, EUR, and GBP at current rates"“按当前汇率将 10,000 美元换算为日元、欧元和英镑”“按当前汇率将 10,000 美元换算为日元、欧元和英镑”“按当前汇率将 10,000 美元换算为日元、欧元和英镑”

✓ Live forex rates✓ 实时汇率✓ 实时汇率✓ 实时汇率

₿

"Get BTC, ETH, SOL prices and calculate my portfolio value"“获取 BTC、ETH 和 SOL 的价格，并计算我的投资组合价值”“获取 BTC、ETH 和 SOL 的价格，并计算我的投资组合价值”“获取 BTC、ETH 和 SOL 的价格，并计算我的投资组合价值”

✓ Live crypto data✓ 实时加密货币数据✓ 实时加密货币数据✓ 实时加密货币数据

📰

"Find the latest news about OpenAI and summarize key points"“查找 OpenAI 的最新新闻并总结要点”“查找 OpenAI 的最新新闻并总结要点”“查找 OpenAI 的最新新闻并总结要点”

✓ Real-time news✓ 实时新闻✓ 实时新闻✓ 实时新闻

📄

"Get Apple's latest earnings data and add it to my analysis file"“获取苹果最新财报数据，并添加到我的分析文件中”“获取苹果最新财报数据，并添加到我的分析文件中”“获取苹果最新财报数据，并添加到我的分析文件中”

✓ SEC filing data✓ SEC 文件数据✓ SEC 文件数据✓ SEC 文件数据

CLI or MCP Server for Cursor?CLI 还是 MCP Server 用于 Cursor？

	MCP Server	CLI
Best for最适合	Cursor inline AI chatCursor 内联 AI 聊天	Cursor terminal / scriptsCursor 终端与脚本
Setup设置方式设置方式设置方式	mcp.json config配置 mcp.json配置 mcp.json配置 mcp.json	npm install通过 npm 安装通过 npm 安装通过 npm 安装
How it works工作方式	Tool schemas in context工具 Schema 注入上下文	Subprocess command子进程命令
Output输出方式	Inline in chat在聊天中直接使用	Terminal + --json终端命令配合 --json
Token costToken 成本Token 成本Token 成本	Schema injectionSchema 注入Schema 注入Schema 注入	~50–100 tokens约 50–100 Token约 50–100 Token约 50–100 Token
Recommendation推荐场景推荐场景推荐场景	✓ Cursor AI chat✓ Cursor AI 聊天✓ Cursor AI 聊天✓ Cursor AI 聊天	✓ Cursor terminal✓ Cursor 终端✓ Cursor 终端✓ Cursor 终端

Pro tip: Use both. MCP Server for inline AI chat requests, CLI in Cursor's integrated terminal for scripts and automation. Same QVeris account and API key for both.建议两者搭配使用：MCP Server 负责内联 AI 聊天请求，CLI 负责 Cursor 集成终端中的脚本与自动化；二者可共用同一个 QVeris 账户和 API Key。建议两者搭配使用：MCP Server 负责内联 AI 聊天请求，CLI 负责 Cursor 集成终端中的脚本与自动化；二者可共用同一个 QVeris 账户和 API Key。建议两者搭配使用：MCP Server 负责内联 AI 聊天请求，CLI 负责 Cursor 集成终端中的脚本与自动化；二者可共用同一个 QVeris 账户和 API Key。

Common Setup Issues常见设置问题

MCP Server not showingMCP Server 未显示

① Check mcp.json syntax with a JSON validator
② Ensure npx is installed: npx --version
③ Restart Cursor completely (not just reload)
④ Check Cursor Settings → MCP for errors

① 使用 JSON 验证器检查 mcp.json 语法
② 确认已安装 npx：npx --version
③ 完全重启 Cursor，而不是只重新加载
④ 在 Cursor 设置 → MCP 中检查错误信息

API key not recognizedAPI Key 无法识别

① Verify key starts with qv- prefix
② Check for extra spaces when copying
③ Confirm key is active at qveris.ai/account
④ Create a new key if issue persists

① 确认密钥以 qv- 开头
② 检查复制时是否带入多余空格
③ 在 qveris.ai/account 确认密钥处于启用状态
④ 如果问题仍然存在，请创建新密钥

Tool calls returning errors工具调用返回错误

① Check credit balance at qveris.ai/account
② Verify network connectivity to qveris.ai
③ Check execution logs: Account → Usage
④ Try the call in Live Demo first: qveris.ai/playground

① 在 qveris.ai/account 检查积分余额
② 确认可以正常连接 qveris.ai
③ 在账户 → 使用记录中检查执行日志
④ 先在 qveris.ai/playground 在线演示中测试调用

Frequently Asked Questions常见问题

How do I install QVeris in Cursor?如何在 Cursor 中安装 QVeris？

Add the QVeris MCP Server to your Cursor MCP settings by editing ~/.cursor/mcp.json with the QVeris server config. Set your QVERIS_API_KEY environment variable, restart Cursor, and the integration is ready. Full setup takes under 5 minutes — see the step-by-step guide above.编辑 ~/.cursor/mcp.json 添加 QVeris MCP Server 配置。设置您的 QVERIS_API_KEY 环境变量，重启 Cursor，集成即完成。完整设置不到 5 分钟 — 请参阅上文的分步指南。

What can QVeris do inside Cursor?QVeris 可以在 Cursor 中完成什么？

After connecting QVeris, your Cursor AI can discover and call 10,000+ real-world capabilities — including live stock prices, crypto data, weather, forex rates, news feeds, SEC filings, OCR, document processing, and more — directly from your AI chat panel while you code. No leaving the IDE. No writing API boilerplate.连接 QVeris 后，您的 Cursor AI 可以直接从 AI 聊天面板发现并调用 10,000+ 真实世界能力 — 包括实时股票价格、加密货币数据、天气、外汇汇率、新闻、SEC 文件、OCR、文档处理等。无需离开 IDE。无需编写 API 样板代码。

Is QVeris MCP Server free to use in Cursor?在 Cursor 中使用 QVeris MCP Server 免费吗？

The MCP Server itself is free and open source. Discovery and inspection are always free — zero credit cost. Credits are consumed only when you execute live tool calls (1–100 credits per call). New accounts get 1,000 free credits on signup with no credit card required.MCP Server 本身是免费且开源的。发现和检查始终免费 — 零积分成本。积分仅在执行实时工具调用时消耗（每次调用 1–100 积分）。新账户注册即获 1,000 免费积分，无需信用卡。

What's the difference between MCP Server and CLI for Cursor?在 Cursor 中使用 MCP Server 与 CLI 有什么区别？在 Cursor 中使用 MCP Server 与 CLI 有什么区别？在 Cursor 中使用 MCP Server 与 CLI 有什么区别？

MCP Server integrates directly into Cursor's AI chat — your AI can call tools inline as it responds to you. CLI runs in Cursor's integrated terminal as a subprocess. Both connect to the same QVeris network. Most Cursor users benefit from running both simultaneously — MCP for chat, CLI for scripts.MCP Server 直接集成到 Cursor 的 AI 聊天中 — 您的 AI 可以在回复时内联调用工具。CLI 在 Cursor 的集成终端中作为子进程运行。两者连接到同一个 QVeris 网络。大多数 Cursor 用户同时使用两者效果最佳 — MCP 用于聊天，CLI 用于脚本。

Does QVeris work with Cursor's Agent mode?QVeris 支持 Cursor 的 Agent 模式吗？

Yes. QVeris MCP Server works with all Cursor modes including Agent mode. In Agent mode, Cursor can autonomously discover and call QVeris capabilities as part of multi-step coding workflows — fetching live data, processing it, and writing it directly into your codebase.是的。QVeris MCP Server 适用于所有 Cursor 模式，包括 Agent 模式。在 Agent 模式下，Cursor 可以自主发现并调用 QVeris 能力，作为多步骤编码工作流的一部分 — 获取实时数据、处理数据并直接写入您的代码库。