Перейти к основному содержанию
MCP (Model Context Protocol) — открытый стандарт, который позволяет AI-агентам взаимодействовать с внешними сервисами через структурированные инструменты. MCP-сервер Polza.AI даёт вашему агенту доступ к управлению аккаунтом: баланс, API-ключи, организации, история генераций и другое.
MCP-сервер работает в режиме бета-тестирования. Возможны изменения в API и ограничениях.

​
Требования

  • Аккаунт Polza.AI с пополненным балансом
  • AI-агент с поддержкой MCP (Claude Code, Cursor, Cline, Windsurf и др.)

​
Создание токена

1

Откройте раздел MCP

Перейдите в polza.ai/dashboard/mcp и нажмите «Создать токен».
2

Настройте токен

Укажите название (например, «Claude Code» или «Cursor») и выберите нужные разрешения. Для быстрого старта используйте пресет «Только чтение» или «Разработчик».
3

Скопируйте токен

После создания скопируйте токен и сохраните его в надёжном месте. Он отображается только один раз.
Токен даёт AI-агенту доступ к вашему аккаунту в рамках выбранных разрешений. Не передавайте его третьим лицам и не добавляйте в публичные репозитории.

​
Подключение к Claude Code

1

Добавьте MCP-сервер

Выполните команду в терминале:
claude mcp add --transport http polza-ai https://polza.ai/api/mcp \
  --header "Authorization: Bearer <ваш-токен>"
Замените <ваш-токен> на токен из предыдущего шага.
2

Проверьте подключение

Запустите Claude Code и попросите агента проверить ваш баланс или список организаций. Если MCP-сервер подключён корректно, агент получит данные из вашего аккаунта.

​
Подключение к Cursor

1

Создайте конфигурацию

В корне проекта создайте файл .cursor/mcp.json:
{
  "mcpServers": {
    "polza-ai": {
      "type": "http",
      "url": "https://polza.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш-токен>"
      }
    }
  }
}
2

Перезапустите Cursor

После сохранения файла перезапустите Cursor. MCP-сервер появится в списке доступных инструментов.
Добавьте .cursor/mcp.json в .gitignore, чтобы токен не попал в репозиторий.

​
Подключение к другим клиентам

Для любого MCP-клиента с поддержкой HTTP-транспорта используйте:
ПараметрЗначение
URLhttps://polza.ai/api/mcp
ТранспортHTTP (Streamable HTTP)
АвторизацияAuthorization: Bearer <ваш-токен>

​
Доступные инструменты

После подключения AI-агент получает доступ к инструментам в зависимости от выбранных разрешений.
ГруппаИнструментыОписание
Профильget_profile, get_balance, list_organizations, switch_organizationИнформация об аккаунте, баланс, переключение организации
Организацииget_organization, list_org_members, create_organization, invite_member и др.Управление организациями и участниками
API-ключиlist_api_keys, create_api_key, update_api_key, delete_api_keyСоздание и управление ключами
Биллингget_balance_details, get_transaction_history, create_topup_linkБаланс, транзакции, пополнение
Историяlist_generations, get_generationМетаданные генераций (без промптов)
ПодсказкиСистемные промптыКонтекстные подсказки для агента

​
Разрешения (Scopes)

Каждый токен имеет набор разрешений, определяющих какие инструменты доступны агенту. Разрешения следуют формату ресурс.уровень:
СкоупУровеньОписание
profile.readЧтениеEmail, ID, список организаций, баланс
profile.writeЗаписьПереключение активной организации
orgs.readЧтениеПросмотр организаций и участников
orgs.writeЗаписьСоздание организаций, приглашение участников
orgs.dangerОпасныеУдаление организаций и участников
keys.readЧтениеСписок API-ключей
keys.writeЗаписьСоздание и обновление ключей
keys.dangerОпасныеБезвозвратное удаление ключей
billing.readЧтениеБаланс и история транзакций
billing.writeЗаписьСоздание ссылки на пополнение
billing.dangerОпасныеСписание с карты без подтверждения
history.readЧтениеМетаданные генераций

​
Пресеты

Для удобства при создании токена доступны готовые наборы:
ПресетСкоупы
Только чтениеprofile.read, orgs.read, keys.read, billing.read, history.read
РазработчикЧтение + keys.write, billing.write
Полный (без опасных)Все скоупы кроме *.danger
Скоупы уровня «Опасные» (*.danger) дают агенту возможность выполнять необратимые действия: удаление ключей, организаций, списание средств. Включайте их только если вы уверены в необходимости.

​
Управление токенами

  • Просмотр — все активные токены отображаются на странице MCP с датой создания и последнего использования
  • Отзыв — нажмите «Отозвать» рядом с токеном. Действие необратимо — агент немедленно потеряет доступ
  • Срок действия — при создании можно указать дату истечения. После неё токен перестанет работать автоматически

​
Решение проблем

  • Убедитесь что токен скопирован полностью, без лишних пробелов
  • Проверьте что токен не был отозван на странице MCP
  • Если указан срок действия — убедитесь что токен не истёк
  • Проверьте что у токена есть соответствующий скоуп. Например, для list_api_keys нужен скоуп keys.read
  • Создайте новый токен с нужными разрешениями
  • Операции записи ограничены 60 запросами в минуту
  • Опасные операции ограничены 5 запросами за 10 минут
  • Подождите и повторите запрос
  • Убедитесь что используете URL https://polza.ai/api/mcp
  • Проверьте что заголовок авторизации передаётся в формате Authorization: Bearer <токен>
  • Убедитесь что ваш клиент поддерживает HTTP-транспорт (Streamable HTTP)

​
Следующие шаги

Claude Code

Настройте Claude Code для работы через Polza.AI

Начало работы

Создайте API-ключ и пополните баланс