MCP-сервер

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

MCP-сервер работает в режиме бета-тестирования. Возможны изменения в API и ограничениях.

Требования

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

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

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

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

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

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

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

После создания скопируйте токен и сохраните его в надёжном месте. Он отображается только один раз.

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

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

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

Выполните команду в терминале:

claude mcp add --transport http polza-ai https://polza.ai/api/mcp \
  --header "Authorization: Bearer <ваш-токен>"

Замените <ваш-токен> на токен из предыдущего шага.

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

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

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

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

В корне проекта создайте файл .cursor/mcp.json:

{
  "mcpServers": {
    "polza-ai": {
      "type": "http",
      "url": "https://polza.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш-токен>"
      }
    }
  }
}

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

После сохранения файла перезапустите Cursor. MCP-сервер появится в списке доступных инструментов.

Добавьте .cursor/mcp.json в .gitignore, чтобы токен не попал в репозиторий.

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

Для любого MCP-клиента с поддержкой HTTP-транспорта используйте:

Параметр	Значение
URL	`https://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 с датой создания и последнего использования
Отзыв — нажмите «Отозвать» рядом с токеном. Действие необратимо — агент немедленно потеряет доступ
Срок действия — при создании можно указать дату истечения. После неё токен перестанет работать автоматически

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

Ошибка аутентификации (401)

Убедитесь что токен скопирован полностью, без лишних пробелов
Проверьте что токен не был отозван на странице MCP
Если указан срок действия — убедитесь что токен не истёк

Инструмент не найден (tool not available)

Проверьте что у токена есть соответствующий скоуп. Например, для list_api_keys нужен скоуп keys.read
Создайте новый токен с нужными разрешениями

Превышен лимит запросов (rate limit)

Операции записи ограничены 60 запросами в минуту
Опасные операции ограничены 5 запросами за 10 минут
Подождите и повторите запрос

MCP-сервер не подключается

Убедитесь что используете URL https://polza.ai/api/mcp
Проверьте что заголовок авторизации передаётся в формате Authorization: Bearer <токен>
Убедитесь что ваш клиент поддерживает HTTP-транспорт (Streamable HTTP)

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

Продвинутое

Генерация медиа

Интеграции

Требования

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

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

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

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

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

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

Пресеты

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

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

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

Claude Code

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

​Требования

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

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

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

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

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

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

​Пресеты

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

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

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

Claude Code

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

Требования

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

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

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

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

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

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

Пресеты

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

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

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