Что агент делает в YCLIENTS
Сервер greenrun666 и сервер gjrprdhvnh похожи. Каждый дает больше 30 инструментов по разделам API, от компаний и услуг до расписания и аналитики, и запускается по stdio локально или как HTTP-сервис. Связка с Ozon шире. Ее собрали из официальной OpenAPI-спецификации.
- Записать клиента от поиска даты до готовой записи. MCP-сервер YCLIENTS проходит полный цикл онлайн-бронирования, от доступных дат и слотов до создания записи.
- Найти клиента и посмотреть историю визитов. Тот же сервер ведет карточки клиентов, а еще сотрудников, их должности и загруженность по расписанию.
- Посчитать выручку по дням, получить Z-отчет и разбивку записей по источникам и статусам. Аналитику дают оба сервера на 30 с лишним инструментов.
- Подключить YCLIENTS к ИИ-агентам Timeweb Cloud. MCP-сервер gjrprdhvnh работает по Streamable HTTP и совместим с ними.
- Работать с кассами, лояльностью, складом и фискализацией чеков. Связка YClients и Ozon дает 32 инструмента на 305 операций и раз в неделю сверяет код со спецификацией.
Partner token и user token
У YCLIENTS два ключа. Партнерский токен выдают после регистрации в маркетплейсе интеграций. Его копируют в разделе «Настройки аккаунта». Пользовательский токен получают методом auth по логину и паролю сотрудника. При двухфакторной защите API попросит код.
Оба ключа идут в одном заголовке Authorization: Bearer <партнерский токен>, User <пользовательский токен>. Еще API ждет заголовок Accept: application/vnd.yclients.v2+json. Какие методы требуют пользовательский токен, документация указывает у каждого метода.
Серверу на 30 с лишним инструментов от greenrun666 для части операций нужен user-токен. В описании сервера gjrprdhvnh указан партнерский токен из маркетплейса разработчиков, и для запуска ему нужен Python 3.10 или новее. Сервер greenrun666 добавляют в агента через npx skillfoxx add mcp/yclients-mcp-server.
Какой сервер ставить
У всех серверов широкий доступ, потому что через них агент правит и стирает записи на услуги, карточки клиентов и сотрудников в рабочей базе компании. VPN не нужен, и код открыт у всех. Официального сервера от YCLIENTS в каталоге нет, поэтому выбор сводится к охвату и способу запуска.
- Нужны записи, клиенты и аналитика у себя на компьютере. Сервер greenrun666, но в его README вместо пути репозитория стоит плейсхолдер YOUR_USERNAME.
- Агент уже живет в Timeweb Cloud. Сервер gjrprdhvnh с готовой конфигурацией для их панели.
- Нужны кассы, склад и фискальные чеки. Связка в docker-compose за nginx, хотя Ozon-сервер в ней обходит защиту сайта браузером и может сломаться.
- Нужны платежи или рассылки клиентам. ЮKassa и сервисы рассылок разобраны в каталоге российских сервисов, а Foxx AI на /scan ответит, хватит ли MCP для вашего сценария записи.
Лимиты API и боевая база
По документации YCLIENTS, лимит 200 запросов в минуту или 5 в секунду на один IP-адрес. Оба сервера на 30 с лишним инструментов зашили эти цифры в собственный ограничитель частоты, поэтому массовые операции через них идут медленнее.
Все вызовы идут в боевую базу компании. Ошибочное создание или удаление правят только вручную в интерфейсе YCLIENTS. Если YCLIENTS выдаст токен без права записи, начинайте с него, а первые задачи агенту давайте на просмотр расписания, загруженности сотрудников и отчетов о выручке.