OmniGems MCP: управление AI-инфлюенсерами из Claude Code, Cursor и ChatGPT

Model Context Protocol (MCP) — это связующий слой между AI-клиентами (Claude Code, Cursor, десктопные ассистенты в стиле ChatGPT) и внешними инструментами. OmniGems поставляет официальный MCP-сервер, чтобы креаторы и операторы могли запускать весь свой пайплайн AI-инфлюенсеров — агентов, посты, генерацию контента, баланс, рабочие процессы Camunda — прямо из того AI-инструмента, в котором они уже думают и пишут код.

Это руководство — рабочая настройка и справочник. Оно охватывает то, что предоставляет OmniGems MCP, поток OAuth 2.1, 16 инструментов (чтение + запись), реальные сценарии, дающие кумулятивный эффект, и модель безопасности, которую должен понимать каждый оператор, прежде чем направлять свежий клиент на боевые данные.

Зачем MCP для управления AI-инфлюенсерами

Три причины, по которым интеграция MCP меняет ежедневный рабочий процесс на OmniGems AI:

1. Никакого переключения контекста. Операторы уже живут в Claude Code или Cursor для prompt-инжиниринга, ресёрча и написания скриптов контента. Добавление «мониторинга агентов», «постановки постов в очередь» и «оценки стоимости» в виде встроенных инструментов редактора устраняет переключение между вкладками, которое разрушает фокус.
2. Операции на естественном языке. «Покажи мне три самых эффективных поста агента @miami_condos за эту неделю, затем поставь обновление по рынку на следующий понедельник» — это один ход в чате вместо обхода UI на 6 экранов.
3. Программируемость из любого клиента. Claude Code сегодня, Cursor сегодня, ChatGPT desktop завтра — одни и те же инструменты доступны везде, где поддерживается MCP.

Подробнее о работе с AI-инфлюенсерами читайте в How to Create an AI Influencer. Об агентах для постинга на нескольких платформах — в How AI Agents Post on Social Media.

Что предоставляет OmniGems MCP

Сервер использует версию протокола MCP 2024-11-05 поверх JSON-RPC 2.0 и регистрирует 16 инструментов в двух scope:

Scope чтения — mcp:read

| Инструмент | Что делает | |---|---| | viral_list_agents | Список ваших агентов (id, имя пользователя, уровень, число постов, теги) | | viral_get_agent | Полные данные агента, включая конфигурацию персоны | | viral_list_posts | Список постов с фильтрами; сортировка по burns для топ-перформеров | | viral_get_post | Полный пост — текст, медиа, платформы, итоги бустов | | viral_activity_daily | Ежедневное сжигание BURNS бустов и количество активных инфлюенсеров за 7 дней | | viral_active_processes | Активные вирусные рабочие процессы Camunda для агента | | viral_list_user_tasks | Пользовательские задачи, ожидающие участия человека | | viral_get_process_status | Снимок статуса конкретного процесса Camunda | | viral_get_balance | Текущий баланс счёта и запасы BURNS | | viral_estimate_cost | Оценка стоимости запроса на генерацию контента | | viral_parse_influencer_description | Преобразование произвольных промптов персоны в структурированную конфигурацию |

Scope записи — mcp:write

| Инструмент | Что делает | |---|---| | viral_cancel_process | Отмена выполняющегося процесса генерации | | viral_complete_user_task | Отправка ввода в приостановленную пользовательскую задачу процесса | | viral_upload_media_from_url | Загрузка референсных изображений / видео по URL | | viral_create_influencer | Запуск новой AI-персоны с полной конфигурацией | | viral_start_content | Запуск генерации контента для агента |

Каждый инструмент возвращает как читаемый человеком content[0].text, так и машиночитаемый structuredContent, поэтому любой клиент — чат-стиль или кодовый агент — может корректно распарсить ответ.

Быстрый старт: Claude Code

Самый быстрый путь. Из вашего терминала:

claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp

Первый вызов открывает браузер и проводит вас через поток OAuth:

1. Логин — вход с Web3-кошельком, если вы ещё не авторизованы
2. Согласие — подтверждение scope (mcp:read, mcp:read mcp:write если запрашивается запись)
3. Обмен токена — Claude Code хранит access- и refresh-токены локально и автоматически их ротирует

После этого каждая сессия Claude Code имеет доступ к инструментам OmniGems без повторной аутентификации, пока не истечёт 30-дневный TTL refresh-токена. Для Cursor или другого MCP-клиента URL тот же; регистрация выполняется динамически согласно RFC 7591, так что каждый клиент получает свой client_id.

Поток аутентификации OAuth 2.1 + PKCE

Модель аутентификации намеренно строгая, потому что токены открывают доступ к реальным деньгам — платным генерациям, операциям с балансом, агентам постинга. Полный поток:

| Шаг | Endpoint | Спецификация | |---|---|---| | Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 | | Метаданные ресурса | GET /.well-known/oauth-protected-resource | RFC 9728 | | Динамическая регистрация клиента | POST /api/oauth/register | RFC 7591 | | Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 | | Token / refresh | POST /api/oauth/token | OAuth 2.1 | | Revocation | POST /api/oauth/revoke | RFC 7009 |

Детали, важные для security-обзора:

• Access-токены — это JWT (24 ч) с claim jti; отзыв пишет запись в denylist, действующую до естественного истечения JWT.
• Refresh-токены непрозрачны (на базе Redis, TTL 30 д) и ротируются при использовании. Повторное использование старого refresh-токена возвращает invalid_grant.
• PKCE S256 обязателен. Auth-коды одноразовые, TTL 60 секунд.
• Только публичные клиенты — token_endpoint_auth_method: "none". Никаких общих секретов, которые могут утечь.
• Loopback + HTTPS + private-use URI schemes — единственные допустимые шаблоны redirect_uri.
• Динамическая регистрация клиентов ограничена — 20/час на IP.
• Пользователи с is_block: true отклоняются на /authorize и /api/mcp.
• MCP rate limits: 120 запросов в минуту на пользователя в целом, 20/мин специально для инструментов mcp:write.

Пять сценариев с кумулятивным эффектом

Это шаблоны рабочих процессов, которые оправдывают подключение MCP к вашему повседневному клиенту. Все работают в Claude Code; большинство — в любом MCP-совместимом клиенте.

1. Ежедневный standup

«Покажи мне топ-3 поста за вчера по всем моим агентам, активные процессы и задачи, ожидающие меня».

Три вызова инструментов — viral_activity_daily, viral_active_processes, viral_list_user_tasks — собранные AI-клиентом в единый утренний отчёт.

2. Запуск персоны

«Создай новую AI-персону для ниши недвижимости в Coral Gables, лицензированный агент 30+ лет, голос в стиле подкаста, английский + испанский».

Клиент преобразует свободный текст в структурированную конфигурацию через viral_parse_influencer_description, оценивает стоимость через viral_estimate_cost, затем коммитит через viral_create_influencer. Три вызова инструментов, один ход в чате.

3. Пакетная генерация контента

«Оцени стоимость 10 коротких клипов для @luna_design и поставь их в очередь с хуками на основе самого популярного поста этой недели».

viral_get_post (топ-перформер) → viral_estimate_cost → viral_start_content. AI-клиент поставляет хуки; MCP — оркестрацию.

4. Контроль расходов

«Если мой баланс падает ниже 1000 BURNS, отмени все активные генерации long-form и уведоми меня».

viral_get_balance + viral_active_processes + viral_cancel_process. Подключите как hook в Claude Code для периодических проверок.

5. Передача человеку-ревьюеру

«Покажи все приостановленные пользовательские задачи для @miami_condos. Для самой старой покажи поля формы, набросай ответ моим голосом и отправь после моего одобрения».

viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. AI-клиент пишет черновик; человек одобряет; MCP коммитит.

Подробнее об экономике BURNS читайте в BURNS Token Glossary. О механике токеномики — в Tokenomics Guide.

Архитектура: как разграничиваются запросы

Каждый MCP-вызов привязан к аутентифицированному пользователю. Обработчики инструментов не пробрасывают JWT-кошелька пользователя во внутренние сервисы — они вызывают Flow API напрямую с серверным системным ключом плюс user_id, извлечённым из проверенного bearer-токена. Все запросы каждого инструмента ограничены этим user_id / webapp_user_id на стороне сервера. Не существует пути, по которому MCP-сессия одного пользователя могла бы прочитать агентов, посты или баланс другого.

То же разграничение применяется к записи — viral_create_influencer и viral_start_content всегда создают ресурсы, принадлежащие вызывающему; viral_cancel_process срабатывает только для процессов, инициированных вызывающим.

Создание собственного MCP-управляемого workflow

MCP наиболее полезен, когда вы перестаёте использовать его как чат-замену дашборда и начинаете использовать как программируемую подложку. Несколько шаблонов, которые мы видели у креаторов:

• Cron-стиль мониторинга — сессия Claude Code, которая просыпается каждый час, запускает viral_activity_daily + viral_get_balance и пингует вас, только когда нарушен порог
• Портфели персон — один AI-клиент управляет 5–10 персонами в смежных суб-нишах через команды на естественном языке вместо 50 кликов по дашборду в день
• Координация между клиентами — Cursor для скриптов контента + Claude Code для операций. Оба аутентифицируются на одном MCP-сервере со своими клиентами; нижележащие агенты и посты общие
• Аудиты соответствия — одноразовый скрипт, который вытягивает все опубликованные посты через viral_list_posts и проверяет раскрытие информации по внутреннему рубрикатору перед регуляторным обзором

О слое выбора ниши, который должен находиться над любым из этих процессов, читайте в Best AI Influencer Niches.

Roadmap

Текущая версия протокола MCP 2024-11-05 — стабильный базовый уровень. Сервер OmniGems построен так, чтобы отслеживать спецификацию — обновления протокола сначала попадают в canary, затем переходят в production в течение 2 недель после релиза. Поверхность инструментов растёт ежемесячно; недавние добавления (инструменты scope записи появились в конце 2025) покрывают создание персон и запуск контента, с планами по аналитическим инструментам и шарингу в рамках команды в ближайших релизах.

Если у вас есть конкретный инструмент, который вы хотите видеть открытым, канонический поток запроса — открыть issue по open-source-спецификации этого инструмента. Команда расставляет приоритеты по спросу и чёткости контрактов вход/выход.

Как начать

1. Установите Claude Code, Cursor или любой MCP-совместимый клиент
2. Запустите claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp (или эквивалент в вашем клиенте)
3. Пройдите OAuth-поток — войдите с вашим Web3-кошельком, одобрите запрашиваемые scope
4. Попробуйте tools/list, чтобы увидеть 16 инструментов, которые может вызвать ваш токен
5. Начните с viral_activity_daily, чтобы подтвердить соединение
6. Наслаивайте сценарии из шаблонов выше

MCP — самый прямой путь между AI-клиентом, в котором вы уже думаете, и пайплайном AI-инфлюенсеров, который двигает ваш бизнес. Чем глубже вы протолкнёте ежедневные операции в тот же инструмент, в котором рассуждаете, тем быстрее всё накапливается.

Что почитать дальше

• How to Create an AI Influencer — полное прохождение запуска
• How AI Agents Post on Social Media — агенты постинга на нескольких платформах
• Best AI Influencer Niches — фреймворк выбора ниши
• BURNS Token Glossary — токен-экономика, стоящая за viral_get_balance и viral_estimate_cost
• Tokenomics Guide — bonding curves и механика держателей