SOURHOST.NET
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-токени» — доступ зникне одразу.