MCP 助手与外部 AI 配置指南

通过 Simperator 官方 MCP（Model Context Protocol）服务，用户可将自己的 AI 助手（Claude、Gemini、Cursor、Cline、Codex 等）连接至 Simperator 账户，实现用自然语言查行情、读财报、检索官方手册、管理自选股、草拟交易单等功能。

1. 核心价值与安全机制

节省 Token / 零服务端消耗：由用户自己的大模型提供算力，平台提供安全的数据网关与标准化工具。
资金交割安全红线：AI 助手仅具备创建和撤销「草稿订单」（status = 'order'）的权限。真实的买卖交割与资金扣减必须由用户在网页端（/portfolio）手动点击「交割」按钮完成，杜绝 AI 误操作风险。
令牌独立与即时吊销：每个客户端使用专属的「助手令牌」（sim_atk_...），可在网页端随时一键吊销。
令牌做不了的事：修改密码、通知方式、自带 AI 设置，创建或吊销令牌，交割订单，新建或修改资产账户。这些只能你本人在网页上操作。
代替站内 AI 问答：网站怎么用、档位价格、怎么配置这类问题，直接问你自己的 AI，它会检索平台说明来回答，而且能顺便查你自己的数据核实；答不了的会征得你同意后替你提交工单，并跟进回复。不占用站内问答的每日次数。
能用哪些功能看你的档位：查行情、财报、平台说明、工单所有档位都能用；增删自选、草拟订单、观察笔记、市场评分、策略案例、讨论日志，以及日报、个股报告、调研报告，需要有效订阅（基础档及以上）；筛选器和单品回测需要 Plus 及以上（次数限制见 01、10 号说明）。删除策略案例和讨论记录只能在网页上操作。

2. 先装后连（最简单）

安装 MCP 不需要令牌。没连账户时，AI 只能介绍平台、告诉你怎么注册和拿令牌。

按第 4 节任一方式添加 npx -y simperator-mcp@latest，不填令牌。
在网站订阅 Lite 及以上，按第 3 节生成助手令牌。
把令牌直接粘贴到跟 AI 的对话里，AI 会替你连接并保存到本机（~/.simperator/config.json）。首次连接成功后，AI 会简单介绍能做什么、有哪些命令。

令牌粘贴后会留在那段对话记录里；介意的话用第 4 节方式 A 在终端配置。令牌泄露或不用了，在网页上吊销即可。

3. 生成专属助手令牌

登录 Simperator 平台，进入右上角「用户账号（/user）」页面。
页面滚动至底部的「助手令牌」面板。
点击「创建令牌」，输入设备或用途名称（如 我的 MacBook、Cursor 编程）。
系统将生成一个以 sim_atk_ 开头的完整密钥。请立即点击「复制」并妥善保管（出于安全考虑，系统仅展示一次）。

4. 在不同客户端中配置接入

无论使用哪款 AI 工具，底层均通过标准 npm 包 simperator-mcp@latest 运行。请根据您的使用场景选择以下任意一种配置方式：

方式 A：全局一键配置（所有终端与工具通用）

在任意系统终端中执行一次以下命令，系统会将令牌保存在用户本地凭据中（~/.simperator/config.json）：

npx -y simperator-mcp@latest config --token sim_atk_你的助手令牌

优势：完成全局配置后，后续在任何 AI 工具中加载只需运行 npx -y simperator-mcp@latest，无需重复传递环境变量。

方式 B：Claude Code 终端命令行接入

在您项目的任意终端工作区直接执行：

claude mcp add simperator -e SIMPERATOR_TOKEN=sim_atk_你的助手令牌 -- npx -y simperator-mcp@latest

或直接在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "simperator": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "simperator-mcp@latest"],
      "env": {
        "SIMPERATOR_TOKEN": "sim_atk_你的助手令牌"
      }
    }
  }
}

方式 C：Claude Desktop（桌面版官方客户端）

点击桌面端菜单进入配置（或直接编辑 ~/Library/Application Support/Claude/claude_desktop_config.json），在 mcpServers 节点中加入：

{
  "mcpServers": {
    "simperator": {
      "command": "npx",
      "args": ["-y", "simperator-mcp@latest"],
      "env": {
        "SIMPERATOR_TOKEN": "sim_atk_你的助手令牌"
      }
    }
  }
}

保存并重启 Claude Desktop 即可。

方式 D：Gemini / Cursor / VSCode Cline / Windsurf

通用标准 JSON（支持配置文件的客户端如 Gemini CLI / Continue 等）：

{
  "mcpServers": {
    "simperator": {
      "command": "npx",
      "args": ["-y", "simperator-mcp@latest"],
      "env": {
        "SIMPERATOR_TOKEN": "sim_atk_你的助手令牌"
      }
    }
  }
}

可视化面板添加（如 Cursor 设置中的 MCP 面板）：
- Name: simperator
- Type: command
- Command: npx -y simperator-mcp@latest
- Environment Variables:
  - SIMPERATOR_TOKEN: sim_atk_你的助手令牌

5. 验证连通性

配置完成后，可在终端执行测试命令验证认证状态：

SIMPERATOR_TOKEN="sim_atk_你的助手令牌" npx -y simperator-mcp@latest test

若输出类似以下内容，即代表配置成功：

Testing connection to: https://server2.simperator.com/api
✓ Successfully connected and authenticated!
  User: <你的用户名>
  Role: <你的用户档位>

6. 日常使用指令示例

成功接入后，即可在对话中直接用自然语言对 AI 发送指令：

查阅系统使用文档与规则：
- “请调用 Simperator 官方文档，查一下平台 Telegram 机器人怎么配置？”
- “帮我查一下不同订阅档位有什么权益区别？”
行情与个股分析：
- “查一下苹果（AAPL）和英伟达（NVDA）的最新价格走势与量价表现”
- “帮我看一下特斯拉（TSLA）下一次公布财报是什么时候？”
- “获取平台 AI 针对 NVDA 生成的最新审核报告与交易设置”
自选与监控管理：
- “列出我的所有自选股列表”
- “帮我把 TSLA 加到我当前的第一个自选组”
交易计划与订单草拟：
- “帮我在第一证券账户里草拟一个买入 10 股 AMD 的订单，止损设在 120”
- （AI 会生成未交割订单并给出提示，您随后前往网页端 /portfolio 核对价格并点击交割）
工单与客户支持：
- “帮我查看一下我之前提交的工单客服回复了没有”
- “帮我向平台提交一个故障报告工单，说明我在自选页遇到了加载问题”
筛选器（Plus 及以上）：
- “帮我写一个规则：均线多头排列、最近 5 天缩量回踩 20 日均线，先在 NVDA、AAPL 上回测一年看看命中在哪”（单品回测，完整流程见 10 号说明）

“帮我建一个筛选器：均线多头排列、最近 5 天缩量回踩 20 日均线，先放 debug 组”
- “用这个筛选器建一个全市场、股价 20 以上的计划，现在跑一次看看命中哪些票”
- “把它改成每天自动执行”（需要 Pro，且筛选器在 product 组，最多 3 个自动计划）

7. 现成命令（Lite 及以上）

连接后，MCP 会提供几个现成命令。Claude Code 里输入 / 能看到 mcp__simperator__ 开头的命令；Claude Desktop、Cursor 等在提示词（prompts）菜单里。命令内容由平台提供，更新不用重装。

命令	干什么	参数
review（每日审核）	按你自己的交易守则审核大盘、持仓、在管候选，写入每日报告和个股报告。还没有守则时，先陪你花几分钟建一份	留空 = 完整审核；股票代码 = 只分析这几支
live（盘中看一眼）	快速看结构和风险，不写记录；加 buy 给入场判断（含止损和财报门槛），加 close 给出场判断	`代码 [buy\|close]`，留空 = 扫持仓
research（个股调研）	AI 联网查公司业务、增长故事、风险、财报趋势、新闻，定风险评级并存进个股调研	`代码 [update]`
log（讨论日志）	记一笔你和 AI 的买卖分歧，10/30/60 天后复核谁对	`log` / `check` / 代码

每日审核没有固定模板：守则写什么，它就按什么审。守则可以随时让 AI 帮你改，每次保存都会留一个版本。

没找到答案？点右下角「问 AI」，问不到的问题我们会补进手册。