一条 SandBase Skill，接上 Claude Code、Cursor 和 Codex
把一条 Skill 指令贴进 Claude Code、Cursor 或 Codex。浏览器登录授权，不要把 API 密钥贴进对话。模型服务和数据接口走同一余额。
Claude Code、Cursor、Codex 都会说 MCP，配置文件却各写各的。下一步通常是把 Bearer 令牌贴进三份配置。SandBase 推荐的做法是在对话里贴一行。这不是终端命令。Agent 去读技能文件（Skill），确认本机有 Node.js 20 或更新版本，跑 CLI，你在浏览器里点一次授权。API 密钥不要贴进对话。
set up https://www.sandbase.ai/SKILL.mdAI 工具页的头部就是这一行，旁边写着 CLI 会装上，你在浏览器里点一次授权。
SandBase AI 工具页头部：一行 Skill 安装文案 set up https://www.sandbase.ai/SKILL.md ，页面原样。
新开会话之后，同一余额上的模型服务和数据接口，走 sandbase_discover、sandbase_inspect、sandbase_run。另外两条路是终端里的 connect，以及把 API 密钥放进客户端机密配置的原始 MCP 地址。三条路都写在 AI 工具页。本文没有执行 connect、doctor，也没有打付费调用。下面的命令是这些页面在 2026-11-08 公布的写法。
先说结论
- 把上面那一行贴进编码 Agent 的对话。Skill 明确要求：不要向用户要 API 密钥。
- 不带参数的
npx -y @sandbaseai/cli@latest connect会配置这台机器上它认得出的客户端。--client claude-code、cursor或codex只动一个。Skill 默认只配当前这个，除非你说要全部。- 检索和查看价格不扣余额。只有
sandbase_run会扣。慢任务用轮询，不要再跑一遍。- 已经在某家数据供应商充过值，或就是要它那套工具名，就留着它的 MCP。客户端不在 CLI 名单里，就手写原始 MCP。
三份 MCP 配置不该是默认动作
2026-11-08 当天，Claude Code 的 MCP 文档 仍是 claude mcp add --transport http，外加 Authorization: Bearer 头和 .mcp.json。Cursor 的 MCP 文档 让你在 Customize 里装，或者写 mcp.json。Codex 的 MCP 文档 把服务器写进 ~/.codex/config.toml，受信任的项目可以用 .codex/config.toml，每台服务器是一张 [mcp_servers.<name>] 表。Streamable HTTP 可以用 bearer_token_env_var，避免把令牌写进文件。桌面端和 IDE 扩展都要求保存后重启，再用 codex mcp list 或 /mcp 看有没有挂上。
Kitquarry 的三份配置对照（2026-10-29 更新）把格式差写清楚了，包括 Claude 要 "type": "http"，以及环境变量的三种写法。对照有用，文件还是三份。数据供应商再给你一块 JSON，密钥照样要贴进客户端。买的就是那一家目录时，这样合理。想要的是「手头这个 Agent 能看见模型服务和数据接口，而且密钥不进聊天记录」时，这样就不合适。
这条连接实际装上什么
SandBase 提供的是目录和余额。它不拥有 Claude、Cursor、Codex，也不拥有上游接口。当天 SKILL.md 和 AI 工具页都写着「2,000+ models and APIs」。这是站点自己的说法，本文没有重数一遍。数据接口目录 写的是 113 个平台。Twitter/X 数据接口 是其中一页，所以后面的例子用帖子搜索，而不是编一个端点。
| 工具 | 做什么 | 扣余额吗 |
|---|---|---|
sandbase_discover | 搜目录。可以按 type、vendor 收窄。 | 不扣 |
sandbase_inspect | 入参、价格，以及一份 execute_as 模板 | 不扣 |
sandbase_run | 执行刚查过的那一个 | 扣 |
sandbase_run_get | 状态、费用、输出。轮询用这个。 | 不扣，只读状态 |
sandbase_runs | 最近的调用和费用 | 不扣 |
sandbase_account | 余额 | 不扣 |
sandbase_run_cancel | 取消一次 Agent Service 运行 | 页面没说这是一笔费用 |
多数数据接口在 sandbase_run 里直接回到 completed。生图、生视频这类长任务返回 running 和一个 run_id。每 5 到 10 秒用 sandbase_run_get 看一次。再调一次 sandbase_run 就是再扣一笔。
当天的 价格页：检索是 $0。符合条件的数据接口，每个组织每天共享 100 次免费调用，00:00 UTC 重置。模型服务不在这 100 次里。失败的模型或数据接口调用不收费。Build 按次计费，没有订阅。$1 体验金写在 AI 工具页，不在价格页：符合条件的新账号可以拿到。某个工具算不算进每日免费额度，以 sandbase_inspect 当场显示的为准。
首页 的「How do I use SandBase in my agent?」重复了同一行 Skill。另一条「一把 API 密钥调站点上的模型和服务」说的是 HTTP 调用，不是让你在 Skill 安装时把密钥贴进对话。
Skill、CLI connect，还是原始 MCP
| 路径 | 什么时候用 | 你输入什么 | 凭证从哪来 |
|---|---|---|---|
| Skill，优先 | Agent 能读 URL，也能跑 shell | 上面那一行，贴在对话里。地址是 SKILL.md | 浏览器登录授权，生成 CLI Login 密钥。不要贴 API 密钥。 |
| CLI | Agent 没有 shell，或你想一次配齐本机客户端 | npx -y @sandbaseai/cli@latest connect，可加 --client | 同一次浏览器登录授权 |
| 原始 MCP | 客户端不在名单里，或密钥必须进现有机密库 | https://api.sandbase.ai/v1/mcp | Bearer API 密钥放进客户端机密配置，不进对话，不进 git |
页面上这三张卡片和表是同一件事。Skill 标成推荐。CLI 是不带参数的 connect。MCP 是 Streamable HTTP 地址，API 密钥用 Bearer 放在客户端配置里。
SandBase 三条接入路径：Skill、CLI connect，以及原始 MCP 端点。
路径 A：贴一行 Skill
贴在 Agent 的对话里，不要贴在终端：
set up https://www.sandbase.ai/SKILL.mdSKILL.md 接着要求 Agent 做这些事：node --version 低于 20 就停。对当前这个 App 执行 npx -y @sandbaseai/cli@latest connect --client <client-id>。浏览器授权至少等 5 分钟，因为命令会堵到你点完。这台机器没有浏览器时，CLI 会打印一个 URL。它报告客户端已配置之后，新开一次会话或重启 App，sandbase_* 工具才会出现。
「已配置」不等于「调用成功」。Skill 把状态拆开了。已配置，是登录和客户端条目写完。工具可用，是这一次会话里的 discover 或 inspect 成功了。另开一个终端能跑 CLI，不能证明这个聊天窗口加载了 MCP。第一次调用核实，是业务请求走到成功终态，而且你看过输出。只有一个 run id，不算第三态。
只配一个，还是本机认到的全部
当天 SKILL.md 列了 25 个 client id，和 AI 工具页的数量一致。本文关心的是 claude-code、cursor、codex。页面上还能看到 OpenCode、Windsurf、Gemini CLI、Claude Desktop、ChatGPT，并把 iFlow CLI 标成 legacy。ChatGPT 和 Cowork 被标成账号类产品。本文没有把这 25 个都装一遍，名单上有名字不等于这台机器实测通过。完整 id 在 Skill 文件里。
支持的智能体与 AI 工具列表，含 Claude Code、Cursor、Codex。
Skill 让 Agent 给当前 App 带上 --client，只有你开口要全部时，才去配每一个已安装的客户端。接入文档 写的是：不带 --client 的 connect，会在一次登录后配置它找到的每一个受支持客户端。页面上「25 agents and AI tools, one connection」指的是这条机器级命令。把 Skill 行贴进 Claude Code，应该只动 Claude Code。Cursor 和 Codex 也要，就明说，或者走路径 B。
路径 B：在终端里跑 CLI
Agent 跑不了 shell，或者你想看着浏览器提示、一次配齐，用这条。
npx -y @sandbaseai/cli@latest connect
npx -y @sandbaseai/cli@latest connect --client codex
curl -fsSL https://sandbase.ai/install.sh | sh -s -- --client codex
curl -fsSL https://sandbase.ai/install.sh | sh -s -- --list-agentsconnect 打开浏览器，为你批准的工作区创建 CLI Login 密钥，并且只写 SandBase 拥有的那一段配置。各客户端的差别见 sandbaseai/cli。2026-11-08，npm 上 @sandbaseai/cli 的 latest 是 0.3.8。文档写的是 @latest，不是把版本钉死。
8 月那篇 CLI 说明 用的是钉死的 v0.1.17 压缩包，工具也只列了六个。现在的 SKILL.md 是七个，多了 sandbase_run_cancel。那篇适合看回滚和 unregister。安装命令不要照抄。
然后再确认一次，而且要在客户端里面确认：
npx -y @sandbaseai/cli doctor --client codex文档说 doctor 会检查本地凭证、MCP 条目和 Skill，再做一次往返。配的是 Claude Code 或 Cursor，就把 id 换成 claude-code 或 cursor。只卸 SandBase 自己的条目：npx -y @sandbaseai/cli unregister --client codex。别的 MCP 服务器留着。不再用的话，到控制台撤销对应的 CLI Login 密钥。
路径 C：原始 MCP 端点
客户端不在 CLI 能写的名单里，或者这台机器规定密钥只能进你已有的机密库，用 AI 工具页公布的地址：
https://api.sandbase.ai/v1/mcp
Authorization: Bearer <SandBase API 密钥>登录后，控制台 AI 工具页的「Other ways to connect」里也能看到这个 URL。密钥从 Developer → API Keys 来。Claude Code 用 --header 传。Codex 可以用 bearer_token_env_var。Cursor 走 Customize 或 mcp.json。密钥不要提交，也不要贴进对话凑设置。
MCP 服务器目录 不是这个端点。2026-11-08 的 HTML 标题是「50 MCP servers」，首屏 HTML 里有 Exa、Slack、GitHub 这类第三方卡片。同一份数据里仍留着空状态文案「No MCP servers are available yet.」。卡片是一条目录。它不能证明 SandBase 在运营那台服务器，也不能证明本文测过，更不能证明 Skill 把它装上了。
第一次闭环：先发现，再看价，再跑
新会话里用一句请求，就能看出工具加载了没有：
Find an API that searches X posts about AI agents.
Show the schema and the price before you run anything.
If it is in the daily free allowance, run one small query.当天 SKILL.md 里的示例名是 sandbase_twitter_web_search_timeline，参数是 {"keyword": "AI agents"}。真正要跑的那天，工具名从 discover 抄，字段从 inspect 抄。短名词比一整段话好用。查询太长会空。空了先看 hints，再改说法。
每天 100 次免费数据调用按组织共享，00:00 UTC 重置。模型、生图、生视频、语音照样计费。不少数据接口按返回条数计费，所以一次一个搜索词，limit 先用 5 到 10。状态是 running 就轮询。跑完的记录在 Activities 里能看到状态和费用。本文没有 Activities 行，因为没有发起那次调用。
同一把 API 密钥还覆盖代码沙箱的，看 一把 Key 的技术栈。只看沙箱限额，看 E2B 对照。托管会话看 Agents API 三条路。这篇只解决编码工具怎么接。
什么时候别用这条 Skill
SKILL.md 第 4 节已经把你自己的工具排在这笔余额前面。你这次的明确指示优先，然后是你已有的 MCP、CLI 或 API 密钥，然后是普通网页抓取够用的情况，最后才是 SandBase 上的结构化数据、媒体，或某一个指定模型。改本地文件，不该走这里。
没有 Node.js 20+，就不要贴 Skill 行。客户端能存 Bearer 令牌的话，原始 MCP 仍可用。既没有 shell、又不能手写 MCP 的客户端，不会因为贴了一句话就多出工具。提示词已经在叫 TikHub、Wellbyte 或 DataAndAPIs 的工具名，也别为了「统一」拆掉。
想要的如果是 Claude Code 的通过率，去看 Claude Code 接入 SandBase MCP：配置与 12 次实测。那是 2026-10-03、某一个 bridge 版本上的测量。那些表留在那边。本文不重复，也不声称数字今天还成立。
贴 JSON 的数据 MCP 仍有自己的位置
2026-11-08 核对。数字是各家页面自己写的，不是 SandBase 的普查。
| 做法 | 你要贴什么 | 那天页面怎么说 | 留着它的时候 |
|---|---|---|---|
| DataAndAPIs | 远程 MCP。请求头、Bearer，或把密钥放进 Claude 连接器 URL。 | 主文案 128+ 个数据 API，标题写成 125+。工具是 search_apis、get_api、call_api。真正调用要密钥。免费档写成每月 500 tokens。 | 你要的就是这家数据目录，而且密钥已经在手上。它不是模型目录。 |
| TikHub | stdio 用 mcp-remote，或 SSE，或 Streamable HTTP。Bearer。一个平台一台服务器。 | 990+ 工具，16 个平台 MCP。 | 你要的是按端点拆开的社交工具表。 |
| Wellbyte | @wellbyte/mcp，加上 API 密钥和 profile UUID，或远程 URL 加 Bearer。 | search_endpoints、get_endpoint_schema、call_endpoint。 | 你已经在跑 Wellbyte 的 profile。 |
| 手写 MCP | 三份客户端文件 | 你接的那台服务器 | 服务器不是 SandBase，或公司不允许 CLI 改客户端配置。 |
排错和密钥边界
| 你看到的 | 怎么处理 |
|---|---|
没有 sandbase_* 工具 | 新开会话或重启，再跑 doctor --client <id>。 |
| 浏览器授权一直停着 | Skill 给的下限是等 5 分钟。本机没有浏览器，就打开它打印的 URL。 |
| HTTP 402 | 接入文档说去充值。SKILL.md 拆成两种：花费上限要在密钥上调高，充值解决不了。余额不足才是充值。别空转重试。 |
| 401 或登录过期 | 再跑一次 connect。不要把旧密钥贴进对话里排错。 |
| 调用很慢 | 轮询 sandbase_run_get。再跑一次会再扣一笔。 |
| Node 太旧 | 按 Skill 说的，装 Node.js 20+ 然后停。 |
浏览器登录授权给编码工具的是 CLI Login 密钥。路径 C 和你自己的服务用的是 REST API 密钥。10 月那篇 Claude Code 实测里，CLI Login 密钥的范围是 mcp:invoke，当天对 REST 路由返回了 HTTP 403，bridge 版本是 v0.1.17。本文没有重测范围。读过那篇之前，不要把这把密钥填进应用的 SANDBASE_API_KEY。两把都不要进 git、shell 历史和聊天记录。
FAQ
怎么在 Claude Code、Cursor 或 Codex 里设置 SandBase 的 SKILL.md？
把这一行贴进那个 Agent 的对话：
set up https://www.sandbase.ai/SKILL.md它会读 Skill，检查 Node.js 20+，执行 npx -y @sandbaseai/cli@latest connect --client <your-client>，并请你在浏览器里授权一次。不要把 API 密钥贴进对话。它报告已配置之后，新开会话或重启 App，sandbase_* 才会加载。Agent 跑不了 shell，就自己在终端执行 connect。
怎么让 Claude Code、Cursor 和 Codex 用同一条 SandBase 连接调用数据接口？
Skill 或 CLI 接上之后，Agent 可以 sandbase_discover，用免费的 sandbase_inspect 看结构和价格，再用 sandbase_run 执行。同一余额覆盖语言模型、生图、生视频、语音，以及数据接口。符合条件的新账号可能拿到 AI 工具页说的 $1。符合条件的数据接口每个组织每天共享 100 次，inspect 会显示这一次算不算在里面。让它找一个 X 帖子搜索，先报价，再跑一小次。不带 --client 的 connect 会装上 CLI 认到的每一个客户端。
什么时候改用原始 SandBase MCP，而不是 Skill？
客户端不在 CLI 的自动配置范围内，或者 API 密钥本来就在客户端机密配置里，用 https://api.sandbase.ai/v1/mcp，以 Bearer 传递 SandBase API 密钥。不要进对话，不要进提交的文件。Claude Code、Cursor、Codex 优先走 Skill 或 npx -y @sandbaseai/cli@latest connect：浏览器创建凭证，并且只写 SandBase 拥有的配置。用 doctor --client <id> 加客户端里的一次安全调用来确认。
AI 工具页 是这三条路的短版。接入文档 是命令说明。Claude Code 的通过率留在 10 月那篇实测里，不能当成 Cursor 或 Codex 的承诺。