连接你的 AI 助手
向 Claude、ChatGPT、Claude Code 或 Cursor 询问你的持仓,或通过对话添加持仓。
适用于网页版、桌面版和移动版的所有 Claude 套餐。免费套餐包含一个自定义连接器。
你会在设置过程中登录 Sonar。还没有账户?免费创建一个。
服务器 URLhttps://sonarfolio.com/api/mcp打开 Customize,然后选择 Connectors。
打开 Claude 连接器(在新标签页中打开)依次选择 + Add 和 Add custom connector。命名为 Sonar 并粘贴服务器 URL。
如有询问,选择 Sign in now 和 Use Claude's published identity,无需客户端 ID 和密钥,然后选择 Add。
选择 Connect,登录并选择允许。在对话中依次选择 + 和 Connectors 将其开启。
我最大的五个持仓是什么?请使用网页版 ChatGPT。自定义 MCP 服务器取决于你的 ChatGPT 套餐;在 Business 和 Enterprise 中,可能需要管理员允许。
你会在设置过程中登录 Sonar。还没有账户?免费创建一个。
服务器 URLhttps://sonarfolio.com/api/mcp打开 Plugins。
打开 ChatGPT 插件(在新标签页中打开)依次选择 + 和 Add custom MCP server。命名为 Sonar 并粘贴服务器 URL。
将 Authentication 设为 OAuth,客户端 ID 和密钥留空。接受警告,然后选择 Create as a plugin。
收到提示时,登录并选择允许。然后从你的插件中安装它,并在对话中输入 @。
我最大的五个持仓是什么?ChatGPT 在添加持仓前会请你确认。
适用于使用请求头的客户端,如 Claude Code 和 Cursor,需要 API 密钥。
先创建免费账户,再创建密钥。密钥只显示一次。
获取 API 密钥将 Sonar 添加到你的客户端。
Claude Codeclaude mcp add --transport http sonar https://sonarfolio.com/api/mcp \ --header "Authorization: Bearer YOUR_KEY"
Cursor:~/.cursor/mcp.json{ "mcpServers": { "sonar": { "url": "https://sonarfolio.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }其他 MCP 客户端:Streamable HTTP,请求头 Authorization: Bearer YOUR_KEYhttps://sonarfolio.com/api/mcp在 Claude Code 中运行
/mcp检查连接。
也可以不用密钥:添加不带请求头的 URL,运行 /mcp,选择 Sonar,然后选择 Authenticate。
我最大的五个持仓是什么?连接器只能看到你持有的资产。它们可以添加你描述的持仓,但无法交易、转移资金或删除任何内容。
故障排除
无法连接或没有显示工具
检查 URL 是否以 /api/mcp 结尾,以及登录是否以允许结束。否则,移除 Sonar 后重新添加。
助手提示需要套餐或额度
你的套餐决定助手能看到什么;每次工具调用计为一次请求。在API 和 AI 工具中查看请求和额度。
你断开了应用或撤销了密钥
访问会立即停止。要重新连接,移除 Sonar,重新添加并登录。
你在 Team 或 Enterprise 套餐中使用 Claude
所有者用服务器 URL 添加一次 Sonar;每位成员登录自己的账户。
REST API
通过 HTTPS 返回 JSON,使用 Bearer 密钥。每个端点都有对应的 MCP 工具和 CLI 命令。
curl https://sonarfolio.com/api/v1/assets \ -H "Authorization: Bearer YOUR_KEY"
- GET/api/v1/meMCPget_usageCLIsonar status套餐、访问权限和今日用量Starter
- GET/api/v1/assetsMCPlist_held_assetsCLIsonar assets你持有的每项资产的市场和社交数据Starter
- GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>单项持有资产:报价、社交、头部创作者、90 天收盘价Starter
- GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>查找资产 ID(仅名称)Starter
- GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolio总计、24 小时变化、盈亏、配置、涨跌榜Standard
- GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]每个账户的全部持仓Standard
- POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]添加持仓:{ asset_id, quantity, cost_usd?, date?, account? }写入数据。MCP 客户端会看到它标记为 destructive;CLI 会先询问(--yes 可跳过)。Starter
响应包含数据来源、时间戳和我们的免责声明,以及 X-RateLimit-Limit、-Remaining、-Reset 和 X-Credits-Remaining 请求头。错误:{ error: { code, message } }。
命令行
用同一个密钥,在终端和脚本中使用同样的数据。
安装并登录
npm install -g sonarfolio sonar login
需要 Node 18 或更高版本。sonar login 会保存来自API 和 AI 工具的密钥;在脚本和 CI 中,请改为设置 SONAR_API_KEY。
更多安装选项
再次运行安装即可更新。无需安装即可试用:npx -p sonarfolio sonar status。从本站安装:npm install -g https://sonarfolio.com/cli/latest.tgz。你的密钥保存在 ~/.config/sonar/config.json,仅你本人可读取。
命令
命令与 REST 端点列在一起,另有 sonar watch [portfolio|assets] 可在每日限额内显示实时视图。
在脚本中使用
sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'每个命令都支持 --json,并输出 API 的 JSON。
限额和额度
每次 API 调用、MCP 工具调用或 CLI 命令计为一次请求。每日限额在 00:00 UTC 重置。
| 套餐 | 包含的请求 | 涵盖 |
|---|---|---|
| Free | 仅 API 额度 | 价格和你的投资组合 |
| Starter | 每天 500 次 | 价格、社交数据和添加持仓 |
| Standard | 每天 1,000 次 | 增加持仓、盈亏、配置和链上数据 |
| Premium | 每天 2,000 次 | 增加持仓、盈亏、配置和链上数据 |
端点列表中的套餐名称表示包含该请求的套餐;其他情况在任何套餐中都由 API 额度支付。$1 可购买 1,000 个,额度永不过期,每个账户初始有 100 个。