MCP облака

Что можно спросить

• «Какие кассы сейчас не на связи и давно ли?»
• «Где скоро закончится ФН? Отсортируй по дням.»
• «Что случилось на кассе в фойе за сегодня?»
• «Сколько чеков пробила каждая точка в этом месяце?»
• «Сделай X-отчёт на кассе 42» — помощник вызовет call_agent, клиент попросит подтверждение.

Подключение

Достаточно адреса https://cloud.hw-connector.ru/mcp: клиент сам откроет вход в кабинет hw-connector.ru (OAuth 2.1), вы выберете права — только чтение или полный доступ (команды кассам, чеки) — и разрешите. Отключить приложение — кабинет → «Облако» → «Подключённые приложения». Клиентам без входа OAuth — ключ API аккаунта hwk_… в заголовке (лучше «только чтение»).

claude.ai и Claude Desktop

Настройки → Коннекторы → «Добавить свой коннектор» → адрес https://cloud.hw-connector.ru/mcp → «Подключить»: откроется вход в кабинет. Одинаково в браузере и в Claude Desktop.

Старый способ для Claude Desktop — мост mcp-remote с ключом в claude_desktop_config.json:

{
  "mcpServers": {
    "hw-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cloud.hw-connector.ru/mcp",
        "--header",
        "Authorization: Bearer hwk_…"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http hw-cloud https://cloud.hw-connector.ru/mcp
# затем в Claude Code: /mcp → hw-cloud → Authenticate (вход в кабинете)

# или ключом API, без входа:
claude mcp add --transport http hw-cloud https://cloud.hw-connector.ru/mcp --header "Authorization: Bearer hwk_…"

Cursor

Адрес без ключа — Cursor предложит войти; с ключом — добавьте "headers": {"Authorization": "Bearer hwk_…"}.

{
  "mcpServers": {
    "hw-cloud": {
      "url": "https://cloud.hw-connector.ru/mcp"
    }
  }
}

VS Code

{
  "servers": {
    "hw-cloud": {
      "type": "http",
      "url": "https://cloud.hw-connector.ru/mcp",
      "headers": {
        "Authorization": "Bearer hwk_…"
      }
    }
  }
}

Другие клиенты и проверка

Любой MCP-клиент со Streamable HTTP: с входом OAuth 2.1 (метаданные — https://cloud.hw-connector.ru/.well-known/oauth-authorization-server, регистрация клиента сама — RFC 7591, PKCE S256) или с заголовком ключа (можно и X-Api-Key). Сервер без состояния: POST с JSON-RPC, ответ — JSON. Проверка без клиента:

curl https://cloud.hw-connector.ru/mcp -H 'Authorization: Bearer hwk_…' -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_summary","arguments":{}}}'

Инструменты

Тонкие обёртки над API облака: те же проверки аккаунта, ошибки и журнал. Чтение помечено readOnlyHint; call_agent и create_receipt — destructiveHint: клиент спросит подтверждение. Ошибка — результат с isError: true и кодом облака (DEVICE_NOT_FOUND, NOT_CONNECTED, DEVICE_DISABLED…).

Промпты

• check_fleet — Проверить парк касс: Сводка, тревоги и что требует внимания — без операций на кассах

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

• Права «только чтение» (вход или ключ) — помощнику видны только инструменты чтения: call_agent, create_receipt и update_device недоступны (KEY_READ_ONLY). Для наблюдения за парком этого достаточно.
• Полный доступ — ко всем кассам аккаунта. call_agent и create_receipt выполняют настоящие операции: печать, фискальный чек, оплата на терминале. Не включайте в клиенте автоподтверждение этих инструментов.
• Настройку устройств (/api/v1/setup) облако не передаёт. Кассу можно выключить (update_device / PATCH /api/v1/devices/{id}) — помощник и интеграции не смогут ей ничего отправить; на самой кассе команды из облака выключаются в настройках агента.
• Каждый запрос к агентам — в журнале (list_requests, GET /api/v1/requests). Лимит — 600 вызовов в минуту на аккаунт. Ключ отзывается, приложение отключается в кабинете сразу.
• Вход OAuth: токен доступа живёт час, токен обновления — 30 дней и меняется при каждом обновлении; повтор старого токена или кода отключает приложение. В облаке хранятся только хеши токенов.