Реселер API та MCP (white-label)

Типовий флоу

Створіть тариф, додайте клієнта, замовте йому VM; видайте доступ від свого бренду.

// Reseller token (rk_...) from the Partners cabinet -> Authorization: Bearer rk_...
// One MCP endpoint, role-filtered: a reseller token exposes the 30 reseller_* tools.
reseller_create_plan({ name, cores, ram_gb, disk_gb, ipv4, ipv6, locations, markup_price })   // ipv4 0-4, ipv6 0-1, at least one
reseller_add_client({ email }) -> { client_id }
reseller_order_for_client({ plan_id, client_id, os_id? })   // os_id: see list_plans catalog
reseller_vm_details({ service_id }) -> { access, password }  // deliver to your client

os_id необов'язковий — без нього ставиться дефолтна ОС локації. Для конкретної ОС беріть os_id із публічного каталогу list_plans; він резолвиться в потрібний образ за локацією.

Операційні системи та os_id

Доступно 14 Linux-образів (нижче). Передавайте os_id у reseller_order_for_client — беріть його з публічного каталогу list_plans. Важливо: available_os може показувати різні id за локаціями; os_id із list_plans резолвиться в правильний образ для локації тарифу. Без os_id ставиться ОС локації за замовчуванням.

Статуси VM

active — працює. provisioning — створюється (коротке async-вікно одразу після замовлення). suspended — призупинена (напр. ви призупинили клієнта або неоплата); повернути через reseller_unsuspend_client. cancelled — видалена (VM знищена).

Підключіть будь-якого агента чи інструмент

Один MCP-ендпоінт — mcp.eqvps.com/mcp — з авторизацією за вашим reseller-токеном. Підключіть до того, чим уже користуєтесь.

# Claude Code - add the reseller MCP server (token: Partners cabinet -> API)
claude mcp add --transport http eqvps-reseller https://mcp.eqvps.com/mcp \
  --header "Authorization: Bearer rk_YOUR_RESELLER_TOKEN"

// Claude Desktop / Cursor / Windsurf - mcp.json
{
  "mcpServers": {
    "eqvps-reseller": {
      "type": "http",
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer rk_YOUR_RESELLER_TOKEN" }
    }
  }
}

# LangChain / LangGraph (Python) - langchain-mcp-adapters
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"eqvps": {"transport": "streamable_http",
  "url": "https://mcp.eqvps.com/mcp",
  "headers": {"Authorization": "Bearer rk_YOUR_RESELLER_TOKEN"}}})
tools = await client.get_tools()   # 30 reseller_* tools

# Raw MCP (JSON-RPC) - n8n HTTP, Zapier/Make, cURL, any language
curl -X POST https://mcp.eqvps.com/mcp \
  -H "Authorization: Bearer rk_YOUR_RESELLER_TOKEN" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"reseller_order_for_client","arguments":{"client_id":123,"plan_id":45}}}'
# List tools first: {"jsonrpc":"2.0","id":1,"method":"tools/list"}

Готові промти для агентів

Авто-продовження

Сервери клієнтів продовжуються без ручної роботи. reseller_set_autorenew вмикає/вимикає це для VM (за замовчуванням УВІМК); щоденна задача продовжує все, що спливає найближчі 3 дні, з опт-балансу. Продовжити на N періодів зараз — reseller_renew (months 1-24). За нестачі — одне сповіщення та штатний grace-період, ніколи не тиха втрата.

Тестування в пісочниці (dry-run)

Передайте test: true у reseller_order_for_client (або POST /api/reseller/orders з {"test":true}) для dry-run: повернеться mock-відповідь зі структурою, ідентичною реальному замовленню, але VM не створюється і баланс не списується. Перевірте свою API/MCP-інтеграцію повністю перед запуском.

Email-сповіщення клієнтам

За замовчуванням EQVPS надсилає листи на акаунт при провіжні/паузі/термінації/зміні пароля/reinstall. У reseller-кабінеті можна вимкнути «Надсилати мені сповіщення», щоб сповіщати клієнтів самостійно (white-label) — провіжн і продовження працюють, просто без листів.