API ВЕГА
English

Socialync MCP Server

Официальная документация, манифест реестра и плагин Cursor для размещённого на сервере MCP-сервера Socialync. Socialync — инструмент для авторов, который позволяет публиковать материалы в нескольких соцсетях и планировать публикации: загрузите материал один раз и опубликуйте его в TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Threads и Bluesky.

Этот MCP-сервер позволяет Claude, ChatGPT, Cursor, Google Antigravity, Gemini CLI, OpenAI Codex, Grok Bot и любому совместимому с MCP AI-агенту создавать черновики, планировать и публиковать посты в соцсетях через вашу учётную запись Socialync с авторизацией OAuth. При этом рабочий процесс предусматривает обязательное подтверждение публикаций человеком. Сервер также считывает статистику: просмотры, отметки «Нравится», комментарии, репосты, сохранения, число подписчиков, а также данные о самых успешных и наименее успешных публикациях. Благодаря этому агент может планировать контент на следующую неделю, опираясь на реальные результаты.

Интеграция с каждой платформой работает через её официальный API. Никакой автоматизации браузера, сбора данных со страниц или неофициальных конечных точек. Агент не сможет по нашей вине подвергнуть вашу учётную запись риску ограничений.

Защита от дублирования гарантирует, что повторный запрос не приведёт к повторной публикации. Неудачные публикации отправляются на повтор автоматически. Оба механизма особенно важны, когда публикациями управляет агент.

Примечание: сервер Socialync размещён удалённо, его исходный код закрыт. В этом репозитории находятся только документация, манифест MCP Registry и файлы плагина Cursor. Здесь ничего не нужно устанавливать или запускать.

Конечная точка

https://mcp.socialync.io/mcp

Транспорт: Streamable HTTP. Документ обнаружения со сведениями об инструментах, платформах, авторизации и ограничениях в формате JSON: https://mcp.socialync.io/.well-known/mcp

Доступ к MCP и API входит в бесплатный тариф. Стоимость — $0, банковская карта не нужна. Включено 5 публикаций в месяц на 7 платформах (X доступна в платных тарифах). Агент может подключиться и публиковать материалы без необходимости указывать данные карты. Платные тарифы начинаются от $20 в месяц и включают неограниченное число публикаций и 5 подключённых учётных записей (Starter — $20, Creator — $30 за 10 учётных записей, Agency — $99 за 100; дополнительные учётные записи — от $2 в месяц). Тарифы и цены.

Важные ограничения: 1 ключ API на бренд и до 10 публикаций, созданных с помощью AI, в день на бренд в платных тарифах (5 — в бесплатном).

Два способа авторизации

A) OAuth 2.1 (рекомендуется). Добавьте URL без заголовков. Клиент зарегистрируется самостоятельно (динамическая регистрация клиента, PKCE, без секрета клиента), откроет браузер, а вы войдёте в Socialync и выберете бренды, которыми агент сможет управлять. Именно так работают Claude.ai, Claude Code, Cursor, ChatGPT, Google Antigravity, Gemini CLI и Codex.

B) Ключ API Bearer. Для клиентов, которые не могут пройти авторизацию OAuth через браузер (Grok Bot, агенты без графического интерфейса, конфигурационные файлы, отредактированные вручную). Создайте ключ на странице https://www.socialync.io/go/github-api-keys и передавайте его в заголовке Authorization: Bearer . Один ключ на бренд, доступен во всех тарифах. Не добавляйте ключ в репозиторий.

OAuth-перенаправления, для которых подтверждена работа полного сценария (принимаются любые URI перенаправления с https, а также http://localhost и http://127.0.0.1 на любом порту):

Подключение

Claude (claude.ai): Socialync есть в каталоге коннекторов Claude. Откройте Settings, затем Connectors, выберите Browse connectors, найдите Socialync и войдите в систему. Чтобы добавить коннектор по URL, выберите "Add custom connector" и вставьте указанную выше конечную точку. Подробная инструкция: руководство по подключению Socialync к MCP.

Claude Code:

claude mcp add --transport http socialync https://mcp.socialync.io/mcp

Cursor / Grok Bot (OAuth, только URL):

{
  "mcpServers": {
    "socialync": {
      "url": "https://mcp.socialync.io/mcp"
    }
  }
}

Grok Bot и другие клиенты, которые не могут пройти OAuth (ключ Bearer):

{
  "mcpServers": {
    "socialync": {
      "url": "https://mcp.socialync.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SOCIALYNC_API_KEY"
      }
    }
  }
}

Grok Bot проходит OAuth через облако Cursor, а не с вашего компьютера. Один и тот же URL может работать в IDE Cursor, но не работать в Grok Bot. Проверяйте подключение в Grok Bot: откройте Settings, затем Plugins, а не только IDE. Если авторизация OAuth не начинается или появляется сообщение "fetch failed", используйте вариант с ключом Bearer.

Google Antigravity: добавьте эту запись в ~/.gemini/config/mcp_config.json (или в .agents/mcp_config.json в рабочей области). Antigravity использует serverUrl и самостоятельно выполняет вход через динамическую регистрацию клиента.

{
  "mcpServers": {
    "socialync": {
      "serverUrl": "https://mcp.socialync.io/mcp"
    }
  }
}

Gemini CLI: установите расширение, затем выполните команду /mcp auth socialync.

gemini extensions install https://github.com/JackVitick/socialync-mcp

Или самостоятельно добавьте эту запись в ~/.gemini/settings.json:

{
  "mcpServers": {
    "socialync": {
      "httpUrl": "https://mcp.socialync.io/mcp"
    }
  }
}

OpenAI Codex CLI:

codex mcp add socialync --url https://mcp.socialync.io/mcp
codex mcp login socialync

ChatGPT: включите режим разработчика и добавьте пользовательский коннектор, указав URL конечной точки. Список тарифов ChatGPT, в которых можно добавлять пользовательские коннекторы, со временем менялся. Уточните информацию о своём тарифе на справочной странице OpenAI о режиме разработчика.

OpenClaw:

openclaw mcp add socialync --url https://mcp.socialync.io/mcp --transport streamable-http
openclaw mcp login socialync

Другие клиенты MCP (универсальная конфигурация):

{
  "mcpServers": {
    "socialync": {
      "type": "streamable-http",
      "url": "https://mcp.socialync.io/mcp"
    }
  }
}

Плагин Claude Code

Этот репозиторий — плагин Claude Code и его собственный маркетплейс плагинов. Он добавляет размещённый на сервере MCP-сервер (файл .mcp.json, без секретов) и перечисленные ниже навыки.

/plugin install socialync --marketplace JackVitick/socialync-mcp

В версиях Claude Code до 2.1.275 выполните две команды:

/plugin marketplace add JackVitick/socialync-mcp
/plugin install socialync@socialync

При первом запуске инструмента Socialync в браузере откроется окно входа. Инструкции по настройке: SETUP.md. Чтобы не устанавливать плагин, добавьте сервер напрямую (см. раздел Claude Code в разделе «Подключение»).

Навыки

Шесть навыков помогают агенту эффективно использовать сервер. Каждый из них запрашивает ваше подтверждение перед публикацией каждого поста.

НавыкНазначение
schedule-social-postСоздание черновиков, планирование и публикация на 8 платформах с подтверждением каждого поста
film-once-week-of-shortsОдна съёмочная сессия — неделя публикаций в TikTok, Reels и Shorts
blog-to-a-week-of-postsОдна статья — неделя публикаций в LinkedIn и X; ссылка размещается в первом комментарии
weekly-what-workedЕженедельный анализ статистики и подбор идей на следующую неделю
notes-to-carouselПреобразование заметок в готовую карусель изображений для Instagram, LinkedIn и Threads
social-queue-analyticsПросмотр запланированных публикаций, изменение времени или отмена; сведения о причинах неудачной публикации

Установка:

  • Claude Code: установите плагин, описанный выше.

  • Cursor, Codex, Windsurf, Gemini CLI и другие агенты: npx skills add JackVitick/socialync-mcp

  • OpenClaw: openclaw skills install @jackvitick/socialync

  • Claude (веб-версия и приложение для компьютера): скачайте папку с навыком и упакуйте её в ZIP-файл. Затем откройте Customize, Skills, нажмите кнопку +, выберите Create skill и Upload a skill. Выполнение кода должно быть включено (Settings, Capabilities).

Навыки содержат необязательные рекомендации. Сервер работает и без них.

Плагин Cursor и Grok Bot

Этот репозиторий также является плагином Cursor (.cursor-plugin/plugin.json, mcp.json, skills/, assets/logo.png). После публикации найдите его в Cursor Marketplace по запросу "Socialync" и установите либо добавьте URL MCP напрямую, как описано выше. Навыки из папки skills/ подсказывают агенту, как создавать черновики, планировать публикации, составлять план постов на неделю и проверять очередь. Список требований к отправке: MARKETPLACE-SUBMIT.md.

Инструменты

Доступны 28 инструментов. Тот же список опубликован по адресу https://www.socialync.io/.well-known/mcp.

ИнструментНазначение
list_profilesПоказать профили брендов Socialync. Вызывайте первым: для каждой операции записи требуется profileId
list_connectionsПоказать подключённые аккаунты соцсетей и проверить их состояние
list_audiencesПоказать сохранённые аудитории, на которые можно нацелить публикацию
list_mediaПросмотреть материалы в Socialync; для добавления видео используется mediaId
create_media_upload / finalize_media_uploadЗагрузить изображения или созданное видео
import-claude-motion-from-urlИмпортировать видео Claude Motion в библиотеку, чтобы подготовить его к публикации
check_quotaПроверить тарифный план, остаток публикаций, дневные лимиты для каждой платформы и период планирования
validate_postПредварительная проверка без внесения изменений: длина подписи, ссылки, медиафайлы, соотношение сторон, длительность видео и состояние подключений
create_post_draftСохранить текстовую публикацию или публикацию с изображением как черновик до вашего подтверждения в чате
schedule_post_draftСохранить текстовую публикацию, публикацию с изображением или видео как черновик на будущее до вашего подтверждения в чате
get_draft_statusПроверить, на каком этапе находится черновик
approve_draftОпубликовать ожидающий подтверждения черновик после вашего подтверждения в чате
publish_nowНемедленно опубликовать текстовую публикацию или публикацию с изображением после вашего подтверждения в чате
publish_scheduledЗапланировать публикацию напрямую, в том числе видео для TikTok и YouTube, после вашего подтверждения в чате
create_x_article_draft / publish_x_article_nowСоздавать и публиковать длинные статьи X Articles (требуется аккаунт X Premium)
get_scheduled_postsПоказать предстоящие запланированные публикации
update_scheduled_postИзменить время публикации, подпись, заголовок или первый комментарий либо удалить платформу из списка публикаций
delete_scheduled_postОтменить запланированную публикацию
get_post_historyПросмотреть историю опубликованных материалов и их статус
get_top_postsНайти публикации с лучшими результатами, включая время просмотра и удержание аудитории в течение первых 3 секунд для видео
get_post_insightsПодробная аналитика одной публикации: кривая удержания, самый резкий спад и сравнение всех платформ (интерактивный график в клиентах с поддержкой приложений)
get_commentsПрочитать комментарии и ответы к публикации
reply_to_commentОтветить на комментарий после вашего подтверждения в чате (Instagram, Threads, страницы LinkedIn, Bluesky)
get_best_timesПоказать наиболее подходящее время для публикаций на каждой платформе на основе вашей истории
get_analyticsПолучить аналитику по подписчикам и вовлечённости
generate_contentСоздать с помощью AI подписи, адаптированные для конкретных платформ (платные тарифы)

Текстовые публикации и публикации с изображениями сразу размещаются в Instagram, Facebook, X, LinkedIn, Threads и Bluesky. Публикации с видео, в том числе для TikTok и YouTube (заголовок обязателен), планируются к выходу с использованием медиафайлов из библиотеки Socialync или общедоступного URL видео. Вставить видеофайл напрямую в чат нельзя: сначала загрузите его в Socialync.

Полная справка, включая рекомендуемый порядок вызова инструментов, ограничения для каждой платформы и обработку ошибок: docs/tools.md.

Аналитика через MCP

Socialync собирает аналитику публикаций и аккаунтов в TikTok, YouTube, Instagram, Facebook, Threads и Bluesky. MCP-сервер возвращает те же показатели, что и страница аналитики Socialync (на платных тарифах).

  • get_analytics возвращает общие показатели просмотров, отметок «Нравится», комментариев, репостов, сохранений и подписчиков за последнюю неделю или месяц, их изменение по сравнению с предыдущим периодом, а также, при необходимости, разбивку по платформам и ежедневный временной ряд для построения графиков.

  • get_top_posts возвращает список публикаций с показателями просмотров, отметок «Нравится», комментариев, репостов, коэффициента вовлечённости и статусом эффективности (вирусная, хорошая, средняя или неудачная). Результаты можно сортировать по вовлечённости или дате и фильтровать по платформе и минимальному статусу.

  • get_post_history показывает, что и где было опубликовано, а для публикаций с ошибками указывает понятную причину и рекомендацию по повторной попытке.

Bluesky показывает вовлечённость, но не просмотры, поэтому публикации на этой платформе оцениваются только по вовлечённости.

Примеры рабочих процессов

Вставьте эти запросы в любой подключённый агент. Указывать название инструмента необязательно, но так ход выполнения будет понятнее. В описании каждого навыка выше также есть запрос «Попробовать», который можно скопировать.

Составить план на неделю на основе успешных публикаций

Используй get_top_posts, чтобы найти 5 моих лучших публикаций за последние 30 дней, и расскажи, что у них общего. Затем предложи 5 идей для публикаций на эту неделю в том же стиле.

Подготовить и запланировать публикации на неделю

Подготовь каждую идею в виде публикации для TikTok, Instagram, LinkedIn и Threads, подобрав подпись для каждой платформы. Запусти validate_post для каждой публикации, затем запланируй их как черновики с понедельника по пятницу на 18:00 по моему времени и покажи список для подтверждения.

Опубликовать одно видео на всех платформах

Покажи мои последние видео с помощью list_media. Запланируй самое новое видео для TikTok, Instagram Reels и YouTube Shorts на завтра, на 17:00. Заголовок YouTube: "How I edit a Short in 10 minutes". Перед планированием покажи мне всё.

Еженедельный отчёт

Используй get_analytics за последнюю неделю с разбивкой by_platform. Расскажи, на какой платформе показатели выросли, на какой снизились и какая публикация стала лучшей на каждой платформе.

Проверить очередь публикаций

Покажи публикации на следующую неделю с помощью get_scheduled_posts, а также публикации, которые не удалось разместить на этой неделе, с помощью get_post_history.

Как пользователь сохраняет контроль

Socialync предписывает каждому подключённому агенту показать вам точную публикацию — платформы, текст для каждой из них, медиафайлы и время — и дождаться вашего подтверждения в чате перед вызовом publish_now, publish_scheduled или approve_draft. Эти инструменты помечены как критически важные, поэтому такие клиенты, как Claude, запрашивают у вас разрешение перед их запуском. Навыки в этом репозитории работают так же и при пакетной публикации: каждая публикация показывается целиком и получает номер, а публикуются только те, которые вы одобрили. Для TikTok агент спрашивает, кто сможет видеть каждое видео (все, друзья, подписчики или только вы), и никогда не выбирает аудиторию за вас. Если вы хотите сначала проверить публикацию в приложении, попросите создать черновик: create_post_draft и schedule_post_draft сохранят его в Socialync для вашего подтверждения. До этого публикация не выйдет.

Чтобы Socialync выполнял дополнительную проверку, включите диалог подтверждения в настройках Socialync. Клиенты с поддержкой MCP elicitation покажут публикацию перед размещением; отказ от подтверждения остановит её.

Socialync публикует именно тот материал, который вы одобрили, и записывает, кто и когда подтвердил каждую публикацию. Публикации размещаются через подключённые вами аккаунты; отключить их можно в любой момент. Режима автоматической публикации без вашего участия нет.

Ссылки

Поддержка

Если у вас есть вопросы или возникли проблемы, создайте issue здесь или напишите на support@socialync.io.

Подписаться на Socialync