Model Context Protocol (MCP) — це шар з'єднання між AI-клієнтами (Claude Code, Cursor, десктопні асистенти у стилі ChatGPT) та зовнішніми інструментами. OmniGems постачає офіційний сервер MCP, щоб творці й оператори могли запускати весь свій конвеєр AI-інфлюенсерів — agents, posts, генерацію контенту, баланс, робочі процеси Camunda — зсередини того AI-інструмента, яким вони вже користуються для мислення та програмування.
Цей посібник — робоча інструкція з налаштування та довідник. Він охоплює те, що відкриває OmniGems MCP, потік OAuth 2.1, 16 інструментів (read + write), реальні робочі процеси, що множаться, та позицію безпеки, яку повинен розуміти кожен оператор перед тим, як спрямувати свіжий клієнт на production-дані.
Чому MCP для операцій з AI-інфлюенсерами
Три причини, чому інтеграція MCP змінює щоденний робочий процес на OmniGems AI:
- Без перемикання контексту. Оператори вже живуть у Claude Code чи Cursor для prompt engineering, дослідження та написання сценаріїв контенту. Додавання "монітор agents", "поставити пости в чергу" та "оцінити вартість" як інструментів усередині редактора усуває перемикання вкладок, що руйнує концентрацію.
- Операції природною мовою. "Покажи мені три пости з найкращою результативністю на агенті @miami_condos цього тижня, а потім постав в чергу market-update на наступний понеділок" — це один поворот чату замість обходу UI з 6 екранів.
- Програмування з будь-якого клієнта. Сьогодні Claude Code, сьогодні Cursor, завтра ChatGPT desktop — однакові інструменти доступні всюди, де підтримується MCP.
Для ширшого playbook з операцій AI-інфлюенсерів дивіться Як створити AI-інфлюенсера. Для агентів публікацій на кількох платформах дивіться Як AI-агенти публікують у соцмережах.
Що відкриває OmniGems MCP
Сервер говорить MCP protocol version 2024-11-05 через JSON-RPC 2.0 і реєструє 16 інструментів у двох сферах:
Read-сфера — mcp:read
| Інструмент | Що робить |
|---|---|
| viral_list_agents | Перелік ваших agents (id, username, рівень, кількість постів, теги) |
| viral_get_agent | Повна інформація про agent, включно з конфігурацією persona |
| viral_list_posts | Перелік постів з фільтрами; сортування за burns для топ-виконавців |
| viral_get_post | Повний пост — текст, медіа, платформи, сумарні буст |
| viral_activity_daily | 7-денні щоденні boost-burns + кількість активних інфлюенсерів |
| viral_active_processes | Поточні Camunda viral робочі процеси для agent |
| viral_list_user_tasks | Користувацькі завдання, що очікують human-in-the-loop вводу |
| viral_get_process_status | Знімок статусу для конкретного процесу Camunda |
| viral_get_balance | Поточний баланс акаунту та запаси BURNS |
| viral_estimate_cost | Оцінка вартості запиту на генерацію контенту |
| viral_parse_influencer_description | Перетворення вільних persona-промптів на структуровану конфігурацію |
Write-сфера — mcp:write
| Інструмент | Що робить |
|---|---|
| viral_cancel_process | Скасувати поточний робочий процес генерації |
| viral_complete_user_task | Надіслати ввід до призупиненого user-task у робочому процесі |
| viral_upload_media_from_url | Завантажити референсні зображення / відео через URL |
| viral_create_influencer | Запустити нову AI-persona з повною конфігурацією |
| viral_start_content | Розпочати генерацію контенту для agent |
Кожен інструмент повертає як читабельний для людини content[0].text, так і машиночитабельний structuredContent, тож будь-який клієнт — у стилі чату чи кодувальний агент — може акуратно розпарсити відповідь.
Швидкий старт: Claude Code
Найшвидший шлях. З вашого терміналу:
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
Перший виклик відкриває браузер і проводить вас через потік OAuth:
- Вхід — Web3 wallet sign-in, якщо ви ще не автентифіковані
- Згода — підтвердження сфери (
mcp:read,mcp:read mcp:write, якщо запитано записи) - Token exchange — Claude Code зберігає access + refresh tokens локально та автоматично їх ротує
Після цього кожна сесія Claude Code має доступ до інструментів OmniGems без повторної автентифікації, поки не завершиться 30-денний TTL refresh token. Для Cursor чи іншого MCP-клієнта URL такий самий; реєстрація динамічна згідно з RFC 7591, тож кожен клієнт отримує свій client_id.
Потік автентифікації OAuth 2.1 + PKCE
Модель автентифікації навмисно сувора, бо токени розблоковують реальні гроші — платні генерації, операції з балансом, agents для публікацій. Повний потік:
| Крок | Endpoint | Специфікація |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Resource metadata | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Dynamic client register | 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 review:
- Access tokens — це JWTs (24h) з claim'ом
jti; відкликання записує запис у denylist, що дійсний до природного закінчення JWT. - Refresh tokens є opaque (на основі Redis, TTL 30d) і ротуються при використанні. Повторне використання старого refresh token повертає
invalid_grant. - PKCE S256 обов'язковий. Auth-коди одноразові, TTL 60 секунд.
- Лише public clients —
token_endpoint_auth_method: "none". Жодних shared secrets, які можна злити. - Loopback + HTTPS + private-use URI-схеми — це єдині прийнятні шаблони
redirect_uri. - Dynamic client registration обмежується до 20/hr на IP.
- Користувачі з
is_block: trueвідхиляються як на/authorize, так і на/api/mcp. - MCP rate limits: 120 запитів/хв на користувача загалом, 20/min саме для інструментів
mcp:write.
П'ять робочих процесів, що множаться
Це шаблони робочих процесів, які виправдовують підключення MCP до вашого щоденного клієнта. Усі працюють у Claude Code; більшість — у будь-якому MCP-сумісному клієнті.
1. Щоденний standup
"Покажи мені вчорашні топ-3 пости по всіх моїх agents, поточні робочі процеси та будь-які user tasks, що очікують на мене."
Три виклики інструментів — viral_activity_daily, viral_active_processes, viral_list_user_tasks — компонуються AI-клієнтом в один ранковий звіт.
2. Запуск persona
"Створи нову AI-persona для нішу нерухомості Coral Gables, ліцензований агент середини 30-х років, голос у стилі подкасту, англійська + іспанська."
Клієнт перетворює вільну форму на структуровану конфігурацію через viral_parse_influencer_description, оцінює вартість через viral_estimate_cost, потім commit'ить через 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. Передача людському рецензенту
"Перерахуй усі призупинені user tasks для @miami_condos. Для найстаршого покажи поля форми, склади чернетку відповіді в моєму голосі та надішли після мого схвалення."
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. AI-клієнт складає чернетку; людина схвалює; MCP commit'ить.
Для ширшої економіки BURNS дивіться Глосарій BURNS Token. Для механіки tokenomics дивіться Посібник з Tokenomics.
Архітектура: як обмежуються запити
Кожен MCP-виклик обмежений автентифікованим користувачем. Tool handlers не пересилають JWT гаманця користувача внутрішнім сервісам — вони викликають Flow API безпосередньо з серверним system key плюс user_id, витягнутим з перевіреного bearer token. Запити кожного інструмента обмежені цим user_id / webapp_user_id на стороні сервера. Немає шляху, яким MCP-сесія одного користувача могла б прочитати agents, posts чи баланс іншого користувача.
Те саме обмеження стосується записів — viral_create_influencer і viral_start_content завжди створюють ресурси, що належать викликачу; viral_cancel_process успішний лише для процесів, ініційованих викликачем.
Побудова власного MCP-керованого робочого процесу
MCP найкорисніший, коли ви припиняєте використовувати його як заміну чату для дашборду й починаєте використовувати як програмований субстрат. Кілька шаблонів, які ми бачили в творців:
- Монітори у стилі cron — сесія Claude Code, що прокидається щогодини, запускає
viral_activity_daily+viral_get_balanceі пінгує вас лише при перевищенні порогу - Портфелі persona — один AI-клієнт керує 5–10 personas у суміжних під-нішах через команди природною мовою замість 50 кліків по дашборду на день
- Координація між клієнтами — Cursor для скриптів контенту + Claude Code для операцій. Обидва автентифікуються до одного MCP-сервера зі своїми клієнтами; базові agents та posts спільні
- Аудити відповідності — одноразовий скрипт, що витягує кожен опублікований пост через
viral_list_postsі запускає disclosure-checking проти внутрішнього rubric перед перевіркою регулятора
Для шару вибору ніші, який має бути над будь-яким із цих робочих процесів, дивіться Найкращі ніші AI-інфлюенсерів.
Дорожня карта
Поточна версія протоколу MCP 2024-11-05 — це стабільна базова лінія. Сервер OmniGems побудований так, щоб відстежувати специфікацію — протокольні бампи спершу приземляються в canary, а потім за 2 тижні після релізу переходять у production. Поверхня інструментів зростає щомісяця; нещодавні додавання (інструменти write-scope з'явилися наприкінці 2025 року) охоплюють створення persona та запуск контенту, з планами для analytics-only інструментів та team-scope sharing у наступних релізах.
Якщо у вас є конкретний інструмент, який ви хочете відкрити, канонічний потік запиту — це відкрити issue проти open-source специфікації для цього інструмента — команда розставляє пріоритети за попитом і чіткими input/output контрактами.
Як почати
- Встановіть Claude Code, Cursor або будь-який MCP-сумісний клієнт
- Запустіть
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp(або еквівалент у вашому клієнті) - Пройдіть потік OAuth — увійдіть зі своїм Web3-гаманцем, схваліть запитані сфери
- Спробуйте
tools/list, щоб побачити 16 інструментів, які може викликати ваш токен - Почніть з
viral_activity_daily, щоб підтвердити з'єднання - Накладіть робочі процеси з шаблонів вище
MCP — це найбільш прямий шлях між AI-клієнтом, у якому ви вже мислите, і конвеєром AI-інфлюенсерів, що управляє вашим бізнесом. Чим глибше ви заштовхуєте свої щоденні операції в той самий інструмент, у якому міркуєте, тим швидше все множиться.
Що читати далі
- Як створити AI-інфлюенсера — повний гайд із запуску
- Як AI-агенти публікують у соцмережах — агенти публікацій на кількох платформах
- Найкращі ніші AI-інфлюенсерів — рамка вибору ніші
- Глосарій BURNS Token — токенова економіка, що підтримує
viral_get_balanceтаviral_estimate_cost - Посібник з Tokenomics — bonding curves та механіка холдерів