> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # n8n > Підключіть AI Agent від n8n до Ayrshare MCP Server, щоб публікувати, планувати й аналізувати в 13 соціальних мережах без коду API для кожної платформи. export const XByoNotice = () => Targeting X/Twitter? Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:

X-Twitter-OAuth1-Api-Key — Your API Key (Consumer Key)
X-Twitter-OAuth1-Api-Secret — Your API Key Secret (Consumer Secret)

One-time setup per Ayrshare account. You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do not create a new app per customer.

Not linked yet? See the full setup guide to connect your X account.

Your keys are never logged or stored by Ayrshare. ; n8n — це місце, де ви з'єднуєте ваші інструменти. Ayrshare — це єдиний API, який публікує у Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat і X одним викликом. Поєднайте їх за допомогою [Ayrshare MCP Server](/additional/mcp-action-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, готовий до імпорту: 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](#rest-fallback-no-agent). ## Чому MCP замість написання API-викликів Ви можете викликати REST API Ayrshare безпосередньо з вузла HTTP Request, і це чудово підходить для фіксованих, передбачуваних workflow. MCP Server має сенс, коли в цикл включена LLM: ## Як це з'єднується Вузол **AI Agent** — це мозок. Підвузол **MCP Client Tool** приєднується до нього, підключається до Ayrshare MCP Server за адресою `https://api.ayrshare.com/mcp`, виявляє доступні інструменти й надає їх agent'у. Коли agent діє, вузол відправляє виклик до Ayrshare, який публікує в мережах. ``` Trigger -> AI Agent (+ Chat Model) -> MCP Client Tool -> Ayrshare MCP Server -> 13 networks ``` Для деталей endpoint, транспорту й автентифікації див. [Connect & Setup](/additional/mcp-action-connect). Повний перелік інструментів див. у [Tool Catalog](/additional/mcp-action-tools). ## Передумови ## Налаштування вузла MCP Client Tool Відкрийте або створіть workflow і додайте вузол **AI Agent** (у розділі *Advanced AI* nodes). На вузлі AI Agent натисніть конектор **Tool** і додайте вузол **MCP Client Tool**. Налаштуйте його: | Поле | Значення | | -------------------- | ----------------------------------------------------------- | | **Endpoint** | `https://api.ayrshare.com/mcp` | | **Server Transport** | `HTTP Streamable` | | **Authentication** | `Bearer Auth` | | **Tools to Include** | `All` (або `Selected`, щоб відкрити лише певні інструменти) | Для **Credential** створіть новий credential **Bearer Auth** і вставте ваш API key Ayrshare як токен. n8n надсилає його як `Authorization: Bearer YOUR_API_KEY`. Коли ви зберігаєте, n8n підключається й перелічує всі 27 інструментів. Приєднайте підвузол **Chat Model** і виберіть credential вашої моделі. Дайте agent'у системний промпт, який задає правила, наприклад: > Ви — асистент з соціальних мереж, який має доступ до інструментів Ayrshare. Перед публікацією будь-чого завжди спочатку викликайте `validate_post` і повідомляйте про будь-які проблеми. Викликайте `create_post` лише після успішної валідації. За замовчуванням використовуйте платформи, названі користувачем; якщо жодних не названо, запитайте. Ніколи не вигадуйте URL-адреси медіа; використовуйте лише URL-адреси, надані користувачем, і підтверджуйте їх за допомогою `validate_media`, якщо є сумніви. Для тестування найпростіше використовувати **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](/additional/mcp-action-tools). Два виділяються для безпеки: **`validate_post`** виконує dry-run допису з тими самими вхідними даними, що й `create_post`, але нічого не публікує, а **`explain_error`** перетворює будь-який код помилки Ayrshare на просте пояснення причини й способу виправлення, тож agent може самостійно діагностувати. ## Приклад 1: чернетка, валідація й публікація з повідомлення чату "Hello world" цієї інтеграції. Запустіть workflow повідомленням чату або формою, і решту зробить agent. Що agent робить самостійно: він викликає `validate_post` з вашим текстом і трьома платформами; якщо Instagram позначає відсутнє зображення, він повідомляє вам замість того, щоб мовчки завершитись помилкою; після успішної валідації він викликає `create_post` і повертає URL живих дописів. Оскільки валідація виконується першою, ви дізнаєтесь про проблему до того, як щось стане публічним. ## Приклад 2: автоматична публікація нового контенту в усіх ваших каналах Перетворіть джерело контенту на дописи в кількох мережах, не торкаючись його. Ви можете покластися на `recommend_hashtags` для тегів на основі даних і `generate_post`, якщо хочете, щоб Ayrshare генерував текст, а не ваша модель чату. ## Приклад 3: щотижнева аналітична розсилка Запустіть цикл у зворотному напрямку: читайте продуктивність і звітуйте про неї. Примітка про частоту: більшість дописів отримують основну частину залученості в перші 24 години, а метрики не оновлюються щосекунди. Щоденного або щотижневого розкладу цілком достатньо. Не опитуйте аналітику кожні кілька хвилин, інакше ви впретесь у rate limits за відсутності нових даних. ## Дії від імені клієнтів (multi-tenant) Якщо ви керуєте соціальними мережами для кількох клієнтів, профілі Ayrshare дозволяють одному обліковому запису публікувати в багато окремих наборів прив'язаних облікових записів. На Business or Enterprise plan у вас є два способи націлитись на клієнта з n8n: Щоб додати нового клієнта, 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](/additional/mcp-action-connect#xtwitter-byo-credentials). ## Тримайте людину в циклі Інструменти MCP роблять публікацію тривіальною для agent, і саме тому вам варто її обмежити. Два дешевих запобіжники: ## REST fallback (без agent) Якщо ви хочете фіксований, детермінований workflow без LLM, пропустіть MCP і викликайте REST API через вузол **HTTP Request**: ```json theme={"system"} { "post": "Excited to announce our new feature!", "platforms": ["facebook", "linkedin", "instagram"], "mediaUrls": ["https://example.com/image.jpg"], "scheduleDate": "2026-07-01T10:00:00Z" } ``` Використовуйте хост API `api.ayrshare.com`, а не хост Dashboard `app.ayrshare.com`. (`app.ayrshare.com` прийматиме API-виклики, але це не задокументований endpoint, і він може повертати нерегулярні [502/504 gateway errors](/help-center/technical-support/response_bad_gateway_502_or_504_error), тож завжди використовуйте `api.ayrshare.com`.) Той самий підхід працює для інших [REST endpoints](/apis/overview). Це правильний інструмент, коли workflow повністю передбачуваний, і вам не потрібен agent, який щось вирішує. ## Усунення несправностей | Симптом | Ймовірна причина | Виправлення | | ------------------------------------------------------------------ | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | | Виклик інструмента повертає `403` / код `102`, "API Key not valid" | Некоректний або відсутній API key | Перевірте, що credential Bearer Auth містить точний ключ Ayrshare. Пересохраніть вузол після зміни. | | n8n не може підключитися до MCP-сервера | Неправильний транспорт або endpoint | Endpoint має бути `https://api.ayrshare.com/mcp`; транспорт має бути **HTTP Streamable**, а не SSE. | | Публікація у X/Twitter завершується помилкою `419` | Відсутні X BYO credentials | Додайте два заголовки `X-Twitter-OAuth1-*` через автентифікацію Multiple Headers. | | Публікація не вдається лише для однієї платформи | Ця мережа не прив'язана, або відсутнє обов'язкове поле | Прив'яжіть її у Dashboard; додайте `title` для YouTube, `title` + `subreddit` для Reddit, `mediaUrls` для Instagram. | | Допис у Instagram відхилено | Немає медіа | Instagram вимагає `mediaUrls` для більшості типів дописів. Нехай agent підтвердить за допомогою `validate_media`. | | Медіа, прикріплене як файл або binary, не з'являється | MCP приймає лише JSON | Посилайтеся на медіа за публічною URL-адресою `mediaUrls`; MCP-шлях не приймає завантаження файлів. Підтвердьте URL за допомогою `validate_media`. | | Виклики працюють, але діють на неправильного клієнта | Націлення профілю | Встановіть заголовок `Profile-Key` (на підключення) або аргумент `profileKey` (на виклик); аргумент перемагає, якщо обидва встановлені. | | `429 Too Many Requests` | Занадто часте опитування | Зменшіть частоту опитування аналітики та коментарів; метрики не оновлюються щосекунди. | | Зміна конфігурації не набула чинності | Підключення MCP ініціалізується на початку сесії | Пересохраніть вузол або перезапустіть workflow після зміни ключа чи заголовків. | Ви також можете надати agent'у інструмент `explain_error`, щоб він самостійно розшифровував будь-який код помилки Ayrshare у причину й спосіб виправлення. ## Наступні кроки Endpoint, транспорт, автентифікація, націлення профілю та BYO credentials. 27 інструментів, згрупованих за доменом, з областю дії та призначенням. Що таке MCP Server і як він відповідає Ayrshare API. Той самий сервер, упакований для Claude Code.