API / Начало работы / AI-ассистенты (MCP)

AI-ассистенты (MCP)

sourhost можно подключить к AI-ассистенту через MCP — открытый стандарт, по которому ассистенты работают с внешними сервисами. После подключения можно писать обычным текстом: «почему лагает сервер?», «поставь de_dust2 и 24 слота», «каждую ночь в 5 утра рестарт», «продли всё на месяц».

Что умеет ассистент

  • Смотреть проекты, серверы, статус и нагрузку, баланс, тарифы и цены.
  • Запускать, останавливать и перезапускать серверы.
  • Отправлять команды в консоль и читать её последние строки.
  • Показывать карту, онлайн и список игроков.
  • Читать и править файлы сервера, например server.cfg.
  • Менять параметры запуска и порт, переустанавливать сервер.
  • Создавать задачи по расписанию и бэкапы, восстанавливать их.
  • Выдавать доступ к серверу и показывать данные SFTP.
  • Продлевать и арендовать серверы, менять тариф, давать ссылку на пополнение.
  • Смотреть FastDL и сжимать его файлы.
  • Писать в поддержку и отвечать в тикетах.

Ассистент работает с правами вашего API-токена и не может больше, чем разрешает токен.

Шаг 1. Токен

Откройте меню аккаунта → «Настройки» → «API-токены» и нажмите «Подключить к AI». Откроется форма с уже отмеченными правами для работы с серверами. Траты с баланса по умолчанию выключены: если хотите, чтобы ассистент мог продлевать и арендовать, отметьте billing:spend и задайте лимит.

После создания окно покажет токен и готовые строки подключения. Скопируйте их сразу — токен больше не покажется.

Токен для AI-ассистента создан

  1. Сам токен.
  2. Команда для Claude Code.
  3. Настройки для Cursor и других клиентов MCP.
  4. Ссылки на skill sourhost и инструкцию.

Шаг 2. Подключение

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

curl
claude mcp add --transport http sourhost https://sourhost.net/mcp --header "Authorization: Bearer sh_live_ваш_токен"

Cursor и другие клиенты с настройками MCP. Добавьте в их файл настроек MCP (у Cursor это ~/.cursor/mcp.json):

JSON
{
  "mcpServers": {
    "sourhost": {
      "url": "https://sourhost.net/mcp",
      "headers": { "Authorization": "Bearer sh_live_ваш_токен" }
    }
  }
}

Claude Desktop и клиенты без настройки заголовков. Подключите через переходник mcp-remote (нужен Node.js):

JSON
{
  "mcpServers": {
    "sourhost": {
      "command": "npx",
      "args": ["mcp-remote", "https://sourhost.net/mcp", "--header", "Authorization:Bearer sh_live_ваш_токен"]
    }
  }
}

Подключение к claude.ai и ChatGPT в браузере в один клик, без копирования токена, появится позже.

Шаг 3. Skill (рекомендуем)

Skill — это инструкция для ассистента: как диагностировать лаги, где лежат конфиги CS2, что делать с ошибками, когда переспрашивать перед тратами. С ним ответы заметно точнее.

  • Приложения Claude: скачайте skill и загрузите архив в настройках Claude, в разделе навыков (Skills).
  • Claude Code: распакуйте архив в ~/.claude/skills/ — должна получиться папка ~/.claude/skills/sourhost.

Полный плагин для Claude Code (skill и подключение вместе) — sourhost-plugin.zip; токен он берёт из переменной окружения SOURHOST_API_TOKEN.

Безопасность

  • Траты только с вашего «да». Перед любой покупкой ассистент сначала получает расчёт и называет сумму. Списание происходит только после подтверждения и только в пределах лимита токена.
  • Опасные действия с подтверждением. Переустановка, восстановление бэкапа и удаление файлов или бэкапов требуют явного подтверждения.
  • Защита от подмены команд. Текст консоли, файлов и ников игроков ассистент считает данными, а не командами.
  • Журнал событий. Все действия попадают в журнал с пометкой «API-токен «имя»».
  • Отключение. Отзовите токен в «Настройки → API-токены» — доступ пропадёт сразу.