Подключите AI-ассистента или свою программу: шаг за шагом

1. Что вы настраиваете

Две двери к одним и тем же данным, и один ключ открывает обе.

1. Дверь для AI-ассистента (MCP)

   MCP работает как разъем: через него ассистент, например Claude или ChatGPT, обращается к нашим данным прямо во время чата. Вы спрашиваете "какая сейчас ставка фандинга по BTC", и ассистент берет ответ у нас. Для размещенной у нас версии ничего устанавливать не нужно: вы вставляете один адрес в настройки ассистента.

2. Дверь для программ (API)

   API: адрес, к которому обращается ваш скрипт, таблица или бот, чтобы получить числа в формате JSON. Вы отправляете запрос с приложенным ключом, мы отправляем данные.

3. Ключ

   Ключ: длинный пароль, который начинается с bk_. По нему мы понимаем, какой аккаунт делает запрос. Бесплатный аккаунт получает один ключ и 15 000 вызовов в месяц, общих для двери ассистента и двери программ. Ключ показывается один раз, при создании; храните его как пароль.

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): выберите endpoint, нажмите «Отправить» и посмотрите на 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: ваш месячный лимит, сколько уже использовано и когда счетчик обнулится.

   Полный список endpoints, полей и примеров есть на странице для разработчиков.

8. Лимиты простыми словами

1. Бесплатный аккаунт

   30 вызовов в минуту и 15 000 в месяц, общий счет для двери ассистента и двери программ. Когда месячный лимит исчерпан, вызовы получают ответ 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 вызовов на этот месяц израсходованы. Дождитесь первого числа месяца или перейдите на 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)

Небольшая метка, которая отправляется вместе с запросом; ключ передается в одной из них.

Лимит частоты (rate limit)

Сколько вызовов в минуту разрешает план.

Квота (quota)

Сколько вызовов в месяц разрешает план.