Перейти до основного вмісту
n8n — це місце, де ви з’єднуєте ваші інструменти. Ayrshare — це єдиний API, який публікує у Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat і X одним викликом. Поєднайте їх за допомогою Ayrshare MCP Server, і ваш AI Agent у n8n зможе самостійно виконати весь цикл: скласти чернетку допису, перевірити її за правилами кожної мережі, опублікувати або запланувати, а потім зчитати аналітику. Стартовий workflow n8n на канві: chat trigger, що веде до AI Agent, з приєднаними знизу моделлю чату Anthropic та вузлом інструмента Ayrshare MCP, а також стікерами з налаштуванням і використанням. Оскільки MCP Server — це розміщений endpoint зі Streamable HTTP, ви підключаєте його через вбудований у n8n вузол MCP Client Tool. Немає нічого, що потрібно хостити, немає власного коду й немає жодного community-вузла для встановлення. Ви спрямовуєте один вузол на одну URL-адресу, і ваш agent отримує всі 27 соціальних інструментів.

Завантажте стартовий workflow n8n

Показаний вище workflow, готовий до імпорту: Chat Trigger, AI Agent, модель чату Anthropic і вузол Ayrshare MCP, попередньо налаштований із системним промптом validate-first.
Щоб використати його: у n8n виконайте Workflows → Import from file, оберіть JSON, а потім створіть два очікуваних credentials (credential Bearer Auth з вашим ключем Ayrshare і credential Anthropic API). Дві попереджувальні позначки зникнуть, щойно credentials буде прикріплено. Self-hosted екземпляри потребують вихідного доступу до api.ayrshare.com та вашого провайдера моделі. Цей посібник охоплює шлях MCP-first від початку до кінця. Якщо ви віддаєте перевагу створенню фіксованого workflow без agent, у кінці є короткий REST fallback.

​
Чому MCP замість написання API-викликів

Ви можете викликати REST API Ayrshare безпосередньо з вузла HTTP Request, і це чудово підходить для фіксованих, передбачуваних workflow. MCP Server має сенс, коли в цикл включена LLM:
  • Agent обирає інструмент. Опишіть мету (“опублікуй це в наші бізнес-канали і заплануй фолоу-ап на вівторок”), і agent сам обере validate_post, create_post і правильні параметри.
  • Валідація перед виходом у публікацію. validate_post виконує dry-run вашого контенту за правилами довжини, формату й медіа кожної платформи, тому agent не відправить допис, який мережа відхилить.
  • Один виклик — багато мереж. Один create_post розсилає у кожну прив’язану платформу.
  • Зміни платформ — проблема Ayrshare. Коли мережа змінює свій API, Ayrshare підтримує інтеграцію, і ваш workflow продовжує працювати.
  • Ті самі правила, що й у REST API. Кожен виклик MCP-інструмента виконується в тому ж процесі через той самий ланцюжок Ayrshare API: та сама автентифікація, ті ж rate limits, квоти й валідація. Немає окремої поведінки, яку потрібно вивчати.

​
Як це з’єднується

Вузол AI Agent — це мозок. Підвузол MCP Client Tool приєднується до нього, підключається до Ayrshare MCP Server за адресою https://api.ayrshare.com/mcp, виявляє доступні інструменти й надає їх agent’у. Коли agent діє, вузол відправляє виклик до Ayrshare, який публікує в мережах.
Для деталей endpoint, транспорту й автентифікації див. Connect & Setup. Повний перелік інструментів див. у Tool Catalog.

​
Передумови

  • Екземпляр n8n (Cloud або self-hosted) актуальної версії з вузлами AI Agent і MCP Client Tool. Вузол MCP Client Tool вбудований. Community-вузол не потрібен, оскільки сервер Ayrshare підтримує Streamable HTTP.
  • Обліковий запис Ayrshare і API key (Dashboard → Settings → API Key), або почніть з безкоштовного пробного періоду.
  • Принаймні один прив’язаний соціальний обліковий запис в Ayrshare. Agent може публікувати лише туди, де ви підключилися.
  • Credential моделі чату для вузла AI Agent (Anthropic, OpenAI тощо).
  • (За бажанням) Business or Enterprise plan, якщо ви керуватимете кількома клієнтами через суб-профілі.

​
Налаштування вузла MCP Client Tool

1

Додайте вузол AI Agent

Відкрийте або створіть workflow і додайте вузол AI Agent (у розділі Advanced AI nodes).
2

Приєднайте вузол MCP Client Tool

На вузлі AI Agent натисніть конектор Tool і додайте вузол MCP Client Tool. Налаштуйте його:
3

Додайте ваш ключ Ayrshare як credential Bearer

Для Credential створіть новий credential Bearer Auth і вставте ваш API key Ayrshare як токен. n8n надсилає його як Authorization: Bearer YOUR_API_KEY. Коли ви зберігаєте, n8n підключається й перелічує всі 27 інструментів.
4

Підключіть модель чату та системний промпт

Приєднайте підвузол Chat Model і виберіть credential вашої моделі. Дайте agent’у системний промпт, який задає правила, наприклад:
Ви — асистент з соціальних мереж, який має доступ до інструментів Ayrshare. Перед публікацією будь-чого завжди спочатку викликайте validate_post і повідомляйте про будь-які проблеми. Викликайте create_post лише після успішної валідації. За замовчуванням використовуйте платформи, названі користувачем; якщо жодних не названо, запитайте. Ніколи не вигадуйте URL-адреси медіа; використовуйте лише URL-адреси, надані користувачем, і підтверджуйте їх за допомогою validate_media, якщо є сумніви.
5

Додайте trigger

Для тестування найпростіше використовувати Manual Trigger або Chat Trigger. Для продакшена використовуйте те, що запускає workflow (schedule, webhook, форма, новий рядок у таблиці).
Використовуйте HTTP Streamable, а не SSE. Ayrshare MCP Server використовує сучасний транспорт Streamable HTTP і є stateless. Опція SSE в n8n застаріла, і сервер відхиляє SSE-потік. Завжди обирайте HTTP Streamable.

​
Набір інструментів

Ваш agent бачить усі 27 інструментів через один вузол MCP. Ви рідко викликаєте їх за назвою; ви описуєте намір, і agent обирає. Домени: Posts, History, Analytics, Comments, Messages, Profiles, Media, Generate, Webhooks та Errors. Повний перелік із призначенням і сферою застосування кожного інструмента див. у Tool Catalog. Два виділяються для безпеки: validate_post виконує dry-run допису з тими самими вхідними даними, що й create_post, але нічого не публікує, а explain_error перетворює будь-який код помилки Ayrshare на просте пояснення причини й способу виправлення, тож agent може самостійно діагностувати.

​
Приклад 1: чернетка, валідація й публікація з повідомлення чату

“Hello world” цієї інтеграції. Запустіть workflow повідомленням чату або формою, і решту зробить agent.
  • Trigger: Chat Trigger (або Form Trigger із полем “що ми маємо опублікувати?”).
  • Промпт для agent: “Напиши дружнє оголошення про запуск нашого нового аналітичного дашборду й опублікуй його у LinkedIn, Facebook та Instagram. Спочатку перевір.”
Що agent робить самостійно: він викликає validate_post з вашим текстом і трьома платформами; якщо Instagram позначає відсутнє зображення, він повідомляє вам замість того, щоб мовчки завершитись помилкою; після успішної валідації він викликає create_post і повертає URL живих дописів. Оскільки валідація виконується першою, ви дізнаєтесь про проблему до того, як щось стане публічним.

​
Приклад 2: автоматична публікація нового контенту в усіх ваших каналах

Перетворіть джерело контенту на дописи в кількох мережах, не торкаючись його.
  • Trigger: вузол RSS Read на стрічці вашого блогу, webhook з вашої CMS або новий рядок у Google Sheets чи Airtable.
  • Крок AI Agent: “Стисни цю статтю до короткого соціального допису з 2–3 релевантними хештегами, потім перевір і опублікуй у LinkedIn, Facebook та Threads.”
  • Опціонально додайте human-in-the-loop підтвердження перед кроком create_post, щоб хтось із людей затверджував.
Ви можете покластися на recommend_hashtags для тегів на основі даних і generate_post, якщо хочете, щоб Ayrshare генерував текст, а не ваша модель чату.

​
Приклад 3: щотижнева аналітична розсилка

Запустіть цикл у зворотному напрямку: читайте продуктивність і звітуйте про неї.
  • Trigger: вузол Schedule, наприклад, щопонеділка о 8:00.
  • Крок AI Agent: “Витягни аналітику облікового запису за минулий тиждень для LinkedIn, Instagram і Facebook і зроби зведення з топ-3 дописів за залученістю.”
  • Agent використовує get_social_network_analytics для показників на рівні облікового запису і get_post_analytics для окремих дописів, а потім ви передаєте його зведення до вузла Slack, Gmail або Notion.
Примітка про частоту: більшість дописів отримують основну частину залученості в перші 24 години, а метрики не оновлюються щосекунди. Щоденного або щотижневого розкладу цілком достатньо. Не опитуйте аналітику кожні кілька хвилин, інакше ви впретесь у rate limits за відсутності нових даних.

​
Дії від імені клієнтів (multi-tenant)

Якщо ви керуєте соціальними мережами для кількох клієнтів, профілі Ayrshare дозволяють одному обліковому запису публікувати в багато окремих наборів прив’язаних облікових записів. На Business or Enterprise plan у вас є два способи націлитись на клієнта з n8n:
  • На підключення: додайте заголовок Profile-Key до вузла MCP Client Tool (використовуйте автентифікацію Multiple Headers, щоб можна було надсилати як Authorization, так і Profile-Key). Кожен виклик на цьому вузлі тоді діятиме як від імені цього клієнта. Підходить, коли workflow обслуговує одного клієнта.
  • На виклик: багато інструментів приймають аргумент profileKey, який agent може встановлювати для кожної дії. Коли присутні обидва, аргумент на виклик має перевагу. Підходить, коли один workflow маршрутизує між клієнтами.
Щоб додати нового клієнта, agent може викликати create_profile, а потім generate_jwt_social_linking_url, щоб згенерувати розміщену сторінку, де клієнт прив’язує власні облікові записи. Жодні credentials не проходять через ваш workflow.

​
Публікація у X/Twitter

У n8n переключіть Authentication вузла MCP Client Tool на Multiple Headers і додайте два заголовки X-Twitter-OAuth1-* разом із Authorization. Це одноразове налаштування на обліковий запис Ayrshare, і та ж пара ключів застосовується до кожного профілю. Для всього іншого (Facebook, Instagram, LinkedIn, YouTube, TikTok тощо) додаткові заголовки не потрібні. Див. Connect & Setup → X/Twitter BYO credentials.

​
Тримайте людину в циклі

Інструменти MCP роблять публікацію тривіальною для agent, і саме тому вам варто її обмежити. Два дешевих запобіжники:
  • Завжди спочатку валідуйте. Внесіть у системний промпт: “викликай validate_post перед create_post”. Валідація нічого не публікує та рано ловить порушення правил платформи.
  • Додайте крок затвердження. Вставте вузол n8n Send and Wait for Response (Slack або email) між чернеткою й дією публікації, щоб людина затвердила перед виходом у публікацію. Для запланованого контенту agent може використовувати update_post, щоб редагувати допис, що чекає на затвердження.

​
REST fallback (без agent)

Якщо ви хочете фіксований, детермінований workflow без LLM, пропустіть MCP і викликайте REST API через вузол HTTP Request:
  • Method: POST
  • URL: https://api.ayrshare.com/api/post
  • Authentication: Header Auth, Authorization: Bearer YOUR_API_KEY
Використовуйте хост API api.ayrshare.com, а не хост Dashboard app.ayrshare.com. (app.ayrshare.com прийматиме API-виклики, але це не задокументований endpoint, і він може повертати нерегулярні 502/504 gateway errors, тож завжди використовуйте api.ayrshare.com.) Той самий підхід працює для інших REST endpoints. Це правильний інструмент, коли workflow повністю передбачуваний, і вам не потрібен agent, який щось вирішує.

​
Усунення несправностей

Ви також можете надати agent’у інструмент explain_error, щоб він самостійно розшифровував будь-який код помилки Ayrshare у причину й спосіб виправлення.

​
Наступні кроки

Connect & Setup

Endpoint, транспорт, автентифікація, націлення профілю та BYO credentials.

Tool Catalog

27 інструментів, згрупованих за доменом, з областю дії та призначенням.

MCP Server

Що таке MCP Server і як він відповідає Ayrshare API.

Claude Code Plugin

Той самий сервер, упакований для Claude Code.