ping
Перевіряє підключення і показує, скільки проєктів доступно ключу.
Приклад запитання: «Перевір, чи працює підключення до VYDAI.»
Що можна уточнити: Нічого.
// MCP-сервер VYDAI · документація
Усе, що потрібно, щоб підключити VYDAI до AI-асистента і розуміти його відповіді: повний список інструментів, налаштування для кожного асистента, обмеження і розв’язання типових проблем.
MCP (Model Context Protocol) — відкритий стандарт, через який AI-асистент бере дані з інших сервісів. VYDAI має MCP-сервер за адресою https://vydai.inweb.ua/mcp, і асистент звертається до нього, коли ваше запитання стосується AI-видимості бренду.
Ви ставите запитання звичайною мовою, асистент сам обирає потрібні інструменти VYDAI, отримує дані й формулює відповідь. Інструмент — це окремий запит до VYDAI, наприклад «видимість за період» чи «список промптів».
Доступ працює через персональний ключ, який ви створюєте в кабінеті. Для ключа ви обираєте всі свої проєкти або лише деякі. Ключ тільки читає дані: нічого не змінює, не запускає перевірок і не витрачає баланс.
Сервер має 16 інструментів і 2 готові шаблони. Назви інструментів знати не обов’язково: асистент добирає їх сам. Вони наведені, щоб ви бачили, звідки береться відповідь.
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-системи.
get_prompt_answersОстанні відповіді AI-систем на конкретний промпт: дата, система, модель, текст відповіді (до 2000 символів) і до 15 джерел.
Приклад запитання: «Що саме відповів ChatGPT на промпт про доставку минулого тижня?»
Що можна уточнити: Проєкт і промпт. Додатково можна обрати AI-систему, період і кількість відповідей від 1 до 5 (за замовчуванням 3).
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 покаже готову команду чи фрагмент налаштувань уже з вашим ключем. Нижче ті самі інструкції з позначкою <ваш ключ> замість ключа.
Підключення однією командою в терміналі, однаково на macOS і Windows.
--scope user.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 vydaiClaude Desktop підключається через невелику програму-посередника mcp-remote, тому на комп’ютері має бути встановлений Node.js. Це безкоштовна програма з nodejs.org, обирайте версію LTS.
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonmcpServers, додайте лише блок vydai всередину нього.{
"mcpServers": {
"vydai": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://vydai.inweb.ua/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <ваш ключ>"
}
}
}
}Запитайте в новому чаті: «Покажи мої проєкти у VYDAI». Інструменти VYDAI також видно в меню інструментів під полем введення.
Видаліть блок vydai з файлу налаштувань і перезапустіть застосунок.
Cursor підключається напряму, без додаткових програм.
~/.cursor/mcp.json%USERPROFILE%\.cursor\mcp.json.cursor/mcp.json усередині проєкту теж працює, але туди ключ краще не класти: такий файл легко випадково додати в репозиторій.mcpServers, додайте лише блок vydai всередину нього.{
"mcpServers": {
"vydai": {
"url": "https://vydai.inweb.ua/mcp",
"headers": {
"Authorization": "Bearer <ваш ключ>"
}
}
}
}У налаштуваннях Cursor, розділ MCP, біля vydai має бути зелена позначка і список інструментів. Потім запитайте в чаті: «Покажи мої проєкти у VYDAI».
Видаліть блок vydai з mcp.json або вимкніть сервер у налаштуваннях Cursor.
Codex читає ключ зі змінної середовища, тому ключ не потрапляє у файл налаштувань. Змінна — це значення, яке зберігає система й передає програмам, що запускаються з терміналу.
~/.codex/config.toml%USERPROFILE%\.codex\config.tomlcodex mcp add сама додає туди запис.~/.zshrc і відкрийте новий термінал.export VYDAI_API_KEY="<ваш ключ>"setx VYDAI_API_KEY "<ваш ключ>"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 вже зібрав.
Для показників видимості, конкурентів, джерел і трафіку. Дати рахуються за київськими календарними днями, обидві межі включно. Для довшого періоду потрібні кілька запитів по частинах.
На один ключ: до 60 викликів аналітичних інструментів за 5 хвилин (видимість, динаміка, промпти, конкуренти, джерела) і до 300 запитів до сервера загалом за 5 хвилин. Після перевищення загального ліміту сервер робить паузу на 5 хвилин.
Якщо інструмент не встигає за 20 секунд, асистент отримує повідомлення, що запит задовгий. Допомагає коротший період або вужчий вибір AI-систем. Те саме радимо, якщо в періоді понад 20 000 перевірок.
Інструмент балансу і лімітів працює тільки з ключем, який має доступ до всіх проєктів. Ключ з обраними проєктами баланс не бачить.
Текст відповіді AI-системи передається до 2000 символів, до 15 джерел на відповідь і до 5 відповідей за раз. Якщо аналітична відповідь завелика, сервер скорочує найдовші списки й позначає, що відповідь неповна.
Відсотки округлено до цілих, як у дашборді VYDAI. Загальний показник і показники окремих AI-систем округлюються окремо, тому можуть трохи не збігатися.
Дані про відвідування з AI-джерел є лише тоді, коли Google Analytics 4 підключено в налаштуваннях проєкту.
Дані проєктів, доступних ключу (усіх або обраних): налаштування, промпти, результати перевірок, відповіді AI-систем, конкуренти, джерела, GEO-аудити і трафік, якщо його підключено. Права перевіряються під час кожного запиту: якщо вас видалять із проєкту, асистент теж перестане його бачити.
Проєктів, не обраних для ключа, і проєктів, до яких у вас немає доступу. Він нічого не змінює, не запускає перевірок і не витрачає баланс.
Повний ключ ми показуємо один раз, під час створення. У базі лишається лише його хеш SHA-256, з якого ключ не відновити. У кабінеті видно назву ключа, його початок, термін дії і коли ним востаннє користувались.
Ключ може діяти 30, 90 чи 365 днів або без обмеження. Відкликати його можна будь-коли в кабінеті: наступний запит із цим ключем сервер відхилить.
Кожен виклик інструмента ми записуємо: яким ключем, який інструмент, по якому проєкту, коли і з якої адреси. Самих даних, які отримав асистент, у журналі немає. Він потрібен, щоб розібратися, що саме прочитали, якщо ключ потрапить у чужі руки. Записи зберігаються 180 днів.
Так простіше контролювати доступ: відкликання одного ключа не зачепить інших, а в кабінеті видно, коли працював кожен. Не діліться ключем і не додавайте його у файли, які потрапляють у спільний репозиторій.
Тексти відповідей 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 у планах. Дат поки немає. Коли воно з’явиться, ми оновимо цю сторінку.