Как подключить ключ

Один ключ sk-ais-… открывает модели и MCP. Ключ создаётся в кабинете и показывается один раз. Баланс в бете начисляем по запросу — напишите в t.me/aishlyuz, укажите email аккаунта. Картой пока не пополняем.

Адрес моделей: https://aishlyuz.ru/v1. Адрес MCP: https://aishlyuz.ru/mcp. Список моделей — только из GET /v1/models, id не угадывайте.

curl

Так проверяют ключ, баланс и расход. ais-test-1 — служебная модель: отвечает заглушкой и не вызывает платную модель. Нужен ненулевой баланс.

Список моделей
curl https://aishlyuz.ru/v1/models \
  -H "Authorization: Bearer sk-ais-…"
Проверка связки
curl https://aishlyuz.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-ais-…" \
  -H "content-type: application/json" \
  -d '{"model":"ais-test-1","messages":[{"role":"user","content":"ping"}]}'
Баланс
curl https://aishlyuz.ru/api/account/balance \
  -H "Authorization: Bearer sk-ais-…"
История расходов
curl https://aishlyuz.ru/api/account/usage \
  -H "Authorization: Bearer sk-ais-…"

401 — ключ неверный или отозван. 402 — на балансе нет денег, запрос к модели не уходит. Текст ошибки: «Недостаточно средств». 404 — такой модели нет в списке.

Claude Code

В ~/.zshrc, ~/.bashrc или в env файла ~/.claude/settings.json. Адрес без /v1: клиент сам добавит /v1/messages. Для Claude Code берите только модели claude-*.

Переменные окружения
export ANTHROPIC_BASE_URL=https://aishlyuz.ru
export ANTHROPIC_AUTH_TOKEN=sk-ais-…
export ANTHROPIC_MODEL=claude-sonnet-5-5

После правки перезапустите claude.

Codex

Общий файл ~/.codex/config.toml. Строки model и model_provider — в самый верх, до первой таблицы. Блок провайдера — в конец. Ключ лежит в переменной AISHLYUZ_API_KEY, не в файле.

~/.codex/config.toml
model = "gpt-5-3-codex"
model_provider = "aishlyuz"

[model_providers.aishlyuz]
name = "AIShlyuz"
base_url = "https://aishlyuz.ru/v1"
env_key = "AISHLYUZ_API_KEY"
wire_api = "responses"

Для проверки можно временно поставить model = "ais-test-1" и запустить codex exec "ping".

Cursor

Cursor Settings → Models → API Keys. В поле OpenAI API Key вставьте ключ sk-ais-…, включите Override OpenAI Base URL и укажите https://aishlyuz.ru/v1. Модель добавьте по id из /v1/models.

MCP тем же ключом

Отдельный ключ не нужен. Заголовок строго Authorization: Bearer sk-ais-… — ключ от своей модели сюда не подходит. Общие инструменты: цены и аптайм шлюзов, каталог MCP, погода, котировка Мосбиржи, веб-поиск, курс ЦБ, законодательство РФ, время, дизайн-система, документация библиотек и репозиториев. Имя в вызове: сервер-инструмент, например time-get_current_time.

Проверка
curl https://aishlyuz.ru/mcp \
  -H "Authorization: Bearer sk-ais-…" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"check","version":"1"}}}'
Вызов инструмента
curl https://aishlyuz.ru/mcp \
  -H "Authorization: Bearer sk-ais-…" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"time-get_current_time","arguments":{"timezone":"Europe/Moscow"}}}'

Список инструментов открывается без денег. Успешный вызов списывает 0,10 ₽ один раз и появляется в операциях кабинета. Пока на балансе меньше этой суммы, вызов отвечает insufficient_balance. 401 — ключ не sk-ais- или он отозван.

Свои аккаунты

В кабинете подключаются GitHub, Яндекс (Диск и Метрика), Notion, Telegram-бот, DaData, Битрикс24 (входящий вебхук) и amoCRM. Если у сервиса настроен вход через OAuth, в карточке есть кнопка. Иначе вставьте свой токен или URL вебхука: он проверяется запросом к сервису, сохраняется зашифрованным и больше не показывается.

Инструменты подключённого аккаунта появляются в tools/list только у ключей этого пользователя. Примеры имён: github-me, github-list_repos, yandex-disk_list, yandex-metrika_counters, notion-search, telegram-send_message, dadata-suggest_party, bitrix-list_deals, amo-list_leads.

GitHub от вашего имени
curl https://aishlyuz.ru/mcp \
  -H "Authorization: Bearer sk-ais-…" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"github-me","arguments":{}}}'
Claude Code
claude mcp add --transport http aishlyuz https://aishlyuz.ru/mcp --header "Authorization: Bearer $AISHLYUZ_API_KEY"
Codex
codex mcp add aishlyuz --url https://aishlyuz.ru/mcp --bearer-token-env-var AISHLYUZ_API_KEY
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "aishlyuz": {
      "url": "https://aishlyuz.ru/mcp",
      "headers": { "Authorization": "Bearer ${env:AISHLYUZ_API_KEY}" }
    }
  }
}

В ответе 200 и поле result — адрес живой. Каталог чужих серверов — отдельно, на странице инструментов.

Для агента те же шаги лежат в agent.md. Данные мониторинга шлюзов — в документации API.