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

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

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

​
Підтримувані клієнти

Action MCP Server автентифікується лише за допомогою статичного заголовка запиту Authorization: Bearer. Ця єдина вимога визначає все наведене нижче: клієнт, який може встановити користувацький HTTP-заголовок на з’єднанні Streamable HTTP, може автентифікуватися, а клієнт, який не може, — не може. Знайдіть Вашого клієнта, перш ніж починати налаштування.

​
Чому персональні конектори не можуть автентифікуватися

Action MCP від Ayrshare вимагає статичного заголовка Authorization: Bearer. Додавання його як персонального користувацького конектора на claude.ai, у Claude Desktop або Claude mobile не працює, оскільки Ayrshare не публікує метадані OAuth, а альтернатива із заголовком запиту — це бета, обмежена схваленими організаціями. На персональному конекторі жодне налаштування з Вашого боку цього не виправляє: немає поля для заголовка Authorization і немає API-ключа, профілю чи налаштування облікового запису, яке б його увімкнуло. Ayrshare не публікує метадані OAuth, тому шляху OAuth конектора немає до чого під’єднуватися. Натомість використовуйте клієнта з таблиці вище: Claude Code, плагін Claude Code або будь-який клієнт, який дозволяє встановити користувацький заголовок Authorization. Якщо Ви є адміністратором організації в беті заголовків запиту Anthropic, див. Організації Team та Enterprise нижче.
Якщо Ваш конектор виглядає справним, але кожен інструмент дає збій. Конектор додається без проблем, звітує статус справний і показує повний каталог інструментів — а потім кожен виклик інструменту повертає помилку Ayrshare 403 / код 102, “API Key not valid”. Це саме це обмеження, а не зламаний ключ — Ваш клієнт не може надіслати статичний заголовок Authorization: Bearer, якого вимагає цей сервер. initialize та tools/list доступні до автентифікації (див. Автентифікація нижче), тому ніщо не дає збою до першого виклику інструменту, коли стає зрозуміло, що жодні облікові дані так і не були надіслані.Обмеження клієнта чи справді недійсний ключ? Вони повертають ідентичну помилку, тому розрізняйте їх за сигнатурою. Збій через можливості клієнта означає, що конектор справний і кожен інструмент дає збій, тоді як той самий ключ працює деінде. Недійсний ключ дає ту саму помилку, але відтворюється поза конектором — він дає збій і на REST-виклику. Про саму семантику помилок див. Помилки автентифікації нижче.

​
Організації Team та Enterprise

Механізм static_headers від Anthropic дозволяє користувацькому конектору надсилати фіксовані облікові дані як заголовок запиту замість використання OAuth. Він доступний у бета-версії адміністраторам організацій в обмеженому наборі організацій і не доступний окремим користувачам, які додають персональний конектор. Якщо Ваша організація має доступ, адміністратор має ввести значення заголовка як Bearer , за яким слідує Ваш API-ключ Ayrshare, включно з пробілом — Claude надсилає значення точно так, як його введено, і не додає схему за Вас. Про поточну доступність і налаштування див. документацію Anthropic з автентифікації конекторів.
Ключ спільний для всієї організації. Облікові дані заголовка запиту Anthropic вводяться один раз адміністратором і використовуються кожним членом організації, тому всі вони діють як єдиний обліковий запис Ayrshare, якому належить цей ключ — з доступом до кожного User Profile під ним на ключі Business і без атрибуції за користувачами у Вашій історії чи аналітиці Ayrshare. Ставтеся до нього як до спільних службових облікових даних, а не як до індивідуального доступу.

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

Автентифікацію застосовує той самий ланцюг 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.

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

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

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

Плагін Claude Code

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