关于 vortex-iq
vortex-iq 是面向 VortexIQ 电商 AI 操作系统的只读连接器,供用户通过 MCP 客户端查询店铺运营数据。工具涵盖审计、KPI、告警、品牌指南、报告等工作区数据,并按登录用户的组织和角色限定范围。
主要功能
- 01查询店铺审计和报告
- 02查看 KPI、告警与活动
- 03访问品牌资料和 Ask VIQ 对话
- 04查看 Kanban 修复项和报告
- 05读取工作区数据而不修改内容
适用场景
- 01检查近期店铺审计及发现
- 02查看 KPI 数值和活跃告警
- 03获取品牌语气指南与健康修复待办
MCP 相关
这是使用 Streamable HTTP 的远程 MCP 服务,通过 OAuth 2.1 和 PKCE 验证身份。它提供 30 个只读工具,范围限定为登录用户所属组织的数据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://app.vortexiq.ai/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http ai-vortexiq-vortex-iq https://app.vortexiq.ai/mcpCursor.cursor/mcp.json
{"mcpServers":{"ai-vortexiq-vortex-iq":{"type":"http","url":"https://app.vortexiq.ai/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"ai-vortexiq-vortex-iq":{"type":"http","url":"https://app.vortexiq.ai/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"ai-vortexiq-vortex-iq":{"type":"http","url":"https://app.vortexiq.ai/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"ai-vortexiq-vortex-iq":{"serverUrl":"https://app.vortexiq.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
VortexIQ MCP Connector
面向 VortexIQ 的只读 Model Context Protocol 连接器——VortexIQ 是一款面向电商的 AI 操作系统。
将它连接到 Claude(或任何 MCP 客户端),即可通过对话了解商店健康状况、KPI、警报、品牌语调、SEO 草稿等信息;数据范围仅限你自己的 VortexIQ 工作区。所有工具均为只读:该连接器无法创建、编辑、删除、发布或发送任何内容。
- 服务 URL:
https://app.vortexiq.ai/mcp - 传输方式: Streamable HTTP(远程 MCP 服务)
- 身份验证: 按用户进行 OAuth 2.1 身份验证(Authorization Code + PKCE,S256)
- 访问权限: 只读,仅限已登录用户所在组织的数据
连接
Claude(网页端 / 桌面端)
- 设置 → 连接器 → 添加自定义连接器。
- 服务 URL:
https://app.vortexiq.ai/mcp - 使用现有的 VortexIQ(Google)账号登录,然后点击允许。
- 工具会显示在 Claude 中。试试问:“列出我最近的商店审计。”
你需要拥有一个 VortexIQ 账号。返回的数据仅限于你所在的组织,以及你所拥有角色的权限范围。
任意 OAuth 客户端
完整的 OAuth 2.1 + PKCE 流程(注册、授权、令牌、刷新)记录在 MCP_OAUTH_LIVE_USAGE.md 中。端点可通过机器发现:
GET https://app.vortexiq.ai/.well-known/oauth-authorization-server
GET https://app.vortexiq.ai/.well-known/oauth-protected-resource
你可以询问的内容
| 提示词 | 使用的工具 |
|---|---|
“列出我最近的商店审计,然后显示集成 <id> 的调查结果。” | 商店审计运行记录 → 报告 |
“有哪些可用的 KPI?请显示 <integration> 的 30 天 KPI。” | KPI 库 → 集成 KPI |
| “列出我在 Nerve Centre 中的活跃警报和 24 小时事件摘要。” | 警报 → 警报摘要 |
| “显示我的 Brand DNA 品牌语调指南。” | 品牌档案 |
| “显示我的 Kanban 健康修复待办事项。” | Kanban 看板 → 修复项 |
工具(30 个,全部只读)
每个工具的完整参考文档位于 docs/tools/,每个工具各有一个页面,包含参数、提示词示例和返回内容。
| 领域 | 工具 |
|---|---|
| Store Audit | 列出商店审计运行记录 · 获取商店审计报告 · 获取商店审计状态 |
| Nerve Centre 与 KPI | 列出 Nerve Centre 警报 · 获取警报摘要 · 列出警报活动 · 获取集成 KPI · 列出 KPI 库 · 获取 Nerve 集成计数 · 列出 Nerve Centre 档案 · 列出 Nerve 配置 · 列出连接器目录 · 按类型列出监控项 · 获取仪表板活动动态 · 列出仪表板商店 |
| Brand DNA | 获取品牌档案 · 列出品牌档案 · 列出品牌电商商店 |
| Ask VIQ | 列出 Ask VIQ 对话 · 获取 Ask VIQ 对话 |
| Kanban(健康修复) | 获取 Kanban 看板 · 获取 Kanban 修复项 · 获取 Kanban 修复状态 |
| 报告与洞察 | 列出洞察报告 · 列出报告档案 · 列出报告计划 |
| 库存与记忆 | 列出 CloudHub 库存标签页 · 列出 Vortex 记忆文件 · 列出 Vortex 记忆报告 |
| 部署 | 获取部署历史记录 |
备注与限制
- 只读。 不提供写入、删除、发布或发送工具。
- 按用户限定范围。 每次调用都会以连接用户的身份访问其所在组织的数据——不使用共享账号。
- 响应上限。 为方便模型处理,部分列表结果设有上限(前 50 项 / 约 40k 个字符);如需深入查看,请请求特定 ID。
支持
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。