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

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

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

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

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

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

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

3. Ключ

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

2. Создайте ключ (две минуты)

Если вы входите через claude.ai, ChatGPT или Claude Code (разделы 3, 4 и 6), этот шаг можно пропустить. Ключ нужен для Claude Desktop, Cursor, ваших программ и коннекторов, настроенных без входа.

1. Войдите или создайте бесплатный аккаунт

   Нажмите кнопку «Войти» в правом верхнем углу. Для нового аккаунта нужен только адрес электронной почты: мы присылаем ссылку, вы нажимаете на нее, готово.

2. Откройте Data & API («Данные и API»)

   После входа откройте меню аккаунта (справа вверху) и выберите Data & API («Данные и API»). На телефоне этот раздел находится на вкладке «Мое».

3. Создайте ключ

   Прокрутите до раздела Keys («Ключи»). Введите название, по которому будет понятно, где будет работать ключ, например "мой ноутбук" или "ChatGPT", и нажмите Create («Создать ключ»).

   Ключ появится один раз, в поле с кнопкой Copy («Копировать»). Скопируйте его сразу и сохраните в надежном месте. Если вы закрыли страницу, не скопировав ключ, ничего не потеряно: отзовите этот ключ и создайте новый.

   Под ключом вы также получите готовый адрес размещенного MCP, в который ключ уже встроен. Этот адрес нужен инструментам, которые не умеют ни входить в аккаунт, ни передавать заголовок. Храните его в тайне, как и сам ключ.

3. claude.ai (веб и мобильное приложение)

Сервер размещен у нас: ничего не нужно устанавливать и копировать. Вы входите один раз.

1. Добавьте коннектор

   Откройте Settings, затем Connectors, затем Add custom connector (добавить свой коннектор).

   Name (название): ByKaranteli. URL: https://mcp.bykaranteli.com.

   В разделе Authentication выберите Sign in (now или when needed). Поля OAuth Client ID и Client Secret оставьте пустыми: claude.ai сам регистрируется на bykaranteli.com. Сохраните.

2. Войдите и подтвердите

   Нажмите Connect, если claude.ai не открыл окно сам. Откроется окно bykaranteli.com: войдите или создайте там бесплатный аккаунт.

   На странице согласия указан claude.ai и то, что ему разрешено: пользоваться инструментами данных, читать и изменять ваши оповещения, список наблюдения и отслеживаемые адреса, но никогда не ваш аккаунт, ключи или оплату. Нажмите Allow.

   Вы вернетесь в claude.ai, и коннектор будет подключен. Он работает от вашего аккаунта и по вашему тарифу. Отключить его можно в разделе «Подключённые приложения» на странице Data & API («Данные и API») или удалив коннектор в claude.ai.

3. Или с ключом

   В разделе Authentication выберите No sign-in, откройте заголовки запроса (иногда они в разделе Advanced) и добавьте один заголовок: в поле имени x-api-key, в поле значения ключ из раздела 2. Сохраните.

   ЗаголовокКопировать

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

4. Проверьте

   Начните чат, убедитесь, что коннектор ByKaranteli включен для этого чата, и спросите: "Покажи карту ликвидаций для BTC." Ассистент увидит список наших инструментов и вызовет их.

4. ChatGPT

Два способа: вход через OAuth (ничего копировать не нужно) или ключ внутри адреса.

1. Добавьте коннектор со входом

   Откройте Settings, затем Connectors (в некоторых аккаунтах это раздел Developer mode), затем Create.

   Name (название): ByKaranteli. URL: https://mcp.bykaranteli.com.

   Authentication: OAuth. Поля client ID и secret оставьте пустыми: ChatGPT сам регистрируется на bykaranteli.com. Сохраните, войдите в окне bykaranteli.com и нажмите Allow на странице согласия.

2. Или с ключом в адресе

   Authentication: none (без авторизации). URL: адрес с вашим ключом, скопированный на странице Data & API («Данные и API»). Он выглядит как строка ниже. Сохраните.

   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 (терминал)

   Размещенный сервер со входом: добавьте сервер первой командой, затем введите /mcp в Claude Code, выберите bykaranteli и Authenticate. Откроется окно браузера; войдите и нажмите Allow.

   Или запустите пакет на своем компьютере с ключом (нужен Node.js): вторая команда. Замените bk_... на свой ключ.

   Терминал, размещенный сервер со входомКопировать

   claude mcp add --transport http bykaranteli https://mcp.bykaranteli.com

   Терминал, локально с ключомКопировать

   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. Если нужно больше

   Бесплатный ключ предназначен для оценки и личного использования: знакомство с API, личный скрипт или Jupyter-ноутбук, просмотр данных. Всё, что работает непрерывно (бот, дашборд или агент, который опрашивает API), требует платного плана: Terminal для хобби-бота, Builder для инструментов одного человека с глубиной участника, Business для всего, что обслуживает других людей или приносит доход.

   Terminal, членство для людей (цена на странице тарифов), поднимает лимит ключа до 60 в минуту и 150 000 в месяц с той же глубиной и добавляет стол, который работает на нашей стороне, пока вас нет: оповещения, глубину для участников на панелях и рабочее пространство LiqMap.

   Builder (49 $ в месяц) дает 300 в минуту, 1 000 000 в месяц в рамках добросовестного использования, глубину для участников в API (LiqMap на всех таймфреймах, 5-минутные серии) и каталог x402: 1 000 вызовов в месяц за последние 90 дней, только сводные ряды (каждый вызов также считается за 10 запросов месячного добросовестного использования). Business и Scale добавляют коммерческие лицензии, сырые записи, более длинное окно истории, массовые выгрузки и поток данных в реальном времени.

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

9. Если что-то пошло не так

Каждое сообщение ниже мы отправляем намеренно, и для каждого есть решение.

Ассистент пишет "this tool call needs an account key" (для этого вызова инструмента нужен ключ аккаунта).

В коннекторе нет ключа, и вход не выполнен. claude.ai и Claude Code в этом случае показывают запрос на вход: следуйте ему (в Claude Code введите /mcp и выберите Authenticate). Иначе в claude.ai выберите Sign in в коннекторе или добавьте заголовок x-api-key; в ChatGPT выберите OAuth или используйте адрес с ?key=; в Claude Desktop проверьте значение BYKARANTELI_API_KEY. Список инструментов виден и без ключа, а вызвать инструмент без ключа нельзя.

"The account key this connection sent was not recognised" (ключ аккаунта, отправленный этим подключением, не распознан).

При копировании ключа потерялся символ или добавился пробел, либо ключ был отозван. Откройте Data & API («Данные и API»), отзовите ключ, создайте новый и вставьте его заново.

claude.ai просит OAuth Client ID.

В обоих случаях оба поля OAuth остаются пустыми. При Sign in claude.ai регистрируется сам, id вводить не нужно; при No sign-in ключ идёт в заголовке x-api-key.

ChatGPT сохранил коннектор, но не отвечает.

Обычно режим авторизации не совпадает с адресом: с OAuth используйте адрес без ключа и войдите; с none URL должен содержать ?key= и ваш ключ целиком.

Мой скрипт получает 401 "key required".

Запрос дошёл до шлюза без пригодного ключа: нет заголовка с ключом, значение пустое (переменная не задана), передан не полный ключ (заполнитель bk_... из примеров, префикс из списка ключей) или Authorization без схемы Bearer; поле reason в теле ответа 401 называет причину. Передайте полный ключ как 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») и создайте новый; старый сразу перестанет работать.

Может ли ассистент что-то изменить в моем аккаунте?

Только ваши оповещения, список наблюдения и отслеживаемые адреса, и только через инструменты create_alert_recipe, delete_alert_recipe, add_watchlist_symbol, remove_watchlist_symbol, add_tracked_address и remove_tracked_address. Они помечены как запись, поэтому ассистент, который подтверждает изменения, сначала спросит вас. Они используют тот же ключ, учитываются в вашем тарифе, а каждое изменение фиксируется в вашем аккаунте и сразу видно на страницах оповещений, списка наблюдения и отслеживаемых адресов. Никаких сделок и переводов средств. Чтобы это прекратить, отключите приложение в разделе «Подключённые приложения» на странице Data & API («Данные и API»), если оно вошло через OAuth, или отзовите там его ключ, если оно работает с ключом.

Слова, которые встречаются на этой странице

API

Адрес, к которому программа обращается за данными; здесь ответ приходит текстом в формате JSON.

API-ключ

Длинный пароль, начинающийся с bk_, по которому ваш аккаунт узнается при каждом вызове.

MCP

Model Context Protocol, разъем, через который AI-ассистент вызывает внешние инструменты, например наши.

Коннектор (Connector)

Так claude.ai и ChatGPT называют MCP-сервер, который вы добавили в свой аккаунт.

Заголовок (Header)

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

Вход (Sign in, OAuth)

Подключение ассистента к вашему аккаунту одним подтверждением на bykaranteli.com; ассистент получает собственный ключ, копировать ничего не нужно.

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

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

Квота (quota)

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