Автоматизация

API и MCP

Управляйте агентами Пуска из кода или прямо из Claude: платформенные ключи sk_live_…, HTTP-API /v1 и MCP-сервер для Claude Code и Claude Desktop.

Ключ API

Ключ выдаётся в кабинете: Аккаунт → API-ключи платформы → Создать. Ключ показывается один раз — скопируйте сразу. Потеряли или скомпрометировали — отзовите и создайте новый, старый перестанет работать мгновенно.

Ключ передаётся заголовком:

curl https://pusk.ai/v1/instances \
  -H "Authorization: Bearer sk_live_..."

Что умеет API

Метод	Путь	Что делает
GET	`/v1/instances`	Список ваших машин: статус, тариф, установленные агенты, ссылки на экраны
POST	`/v1/instances`	Создать агента — заявка (машина появится после обработки)
GET	`/v1/instances/{id}`	Детали машины
POST	`/v1/instances/{id}/actions`	Управление сервисами: `hermes`/`openclaw`/`chromium` × `start`/`stop`/`restart`/`status`
POST	`/v1/instances/{id}/signed-url`	Ссылка на экран: `terminal`, `browser` или `files`

Ошибки — в формате {error: {message, type}}; лимиты: 600 запросов/час на ключ (чтение), 20 созданий/час.

MCP: агенты прямо в Claude

MCP-сервер Пуска позволяет Claude увидеть ваши агенты, перезапустить сервис, выдать ссылку на терминал или подать заявку на новую машину — без открытия кабинета.

Claude Code (одна команда):

claude mcp add pusk --env PUSK_API_KEY=sk_live_... -- node /путь/к/pusk-mcp.mjs

Claude Desktop — в конфиг (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "pusk": {
      "command": "node",
      "args": ["/путь/к/pusk-mcp.mjs"],
      "env": { "PUSK_API_KEY": "sk_live_..." }
    }
  }
}

Файл сервера — mcp/pusk-mcp.mjs в репозитории Пуска: один файл без зависимостей, нужен только Node.js 18+. Инструменты, которые появятся у Claude:

list_agents — список машин со статусами и тарифами;
get_agent — детали конкретной машины;
create_agent — заявка на нового агента;
agent_action — запуск/перезапуск/статус Hermes, OpenClaw и браузера;
service_url — ссылка на терминал, браузер или файлы машины.

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

Ключ — это доступ к вашим машинам с правами управления. Не публикуйте его, храните в секретах (.env, менеджер паролей), для разных устройств заводите отдельные ключи — так проще отозвать утерянный, не трогая остальные. Все действия по API фиксируются в журнале операций машины (страница «Доступ и данные»).

НазадАккаунт и помощь