通过 MCP 连接 AI 助手

开始之前

1. 一个 AlgoVesta 账户。7 天试用即可满足需求——测试这项功能无需付费方案。
2. 一个 MCP 客户端:网页版、桌面版或移动版 Claude,Claude Code,Cursor,付费版 ChatGPT,Gemini CLI,或任何其他支持 Model Context Protocol 的客户端。
3. 一个密钥。开始使用不需要已连接的交易所:paper 密钥可在 5,000 美元虚拟余额上运行完整工具集,因此您可以在涉及任何真实账户之前完成全部设置并进行演练。

1. 创建您的 MCP 链接

1. 打开 AlgoVesta 面板,进入MCP 连接选项卡
2. 点击创建密钥,为其取一个能说明使用位置的标签(例如 claude-desktop 或 cursor-laptop)
3. 选择作用域:仅查询投资组合选 read,在 5,000 美元虚拟余额上使用完整工具集选 paper,下真实订单选 live
4. 复制显示出来的地址。它的格式如下:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. 添加到 Claude

1. 在 Claude 中,打开设置 → 连接器
2. 点击添加自定义连接器
3. 为其命名(AlgoVesta),并将您的 MCP 链接粘贴到 URL 字段中
4. 保存后开始一段新对话——工具会出现在该对话的工具列表中

该连接器会在网页版、桌面版和移动版 Claude 之间同步,因此添加一次即可覆盖您的手机。如果您不想粘贴一个秘密地址,AlgoVesta 还在 https://api.algovesta.com/mcp 提供了支持 PKCE(S256)和动态客户端注册的标准 OAuth 2.1 端点——将连接器指向该地址,系统会引导您完成常规的浏览器同意流程。

3. 添加到 Claude Code

一条命令即可通过可流式传输的 HTTP 注册该服务器:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

之后运行 claude mcp list 以确认服务器已注册且可访问。

4. 添加到 Cursor 或 ChatGPT

Cursor 会读取一个 JSON 配置文件。在 mcp.json 中添加一条配置:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI 使用相同的配置,但字段名为 httpUrl 而不是 url。其余部分完全相同。

ChatGPT 在付费方案中支持自定义 MCP 连接器,需要在设置中启用开发者模式。在那里添加连接器,并粘贴相同的链接。

5. 验证连接

1. 在您的客户端中开始一段新对话
2. 提问:How is my portfolio?
3. 助手应当调用 get_portfolio_context 工具,并用您真实的余额和持仓作答——如果是 paper 密钥,则基于 5,000 美元虚拟余额

如果它没有调用工具而是泛泛作答,说明服务器尚未连接:助手谈论的是交易的一般话题,而不是您的账户。请重新检查链接并重启客户端。

连接后助手能做什么

共公开了 20 个工具。其中 14 个用于读取或演练,不会改变任何东西:get_portfolio_context、get_market_price、get_trade_history、compare_venues、simulate_order、list_open_orders、list_strategies、verify_receipt、replay_channel 和 compile_policy。另外 6 个用于写入:place_order、close_position、modify_position、cancel_order、create_strategy 和 update_strategy。

您不需要按名称调用这些工具。用日常语言提问即可——"我现在持有什么?""现在买 0.1 个 BTC 要花多少钱?""平掉我一半的 ETH 仓位"——助手会自行选择工具并将它们串联使用。它开出的每一笔仓位都必须设置止损,并且事后没有任何工具可以移除止损。每个工具的完整模式见开发者文档。

401 unauthorized

密钥已被撤销、已被删除,或地址输入有误。当链接是手动粘贴或复制时带有多余空格,这是最常见的失败原因。请检查该密钥是否仍存在于MCP 连接选项卡中;如果存在,请不要尝试修复字符串,而是删除后重新创建一个。

insufficient_scope

助手尝试调用的工具所需的作用域高于该密钥所拥有的作用域。read 密钥无法调用 place_order,paper 密钥也无法触及真实账户。作用域是分级的,因此需要 paper 的工具会拒绝 read 密钥。您可以接受这一限制,也可以按实际需要的作用域发放一个新密钥——升级到 live 需要双重验证。

user_frozen

您账户上的紧急开关已被触发,这会一次性停用所有密钥。这是刻意设计的行为,相当于一个紧急刹车。想恢复交易时,请在面板中解除冻结。如果您只是想切断某一个客户端,请只撤销那一个密钥——其他密钥会继续正常工作。

rate_limited

该密钥已超过每分钟 60 次请求的上限。开销较大的工具适用更严格的限制:place_order 限制为每分钟 10 次,replay_channel 限制为每小时 5 次。请稍候后重试。反复出现这种情况,通常意味着某个代理陷入了循环,而不是您在快速交易——在提高请求频率之前,值得先确认一下助手实际在做什么。