> ## 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. # Під'єднання до MCP Server > Під'єднайте будь-якого клієнта MCP до Ayrshare MCP Server — транспорт, кінцева точка та автентифікація. [MCP Server](/additional/mcp-action-server) від Ayrshare дозволяє ШІ-агенту керувати Ayrshare API. Ця сторінка описує, як під'єднатися до нього та як працює автентифікація. ## Кінцева точка та транспорт Виробничий MCP Server доступний за адресою: `https://api.ayrshare.com/mcp` Він використовує **Streamable HTTP** транспорт і є **stateless** — між викликами немає сесії, яку потрібно підтримувати. ## Автентифікація Автентифікацію застосовує той самий ланцюг Ayrshare API, який забезпечує REST API. ### Пріоритет: аргумент виграє над заголовком Коли виклик інструменту включає аргумент `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](/additional/mcp-claude-code-plugin). ### Варіант B: будь-який MCP-клієнт Для будь-якого MCP-клієнта, який підтримує Streamable HTTP, зареєструйте сервер безпосередньо. У Claude Code: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` Щоб таргетувати sub-profile на кожному виклику, додайте опціональний заголовок `Profile-Key`: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Profile-Key: YOUR_PROFILE_KEY" ``` Під'єднання MCP ініціалізується на початку сесії. **Перезапустіть Ваш MCP-клієнт** після встановлення сервера або зміни ключа, щоб нова конфігурація набула чинності. ## X/Twitter BYO credentials Починаючи з 31 березня 2026 року, операції X/Twitter через Ayrshare вимагають Ваших власних облікових даних OAuth 1.0a. Коли виклик інструменту таргетує X/Twitter, передавайте ці два заголовки на з'єднанні разом з Вашими заголовками `Authorization` (та опціональним `Profile-Key`): | Заголовок | Опис | | ----------------------------- | ----------------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Ваш OAuth 1.0a API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Ваш OAuth 1.0a API Key Secret (Consumer Secret) | Це ті самі заголовки, які використовує REST API — одна пара OAuth 1.0a ключів на обліковий запис Ayrshare, надсилається на кожному запиті, спрямованому на X (та сама пара застосовується до всіх sub-profiles). Ayrshare не використовує OAuth 2.0 тут. Див. [API Overview](/apis/overview#xtwitter-byo-credentials) та [X BYO Key Setup Guide](/dashboard/connect-social-accounts/x-twitter-byo-keys) для налаштування, політики та усунення несправностей. Без цих заголовків виклик інструменту X/Twitter повертає помилку `419` (`x_credentials_required`). ### Під'єднання з заголовками BYO Щоб налаштувати облікові дані X/Twitter BYO з самого початку, додайте сервер з обома заголовками OAuth 1.0a разом з Вашим заголовком `Authorization` (включно з `Profile-Key`, якщо Ви таргетуєте sub-profile на кожному виклику): ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` ### Додавання заголовків BYO до існуючого з'єднання Заголовки з'єднання фіксуються, коли сервер додається, тому, якщо Ви вже під'єдналися без заголовків BYO, видаліть сервер і додайте його знову з повним набором (повторно включіть будь-які заголовки, які Ви вже використовували, наприклад `Profile-Key`): ```bash theme={"system"} claude mcp remove ayrshare claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` Перезапустіть Ваш MCP-клієнт після зміни заголовків, щоб нова конфігурація набула чинності. Використовуєте плагін Claude Code замість необробленого з'єднання? Див. [Claude Code Plugin → X/Twitter BYO credentials](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials). ## Наступні кроки 27 інструментів, згрупованих за доменом, з областю дії та призначенням. Встановіть плагін Ayrshare для Claude Code.