MCP-сервер
Подключение AI-агентов к аккаунту usellm через Model Context Protocol
MCP-сервер
MCP (Model Context Protocol): открытый стандарт, который позволяет AI-агентам взаимодействовать с внешними сервисами через структурированные инструменты. MCP-сервер usellm даёт вашему агенту доступ к управлению аккаунтом: баланс, API-ключи, организации, история генераций и другое.
MCP-сервер работает в режиме бета-тестирования. Возможны изменения в API и ограничениях.
Требования
- Аккаунт usellm с пополненным балансом
- AI-агент с поддержкой MCP (Claude Code, Cursor, Cline, Windsurf и др.)
Создание токена
- Перейдите в usellm.ru/dashboard/mcp и нажмите «Создать токен».
- Укажите название (например, «Claude Code» или «Cursor») и выберите нужные разрешения. Для быстрого старта используйте пресет «Только чтение» или «Разработчик».
- После создания скопируйте токен и сохраните его в надёжном месте. Он отображается только один раз.
Токен даёт AI-агенту доступ к вашему аккаунту в пределах выбранных разрешений. Не передавайте его третьим лицам и не добавляйте в публичные репозитории.
Подключение к Claude Code
- Добавьте MCP-сервер: выполните команду в терминале:
claude mcp add --transport http usellm https://api.usellm.ru/mcp \
--header "Authorization: Bearer <ваш-токен>"
Замените <ваш-токен> на токен из предыдущего шага.
- Запустите Claude Code и попросите агента проверить ваш баланс или список организаций. Если MCP-сервер подключён корректно, агент получит данные из вашего аккаунта.
Подключение к Cursor
- В корне проекта создайте файл
.cursor/mcp.json:
{
"mcpServers": {
"usellm": {
"type": "http",
"url": "https://api.usellm.ru/mcp",
"headers": {
"Authorization": "Bearer <ваш-токен>"
}
}
}
}
- После сохранения файла перезапустите Cursor. MCP-сервер появится в списке доступных инструментов.
Добавьте .cursor/mcp.json в .gitignore, чтобы токен не попал в репозиторий.
Подключение к другим клиентам
Для любого MCP-клиента с поддержкой HTTP-транспорта используйте:
| Параметр | Значение |
|---|---|
| URL | https://api.usellm.ru/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 с датой создания и последнего использования
- Отзыв: нажмите «Отозвать» рядом с токеном. Действие необратимо: агент немедленно потеряет доступ
- Срок действия: при создании можно указать дату истечения. После неё токен перестанет работать автоматически