Перейти до основного вмісту
MCP Server від Ayrshare дозволяє ШІ-агенту керувати Ayrshare API. Ця сторінка описує, як під’єднатися до нього та як працює автентифікація.

​
Кінцева точка та транспорт

Виробничий MCP Server доступний за адресою: https://api.ayrshare.com/mcp Він використовує Streamable HTTP транспорт і є stateless — між викликами немає сесії, яку потрібно підтримувати.

​
Автентифікація

Автентифікацію застосовує той самий ланцюг Ayrshare API, який забезпечує REST API.
  • Обов’язково: Authorization: Bearer YOUR_API_KEY — API-ключ Вашого облікового запису (ключ плану Business для profiles та sub-profiles).
  • Опціонально: Profile-Key: YOUR_PROFILE_KEY — таргетує sub-profile для кожного виклику на з’єднанні.
  • Опціонально на виклик: аргумент інструменту profileKey — таргетує sub-profile для одного виклику інструменту.

​
Пріоритет: аргумент виграє над заголовком

Коли виклик інструменту включає аргумент profileKey та з’єднання має заголовок Profile-Key, аргумент profileKey для конкретного виклику виграє. Заголовок використовується лише коли не надано дійсного аргументу. Один виняток: у get_platform_history та get_social_network_analytics пошук userId/userName X/Twitter має використовувати лише API-ключ облікового запису; надання аргументу profileKey або заголовка Profile-Key там повертає помилку 400.
MCP-методи initialize та tools/list доступні до автентифікації — вони повертають лише метадані та нічого не виконують. Кожен виклик інструменту автентифікується.

​
Помилки автентифікації

Неавтентифікований або недійсний ключ у виклику інструменту повертає помилку 403 / код 102 Ayrshare з повідомленням “API Key not valid”. Згідно зі специфікацією MCP, помилки виконання інструментів повертаються в межах: результат інструменту містить isError: true та це повідомлення, тоді як сам MCP-транспорт відповідає HTTP 200. (403/102 — це помилка застосунку Ayrshare, а не статус транспорту.)

​
Під’єднання

​
Варіант A: плагін Claude Code

Якщо Ви використовуєте Claude Code, встановіть плагін Ayrshare. Він включає конфігурацію MCP Server, команду налаштування, агентів, навички та hook підтвердження. Повні кроки встановлення див. на сторінці Claude Code Plugin.

​
Варіант B: будь-який MCP-клієнт

Для будь-якого MCP-клієнта, який підтримує Streamable HTTP, зареєструйте сервер безпосередньо. У Claude Code:
Щоб таргетувати sub-profile на кожному виклику, додайте опціональний заголовок Profile-Key:
Під’єднання MCP ініціалізується на початку сесії. Перезапустіть Ваш MCP-клієнт після встановлення сервера або зміни ключа, щоб нова конфігурація набула чинності.

​
X/Twitter BYO credentials

Починаючи з 31 березня 2026 року, операції X/Twitter через Ayrshare вимагають Ваших власних облікових даних OAuth 1.0a. Коли виклик інструменту таргетує X/Twitter, передавайте ці два заголовки на з’єднанні разом з Вашими заголовками Authorization (та опціональним Profile-Key): Це ті самі заголовки, які використовує REST API — одна пара OAuth 1.0a ключів на обліковий запис Ayrshare, надсилається на кожному запиті, спрямованому на X (та сама пара застосовується до всіх sub-profiles). Ayrshare не використовує OAuth 2.0 тут. Див. API Overview та X BYO Key Setup Guide для налаштування, політики та усунення несправностей.
Без цих заголовків виклик інструменту X/Twitter повертає помилку 419 (x_credentials_required).

​
Під’єднання з заголовками BYO

Щоб налаштувати облікові дані X/Twitter BYO з самого початку, додайте сервер з обома заголовками OAuth 1.0a разом з Вашим заголовком Authorization (включно з Profile-Key, якщо Ви таргетуєте sub-profile на кожному виклику):

​
Додавання заголовків BYO до існуючого з’єднання

Заголовки з’єднання фіксуються, коли сервер додається, тому, якщо Ви вже під’єдналися без заголовків BYO, видаліть сервер і додайте його знову з повним набором (повторно включіть будь-які заголовки, які Ви вже використовували, наприклад Profile-Key):
Перезапустіть Ваш MCP-клієнт після зміни заголовків, щоб нова конфігурація набула чинності. Використовуєте плагін Claude Code замість необробленого з’єднання? Див. Claude Code Plugin → X/Twitter BYO credentials.

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

Каталог інструментів

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

Плагін Claude Code

Встановіть плагін Ayrshare для Claude Code.