Каналы

Сервис с веб-процессом открывается в web. Остальные каналы объявляются в разделе channels манифеста и появляются на карточке в каталоге.

channels:
  api: { docs: /docs }
  mcp:
    tools:
      - name: ask
        description: Ответ на вопрос по загруженным документам, со ссылкой на источник
        path: /api/ask
        input: { type: object, properties: { question: { type: string } }, required: [question] }

web

Веб-процесс сервиса отвечает на адресе имя.apps.loomafloat.ru и во фрейме на странице сервиса в каталоге. Клиент, который вошёл в каталог, приходит к сервису с заголовком X-Looma-Client: это псевдоним клиента, без почты и имени.

API

api: { docs: /путь } объявляет программный доступ. Клиент выпускает ключ looma_ck_… на странице сервиса и передаёт его в Authorization: Bearer. Шлюз площадки проверяет ключ, убирает его из запроса и добавляет X-Looma-Client. Путь в docs ведёт на описание API сервиса, ссылка на него появится в карточке.

Инструменты для ИИ-агентов (MCP)

mcp.tools описывает инструменты, до 20. Площадка собирает из них MCP-сервер по адресу https://api.loomafloat.ru/mcp/<имя>, клиенты подключаются к нему со своим ключом.

Поле	Что
`name`	имя инструмента
`description`	по описанию агент решает, звать ли инструмент; пишите конкретно, до 1000 знаков
`title`	подпись для людей, необязательно
`path`	путь сервиса: сюда приходит POST, тело запроса содержит аргументы в JSON
`input`	JSON Schema аргументов, `type: object`

Вызовы инструментов идут на prod и приходят с X-Looma-Client, как обычные запросы.

Только для клиентов

access: clients открывает сервис только клиентам, вошедшим в каталог, и программам с ключом клиента. Гость видит страницу входа, программа без ключа получает 401. На карточке будет написано «Доступ: после входа». По умолчанию access: public: сервис открыт всем.