// MCP-сервер VYDAI · документація

Документація MCP-сервера

Усе, що потрібно, щоб підключити VYDAI до AI-асистента і розуміти його відповіді: повний список інструментів, налаштування для кожного асистента, обмеження і розв’язання типових проблем.

Зміст сторінки

Що це і як працює

MCP (Model Context Protocol) — відкритий стандарт, через який AI-асистент бере дані з інших сервісів. VYDAI має MCP-сервер за адресою https://vydai.inweb.ua/mcp, і асистент звертається до нього, коли ваше запитання стосується AI-видимості бренду.

Ви ставите запитання звичайною мовою, асистент сам обирає потрібні інструменти VYDAI, отримує дані й формулює відповідь. Інструмент — це окремий запит до VYDAI, наприклад «видимість за період» чи «список промптів».

Доступ працює через персональний ключ, який ви створюєте в кабінеті. Для ключа ви обираєте всі свої проєкти або лише деякі. Ключ тільки читає дані: нічого не змінює, не запускає перевірок і не витрачає баланс.

Що можна запитати

Сервер має 16 інструментів і 2 готові шаблони. Назви інструментів знати не обов’язково: асистент добирає їх сам. Вони наведені, щоб ви бачили, звідки береться відповідь.

Що можна уточнити
  • Проєкт. Асистент знаходить його сам через список проєктів, тому достатньо назвати проєкт або домен.
  • Період. Дати початку й кінця за київським часом, обидві включно. Для показників видимості, конкурентів, джерел і трафіку — до 92 днів. Можна казати «за жовтень» чи «за останні два тижні», асистент перетворить це на дати.
  • AI-системи. Відповідь можна обмежити окремими системами: ChatGPT (openai), Gemini (gemini), Claude (claude), Google AI Overviews (google_aio), Google AI Mode (google_ai_mode).

Проєкти і промпти

ping

Перевіряє підключення і показує, скільки проєктів доступно ключу.

Приклад запитання: «Перевір, чи працює підключення до VYDAI.»

Що можна уточнити: Нічого.

list_projects

Список проєктів, доступних ключу: назва, домен, регіон і статус.

Приклад запитання: «Покажи мої проєкти у VYDAI.»

Що можна уточнити: Нічого.

get_project

Налаштування проєкту: варіанти назви бренду, AI-системи, розклад перевірок, кількість активних промптів, до 50 конкурентів і дата останньої перевірки.

Приклад запитання: «Які AI-системи й конкуренти налаштовані в проєкті example.com?»

Що можна уточнити: Проєкт.

list_prompts

Промпти проєкту, тобто запитання, які VYDAI ставить AI-системам: текст, категорія, системи і дата останньої перевірки.

Приклад запитання: «Покажи активні промпти в категорії „Ціни“.»

Що можна уточнити: Проєкт, категорія, лише активні чи всі (за замовчуванням лише активні), до 200 промптів.

Видимість і динаміка

get_visibility_summary

Головні показники за період: видимість бренду у відсотках, кількість згадок і перевірок, розбивка за AI-системами, частка відповідей із Google AI Overviews і зміна до попереднього такого самого періоду.

Приклад запитання: «Яка видимість нашого бренду за жовтень і як вона змінилась до вересня?»

Що можна уточнити: Проєкт, період, AI-системи.

get_visibility_trend

Видимість по днях або тижнях за період, з розбивкою за AI-системами.

Приклад запитання: «Як змінювалась видимість по тижнях за останні три місяці?»

Що можна уточнити: Проєкт, період, AI-системи, крок: день або тиждень (за замовчуванням день).

get_prompt_breakdown

Видимість за кожним промптом: скільки перевірок і згадок, у яких системах. Окремо можна отримати промпти, які втратили або здобули згадку бренду за період.

Приклад запитання: «За якими промптами нас перестали згадувати цього місяця?»

Що можна уточнити: Проєкт, період, AI-системи, категорія, сортування (втрачені, здобуті, від найнижчої або найвищої видимості), до 100 промптів.

Конкуренти і джерела

get_competitor_share

Видимість вашого бренду і конкурентів за період, кількість згадок, розбивка за AI-системами і зміна до попереднього періоду.

Приклад запитання: «Хто з конкурентів виріс за останній місяць?»

Що можна уточнити: Проєкт, період, AI-системи.

get_top_sources

Домени, які AI-системи цитують найчастіше: до 10 головних, а також до 6 нових і 6 втрачених джерел: порівнюються перший і останній день періоду, за які є результати перевірок.

Приклад запитання: «Які сайти AI цитує найчастіше в наших відповідях?»

Що можна уточнити: Проєкт, період, AI-системи.

Відповіді AI

get_prompt_answers

Останні відповіді AI-систем на конкретний промпт: дата, система, модель, текст відповіді (до 2000 символів) і до 15 джерел.

Приклад запитання: «Що саме відповів ChatGPT на промпт про доставку минулого тижня?»

Що можна уточнити: Проєкт і промпт. Додатково можна обрати AI-систему, період і кількість відповідей від 1 до 5 (за замовчуванням 3).

GEO-аудит і перевірки

list_geo_audits

Останні GEO-аудити сайту, до 20. GEO (Generative Engine Optimization) — оптимізація сайту під відповіді AI-систем.

Приклад запитання: «Які GEO-аудити ми робили?»

Що можна уточнити: Проєкт.

get_geo_audit

Результат одного аудиту: загальна оцінка, оцінки за категоріями і до 10 головних проблем, спершу блокери.

Приклад запитання: «Що показав останній GEO-аудит і що виправити першим?»

Що можна уточнити: Проєкт, аудит.

get_check_status

Стан останньої перевірки і перевірки, що завершились помилкою за останні 7 днів.

Приклад запитання: «Чи пройшла сьогоднішня перевірка без помилок?»

Що можна уточнити: Проєкт.

Трафік і баланс

get_ai_traffic

Відвідування з AI-джерел і до 10 головних сторінок входу за даними Google Analytics 4. Працює, якщо GA4 підключено в налаштуваннях проєкту.

Приклад запитання: «Скільки відвідувачів прийшло з AI-асистентів цього місяця?»

Що можна уточнити: Проєкт, період.

get_billing_summary

Баланс, ліміти й використання вашого акаунта. Доступно лише для ключа з доступом до всіх проєктів.

Приклад запитання: «Скільки лімітів лишилось цього місяця?»

Що можна уточнити: Нічого.

Публічні рейтинги

get_topic_leaderboard

Лідери публічного рейтингу VYDAI за темою і дата останнього оновлення.

Приклад запитання: «Які бренди лідирують у рейтингу онлайн-магазинів електроніки?»

Що можна уточнити: Тема: частина адреси рейтингу між /rating/ і -ai-visibility; від 1 до 20 брендів (за замовчуванням 20).

Готові шаблони

Шаблон — це підготовлене завдання, яке асистент виконує кількома інструментами поспіль. В асистентах, які підтримують шаблони MCP, вони з’являються як готові команди. У Claude Code їх видно в меню, що відкривається символом /.

monthly_visibility_report

Місячний звіт про видимість: головний висновок, зміни показників, динаміка, промпти, що здобули чи втратили згадку, позиція серед конкурентів і застереження.

Що можна уточнити: Проєкт і місяць у форматі РРРР-ММ.

lost_mentions_review

Розбір втрачених згадок: які промпти втратили бренд, що відповіли AI-системи, ймовірні причини і наступні кроки.

Що можна уточнити: Проєкт, дати початку й кінця.

Підключення

Спершу створіть ключ у кабінеті, розділ «AI-асистенти». Там же VYDAI покаже готову команду чи фрагмент налаштувань уже з вашим ключем. Нижче ті самі інструкції з позначкою <ваш ключ> замість ключа.

Claude Code

Підключення однією командою в терміналі, однаково на macOS і Windows.

Де налаштування

  • Файл редагувати не потрібно: команда сама зберігає налаштування Claude Code.
  • За замовчуванням VYDAI буде доступний у папці, де ви виконали команду. Щоб він працював у всіх папках, додайте до команди --scope user.

Як підключити

  1. Виконайте в терміналі:
    Термінал
    claude mcp add --transport http vydai https://vydai.inweb.ua/mcp --header "Authorization: Bearer <ваш ключ>"

Як перевірити

Виконайте claude mcp list: поруч із vydai має бути позначка про підключення. Потім запитайте в Claude Code: «Покажи мої проєкти у VYDAI».

Як відключити

Виконайте команду. Якщо додавали з --scope user, допишіть це й тут.

Термінал
claude mcp remove vydai

Claude Desktop

Claude Desktop підключається через невелику програму-посередника mcp-remote, тому на комп’ютері має бути встановлений Node.js. Це безкоштовна програма з nodejs.org, обирайте версію LTS.

Де налаштування

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Найпростіше відкрити файл із самого застосунку: Settings → Developer → Edit Config.

Як підключити

  1. Вставте фрагмент у файл. Якщо там уже є розділ mcpServers, додайте лише блок vydai всередину нього.
    claude_desktop_config.json
    {
      "mcpServers": {
        "vydai": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://vydai.inweb.ua/mcp",
            "--header",
            "Authorization:${AUTH_HEADER}"
          ],
          "env": {
            "AUTH_HEADER": "Bearer <ваш ключ>"
          }
        }
      }
    }
  2. Повністю закрийте Claude Desktop (на macOS — Cmd+Q, на Windows — через значок у системному треї) і відкрийте знову.

Як перевірити

Запитайте в новому чаті: «Покажи мої проєкти у VYDAI». Інструменти VYDAI також видно в меню інструментів під полем введення.

Як відключити

Видаліть блок vydai з файлу налаштувань і перезапустіть застосунок.

Cursor

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

Де налаштування

  • macOS: ~/.cursor/mcp.json
  • Windows: %USERPROFILE%\.cursor\mcp.json
  • Файл .cursor/mcp.json усередині проєкту теж працює, але туди ключ краще не класти: такий файл легко випадково додати в репозиторій.

Як підключити

  1. Вставте фрагмент у файл. Якщо там уже є розділ mcpServers, додайте лише блок vydai всередину нього.
    mcp.json
    {
      "mcpServers": {
        "vydai": {
          "url": "https://vydai.inweb.ua/mcp",
          "headers": {
            "Authorization": "Bearer <ваш ключ>"
          }
        }
      }
    }
  2. Збережіть файл. Якщо VYDAI не з’явився в налаштуваннях Cursor у розділі MCP, перезапустіть Cursor.

Як перевірити

У налаштуваннях Cursor, розділ MCP, біля vydai має бути зелена позначка і список інструментів. Потім запитайте в чаті: «Покажи мої проєкти у VYDAI».

Як відключити

Видаліть блок vydai з mcp.json або вимкніть сервер у налаштуваннях Cursor.

Codex

Codex читає ключ зі змінної середовища, тому ключ не потрапляє у файл налаштувань. Змінна — це значення, яке зберігає система й передає програмам, що запускаються з терміналу.

Де налаштування

  • macOS: ~/.codex/config.toml
  • Windows: %USERPROFILE%\.codex\config.toml
  • Файл редагувати не потрібно: команда codex mcp add сама додає туди запис.

Як підключити

  1. macOS: додайте рядок у кінець файлу ~/.zshrc і відкрийте новий термінал.
    ~/.zshrc
    export VYDAI_API_KEY="<ваш ключ>"
  2. Windows: виконайте команду і відкрийте нове вікно терміналу. Відкриті вікна нову змінну не побачать.
    Командний рядок Windows
    setx VYDAI_API_KEY "<ваш ключ>"
  3. Додайте сервер у новому терміналі:
    Термінал
    codex mcp add vydai --url https://vydai.inweb.ua/mcp --bearer-token-env-var VYDAI_API_KEY

Як перевірити

Виконайте codex mcp list: у списку має бути vydai. Потім запустіть Codex з того самого терміналу і запитайте: «Покажи мої проєкти у VYDAI».

Як відключити

Виконайте команду, а потім видаліть рядок із ~/.zshrc або змінну VYDAI_API_KEY у змінних середовища Windows.

Термінал
codex mcp remove vydai

Обмеження

Ці обмеження захищають ваші дані й стабільність сервісу. Якщо асистент упирається в одне з них, допомагає простий крок: розбити довгий період на частини або звузити вибір AI-систем.

Лише читання

Асистент не може змінити промпти чи налаштування, запустити перевірку, видалити дані або витратити баланс. Він бачить лише те, що VYDAI вже зібрав.

Період до 92 днів

Для показників видимості, конкурентів, джерел і трафіку. Дати рахуються за київськими календарними днями, обидві межі включно. Для довшого періоду потрібні кілька запитів по частинах.

Ліміти запитів

На один ключ: до 60 викликів аналітичних інструментів за 5 хвилин (видимість, динаміка, промпти, конкуренти, джерела) і до 300 запитів до сервера загалом за 5 хвилин. Після перевищення загального ліміту сервер робить паузу на 5 хвилин.

20 секунд на відповідь

Якщо інструмент не встигає за 20 секунд, асистент отримує повідомлення, що запит задовгий. Допомагає коротший період або вужчий вибір AI-систем. Те саме радимо, якщо в періоді понад 20 000 перевірок.

Баланс лише для повного доступу

Інструмент балансу і лімітів працює тільки з ключем, який має доступ до всіх проєктів. Ключ з обраними проєктами баланс не бачить.

Скорочені тексти

Текст відповіді AI-системи передається до 2000 символів, до 15 джерел на відповідь і до 5 відповідей за раз. Якщо аналітична відповідь завелика, сервер скорочує найдовші списки й позначає, що відповідь неповна.

Цілі відсотки

Відсотки округлено до цілих, як у дашборді VYDAI. Загальний показник і показники окремих AI-систем округлюються окремо, тому можуть трохи не збігатися.

Трафік потребує GA4

Дані про відвідування з AI-джерел є лише тоді, коли Google Analytics 4 підключено в налаштуваннях проєкту.

Безпека і дані

Що бачить асистент

Дані проєктів, доступних ключу (усіх або обраних): налаштування, промпти, результати перевірок, відповіді AI-систем, конкуренти, джерела, GEO-аудити і трафік, якщо його підключено. Права перевіряються під час кожного запиту: якщо вас видалять із проєкту, асистент теж перестане його бачити.

Чого асистент не бачить і не робить

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

Як зберігається ключ

Повний ключ ми показуємо один раз, під час створення. У базі лишається лише його хеш SHA-256, з якого ключ не відновити. У кабінеті видно назву ключа, його початок, термін дії і коли ним востаннє користувались.

Термін дії і відкликання

Ключ може діяти 30, 90 чи 365 днів або без обмеження. Відкликати його можна будь-коли в кабінеті: наступний запит із цим ключем сервер відхилить.

Журнал звернень

Кожен виклик інструмента ми записуємо: яким ключем, який інструмент, по якому проєкту, коли і з якої адреси. Самих даних, які отримав асистент, у журналі немає. Він потрібен, щоб розібратися, що саме прочитали, якщо ключ потрапить у чужі руки. Записи зберігаються 180 днів.

Окремий ключ для кожного асистента

Так простіше контролювати доступ: відкликання одного ключа не зачепить інших, а в кабінеті видно, коли працював кожен. Не діліться ключем і не додавайте його у файли, які потрапляють у спільний репозиторій.

Відповіді AI-систем — сторонній текст

Тексти відповідей ChatGPT, Gemini та інших систем написали не ми і не ви. Асистент отримує їх із позначкою, що це дані, а не вказівки. Якщо асистент пропонує щось зробити, посилаючись на такий текст, перевірте це самі.

Хто ще бачить дані

Дані з VYDAI стають частиною вашої розмови з асистентом, і їх обробляє провайдер асистента за своїми правилами. Підключайте лише ті проєкти, якими готові ділитися з цим асистентом.

Якщо не працює

Найчастіші проблеми і що з ними робити. Якщо нічого не допомогло, створіть новий ключ і підключіть його заново.

Що бачитеПричинаЩо зробити
Помилка 401 або unauthorizedКлюч скопійовано не повністю, його відкликано, минув термін дії або в налаштуваннях немає заголовка Authorization: Bearer <ключ>.Перевірте ключ у кабінеті, розділ «AI-асистенти». Якщо він неактивний, створіть новий і замініть у налаштуваннях.
Project not found or not accessibleПроєкт не обрано для цього ключа, у вас більше немає доступу до проєкту або асистент передав неправильний ідентифікатор.Попросіть асистента спершу показати список проєктів. Якщо потрібного немає, створіть ключ з цим проєктом.
Асистент не бачить інструментів VYDAIАсистент не перезапущено після зміни налаштувань, файл лежить не там або в ньому синтаксична помилка (зайва чи пропущена кома, дужка).Перевірте шлях до файлу в розділі «Підключення», перевірте коми й дужки, перезапустіть асистента повністю.
Claude Desktop не запускає VYDAIНе встановлено Node.js, тому команда npx недоступна.Встановіть версію LTS (з довгостроковою підтримкою) з nodejs.org, перевірте командою node -v і перезапустіть Claude Desktop.
Codex не підключається, хоча ключ правильнийЗмінна VYDAI_API_KEY не задана в терміналі, з якого запущено Codex.Відкрийте новий термінал, перевірте змінну (echo $VYDAI_API_KEY на macOS, echo %VYDAI_API_KEY% у командному рядку Windows) і запустіть Codex звідти.
Rate limit for analytics tools reachedЗа 5 хвилин ключ зробив понад 60 викликів аналітичних інструментів.Зачекайте кілька хвилин. Щоб не впиратися в ліміт, просіть ширшу відповідь одним запитанням замість багатьох дрібних.
Помилка 429 або Too many requestsЗа 5 хвилин ключ зробив понад 300 запитів до сервера, або з вашої адреси було багато спроб із неправильним ключем.Зачекайте 5–10 хвилин і перевірте, чи правильний ключ у налаштуваннях.
Period is longer than 92 daysЗапитано період довший за 92 дні.Попросіть асистента розбити період на частини до 92 днів, наприклад по кварталах.
The request took too longДаних за період забагато, щоб обробити за 20 секунд.Скоротіть період або обмежте AI-системи.

Питання й відповіді

Чому цифри в асистента відрізняються від дашборда?

Найчастіше через різні періоди. VYDAI рахує за київськими календарними днями, обидві дати включно. Попросіть асистента назвати точні дати й AI-системи, за якими він рахував, і виставте ті самі в дашборді.

Асистент запускає нову перевірку, коли я питаю?

Ні. Він читає результати, які VYDAI вже зібрав за розкладом. Дату останньої перевірки асистент може подивитися в налаштуваннях проєкту.

Як дати доступ колезі?

Колега створює власний ключ у своєму кабінеті. Асистент колеги бачитиме лише ті проєкти, до яких колега має доступ у VYDAI. Ділитися своїм ключем не варто.

Чи можна одним ключем підключити кілька асистентів?

Технічно так, але краще створити окремий ключ для кожного. Тоді відкликання одного не зупинить інші, а в кабінеті видно, коли кожен востаннє працював.

Якою мовою відповідає асистент?

Тією, якою ви питаєте. VYDAI передає дані з англійськими назвами полів, а асистент сам формулює відповідь вашою мовою.

Чи з’явиться підключення без копіювання ключа?

Так, підключення однією кнопкою в claude.ai і ChatGPT у планах. Дат поки немає. Коли воно з’явиться, ми оновимо цю сторінку.