一步一步连接 AI 助手或你自己的程序

1. 你要设置的是什么

通往同一份数据的两扇门，一把密钥两扇都能打开。

1. AI 助手之门（MCP）

   MCP 就像一个插头，让 Claude 或 ChatGPT 这样的助手在你聊天时调用我们的数据。你问“现在 BTC 的资金费率是多少”，助手就从我们这里取回答案。托管版本无需安装任何东西：只要把一个地址粘贴到助手的设置里。

2. 程序之门（API）

   API 是一个地址，你自己的脚本、表格或机器人调用它，拿回 JSON 格式的数字。你发出一个附带密钥的请求，我们返回数据。

3. 密钥

   密钥是一串以 bk_ 开头的长密码，告诉我们是哪个账户在请求。免费账户带一个密钥和每月 15,000 次调用，AI 助手之门和程序之门共用这个额度。密钥只在创建时显示一次，请像密码一样保管。

2. 创建你的密钥（两分钟）

1. 登录或创建免费账户

   点击右上角的“登录”按钮。新账户只需要一个邮箱地址：我们发给你一个链接，你点一下，就完成了。

2. 打开 Data & API（数据与 API）

   登录后，打开右上角的账户菜单，选择 Data & API（数据与 API）。在手机上，它在“我的”标签下。

3. 创建密钥

   向下滚动到 Keys（密钥）部分。输入一个能说明密钥用在哪里的名字，例如“我的笔记本”或“ChatGPT”，然后点击 Create（创建密钥）。

   密钥只出现一次，显示在一个带 Copy（复制）按钮的框里。马上复制，粘贴到安全的地方。如果没复制就关掉了页面，也没有任何损失：吊销那个密钥，再创建一个。

   密钥下方还有一个现成的托管 MCP 地址，密钥已经包含在里面。这个地址是给不能添加请求头的工具（ChatGPT）用的。请像密钥一样保密。

3. claude.ai（网页版和手机版）

托管服务器，无需安装任何东西。

1. 添加连接器

   依次打开 Settings、Connectors、Add custom connector（添加自定义连接器）。

   Name（名称）：ByKaranteli。URL：https://mcp.bykaranteli.com。

   在 Authentication（认证）下选择 No sign-in（claude.ai 可能会标注 "Detected"）。不要选 "Sign in now" 或 "Sign in when needed"，OAuth Client ID 和 Client Secret 都留空。

   打开请求头设置（有时在 Advanced 下面）。添加一个请求头：名称填 x-api-key，值填你的密钥。保存。

   请求头复制

   x-api-key: bk_...your key...

2. 试一试

   开始一个对话，确认这个对话里 ByKaranteli 连接器已经打开，然后问：“给我看 BTC 的强平地图。”助手会列出我们的工具并调用它们。

4. ChatGPT

ChatGPT 不能添加请求头，所以密钥放在地址里一起发送。

1. 添加连接器

   依次打开 Settings、Connectors（有些账户在 Developer mode 下面）、Create。

   Name（名称）：ByKaranteli。URL：带有你密钥的地址，从 Data & API（数据与 API）复制。它看起来像下面这一行。

   Authentication（认证）：none（无）。保存。

   URL复制

   https://mcp.bykaranteli.com/?key=bk_...your key...

   这个地址和密码一样重要。如果你把它贴到了公开的地方，请在 Data & API（数据与 API）吊销这个密钥，再创建一个新的。

5. Claude Desktop

Claude Desktop 会在你的电脑上运行一个小程序 bykaranteli-mcp。电脑上需要先安装 Node.js（nodejs.org，下载 LTS 版本）。

1. 编辑配置文件

   在 Claude Desktop 中依次打开 Settings、Developer、Edit config。会打开一个名为 claude_desktop_config.json 的文件。

   把下面这段粘贴进去（如果文件里已经有 "mcpServers" 部分，就把 "bykaranteli" 这一项加到它里面）。把 bk_... 换成你的密钥。保存，然后重启 Claude Desktop。

   claude_desktop_config.json复制

   {
     "mcpServers": {
       "bykaranteli": {
         "command": "npx",
         "args": ["-y", "bykaranteli-mcp"],
         "env": { "BYKARANTELI_API_KEY": "bk_...your key..." }
       }
     }
   }

6. Claude Code 和 Cursor

1. Claude Code（终端）

   只需一条命令。把 bk_... 换成你的密钥。

   终端复制

   claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_...your key... -- npx -y bykaranteli-mcp

2. Cursor 和其他编辑器

   打开编辑器的 MCP 设置（Cursor：依次打开 Settings、MCP、Add），把下面这段粘贴到 mcp.json。任何接受 URL 加请求头的编辑器都是同样的做法。

   mcp.json复制

   {
     "mcpServers": {
       "bykaranteli": {
         "url": "https://mcp.bykaranteli.com/mcp",
         "headers": { "Authorization": "Bearer bk_...your key..." }
       }
     }
   }

7. 从程序调用 API

不用助手，只用你自己的代码或表格。

1. 不写代码，先试一次

   Data & API（数据与 API）页面有一个调试台（Playground）：选一个端点，点击“发送”，查看返回的 JSON。它使用你浏览器的登录状态，所以什么都不用粘贴。

2. 在终端里做同样的调用

   /api/public/ 下的每个地址都返回 JSON。把密钥放在请求头里。把 bk_... 换成你的密钥。

   curl复制

   curl -s "https://bykaranteli.com/api/public/funding-heatmap" -H "Authorization: Bearer bk_...your key..."

3. 看懂响应头

   x-ratelimit-limit 和 x-ratelimit-remaining：你的方案每分钟允许多少次调用，这一分钟还剩多少次。

   x-quota-limit、x-quota-used 和 x-quota-reset：你的月度额度、已经用了多少、什么时候重置。

   所有端点、字段和示例的完整列表在开发者页面。

8. 用大白话讲额度

1. 免费账户

   每分钟 30 次、每月 15,000 次调用，AI 助手之门和程序之门合并计算。当月额度用完后，调用会返回 429（“请求过多”），直到下个月第一天（UTC）。网站上的每个页面照常可用。

2. 如果你需要更多

   Terminal（每月 29 美元）把密钥提升到每分钟 60 次、每月 150,000 次，深度不变，并增加站内的会员工具。

   Builder（每月 49 美元）提供每分钟 300 次、每月 1,000,000 次（公平使用）、API 上的会员深度（LiqMap 全部时间周期、5 分钟序列），以及每月 1,000 次 x402 目录调用。Business 和 Scale 再增加商业许可、批量导出和实时数据流。

   付费方案永远不会被停用：超出公平使用额度后，会按免费速度继续应答，直到当月重置。

9. 出问题时怎么办

下面每条消息都是我们有意发出的，每条都有解决办法。

助手说 "this tool call needs an account key"（这次工具调用需要账户密钥）。

连接器里没有密钥。在 claude.ai 中添加 x-api-key 请求头；在 ChatGPT 中使用包含 ?key= 的地址；在 Claude Desktop 或 Claude Code 中检查 BYKARANTELI_API_KEY 的值。不带密钥可以列出工具，但不能调用工具。

"The account key this connection sent was not recognised"（无法识别此连接发送的账户密钥）。

复制密钥时少了一个字符或多了空格，或者密钥已被吊销。打开 Data & API（数据与 API），吊销它，创建一个新的，再粘贴一次。

claude.ai 要求填写 OAuth Client ID。

Authentication 选错了。编辑连接器，选择 No sign-in，两个 OAuth 字段都留空，把密钥放进 x-api-key 请求头。

ChatGPT 保存了连接器，但一直没有回应。

通常是认证方式不匹配：选择 none，并确认 URL 中包含 ?key= 和你完整的密钥。

我的脚本收到 401 "key required"。

请求里没有密钥。以 Authorization: Bearer bk_...（或 x-api-key: bk_...）的形式发送。在我们自己的页面上，浏览器不需要密钥；程序始终需要。

429 "monthly quota"（月度配额）。

本月免费的 15,000 次调用已经用完。等到下个月 1 日，或者在价格页面升级到 Terminal 或 Builder。

429 "rate limit"（速率限制）。

一分钟内的调用太多。把速度降到 x-ratelimit-limit 给出的数字以内，或者等待 retry-after 给出的秒数。

我的密钥丢了。

密钥不能显示第二次。在 Data & API（数据与 API）吊销旧密钥，再创建一个新的；旧密钥会立即失效。

本页用到的词

API

程序调用来取回数据的地址，这里返回的是 JSON 文本。

API 密钥

以 bk_ 开头的长密码，每次调用时用来识别你的账户。

MCP

Model Context Protocol（模型上下文协议），让 AI 助手调用外部工具（比如我们的工具）的插头。

连接器（Connector）

claude.ai 和 ChatGPT 对你添加到账户里的 MCP 服务器的叫法。

请求头（Header）

随请求一起发送的小标签；密钥就放在其中一个里。

速率限制

一个方案每分钟允许多少次调用。

配额

一个方案每月允许多少次调用。