Model Context Protocol (MCP) — це відкритий стандарт, що дозволяє ШІ-помічникам взаємодіяти із зовнішніми інструментами та джерелами даних через структурований інтерфейс. Замість копіювання тексту у вікно чату з надією, що модель зрозуміє контекст, MCP дає помічнику прямий, типізований доступ до ваших систем — читання файлів, виконання пошуку, створення контенту — все через чітко визначені виклики інструментів.

Для команд документації це кардинально змінює процес роботи. Ваш ШІ-помічник перестає бути генератором тексту, що працює з застарілим контекстом, і стає учасником, який читає вашу фактичну документацію, шукає по базі знань і вносить зміни, які ви можете переглянути перед публікацією.

Valoryx поставляється з вбудованим MCP-сервером із 26 інструментами. Жодних плагінів для встановлення, жодного окремого сервісу для запуску — якщо у вас є працюючий екземпляр, MCP-сервер вже там. Усе, що вам потрібно, — це API-ключ.

Що насправді робить MCP

MCP визначає протокол для виявлення та виклику інструментів. ШІ-клієнт (наприклад, Claude Desktop) підключається до MCP-сервера, запитує, які інструменти доступні, та викликає їх зі структурованими параметрами. Сервер виконує операцію та повертає структуровані результати.

Це відрізняється від «ШІ-функцій», прикрученених до продукту. Тут немає пропрієтарної інтеграції. Будь-який MCP-сумісний клієнт працює. Специфікація MCP відкрита, і кілька ШІ-помічників вже підтримують її.

Практичний результат: ви можете попросити Claude «знайти всі сторінки, що згадують автентифікацію», і він дійсно шукатиме у вашому екземплярі документації, а не галюцинуватиме назви сторінок із навчальних даних.

26 вбудованих інструментів

Кожен інструмент має простір імен docplatform_*, тому він ніколи не конфліктує з іншими MCP-серверами у вашому клієнті. Повна довідка на рівні параметрів знаходиться на сторінці MCP; ось повний реєстр за категоріями:

Контент

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

  • docplatform_list_pages — перелік сторінок у підключеному робочому просторі.
  • docplatform_read_page — читання markdown-контенту та метаданих сторінки.
  • docplatform_write_page — запис сторінки: створює її, якщо вона не існує, та оновлює, якщо існує. Єдина операція «просто запиши» для ШІ-агентів.
  • docplatform_update_page — оновлення існуючої сторінки (повертає помилку замість створення — корисно, коли сторінка обов’язково має вже існувати).
  • docplatform_delete_page — видалення сторінки.
  • docplatform_move_page — переміщення сторінки на новий шлях у дереві.

Виявлення та контекст

  • docplatform_search — повнотекстовий пошук по робочому простору з нечітким зіставленням і ранжуванням результатів за релевантністю — той самий рушій Bleve, що керує веб-інтерфейсом.
  • docplatform_get_context — робоча конячка RAG: повертає сторінку разом з її батьківською сторінкою, сусідніми сторінками та цілями її wikilink-посилань за один виклик, тож помічник отримує оточуючий контекст без п’яти окремих запитів.
  • docplatform_get_tree — повне навігаційне дерево робочого простору. Корисно для розуміння структури документації перед внесенням змін.
  • docplatform_list_workspaces — перелік робочих просторів, доступних API-ключу.
  • docplatform_get_manifest — машиночитаний маніфест робочого простору.

Якість

  • docplatform_validate_links — пошук непрацюючих внутрішніх посилань і wikilink-посилань.
  • docplatform_quality_scan — сканування контенту на проблеми з якістю.

Версіонування

  • docplatform_list_versions / docplatform_create_version — перелік і створення іменованих знімків версій.

Коментарі та активність

  • docplatform_list_comments / docplatform_add_comment — читання обговорень сторінок і участь у них.
  • docplatform_get_activity — стрічка нещодавньої активності: хто що змінив і коли.

Керування робочими просторами

  • docplatform_create_workspace / docplatform_get_workspace — створення та перегляд робочих просторів.
  • docplatform_publish_workspace — публікація робочого простору як публічного сайту.

Теми, експорт, ШІ та git-синхронізація

  • docplatform_get_theme / docplatform_update_theme — читання та зміна теми робочого простору.
  • docplatform_export — експорт контенту робочого простору.
  • docplatform_writing_assist — серверна допомога при написанні (покращити, спростити, розширити, підсумувати, виправити граматику, перекласти), коли налаштовано ШІ-провайдера.
  • docplatform_resolve_sync_conflict — розв’язання конфлікту git-синхронізації шляхом вибору однієї зі сторін або надання об’єднаного контенту.

Налаштування Claude Desktop

MCP-сервер спілкується через stdio безпосередньо через бінарний файл docplatform — жодних пакетів-обгорток. Додайте запис у файл конфігурації (на macOS — ~/Library/Application Support/Claude/claude_desktop_config.json; на Windows — %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "docplatform": {
      "command": "docplatform",
      "args": ["mcp", "--workspace", "my-docs", "--api-key", "dp_live_abc123"]
    }
  }
}

Створіть API-ключ у Workspace Settings → API Keys. Він починається з dp_live_ і показується лише один раз. Ключі мають scope-дозволи (read, write, delete — admin вмикається окремо), і кожен MCP-виклик додатково перевіряється проти ролі діючого користувача в робочому просторі, тому ключ редактора (Editor) не може виконувати адміністративні операції незалежно від заявлених scope.

Для віддалених або хмарних екземплярів також доступний транспорт Streamable HTTP (endpoint /mcp) — див. сторінку MCP щодо матриці транспортів і налаштування для кожного клієнта (Claude Code, Cursor, VS Code).

Практичні приклади

Після підключення ось конкретні речі, які ви можете робити:

Аудит узгодженості

"Search all pages for references to our old API endpoint
api.example.com/v1 and list them"

Це викликає docplatform_search з рядком старого endpoint. Ви отримуєте список кожної сторінки, що все ще посилається на застарілий URL. Жодного ручного grep по репозиторію документації.

Створення та оновлення контенту

"Read the current authentication guide, then update it to include
the new passkey login flow. Keep the existing structure."

Помічник викликає docplatform_read_page для читання поточного контенту, готує чернетку оновлення та викликає docplatform_update_page для його застосування. Якщо налаштовано git-синхронізацію, редагування з’являється як коміт у вашому репозиторії з атрибуцією діючому користувачеві.

Перегляд нещодавніх змін

"Show me everything that changed this week in this workspace"

Викликає docplatform_get_activity. Повертає, що змінилося, хто змінив і коли. Корисно для щотижневих переглядів документації без входу у веб-інтерфейс.

Перевірка якості перед релізом

"Validate all internal links in this workspace and list anything broken"

Викликає docplatform_validate_links і повертає непрацюючі цілі разом зі сторінками-джерелами — той тип перевірки, що виснажливий вручну і миттєвий зі структурованим доступом.

Що це означає для обслуговування документації

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

З MCP процес стає таким: попросити ШІ провести аудит розділу, переглянути знахідки, схвалити зміни. Проміжок скорочується до хвилин. Не тому, що ШІ пише кращу документацію — ні, не надійно — а тому, що вузьким місцем завжди було знайти, що не так, і внести зміну, а не скласти текст.

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

Більше про використання MCP для підтримки актуальності документації читайте у статті Як підтримувати документацію актуальною.

Обмеження, які варто знати

MCP-інструменти оперують окремими сторінками. Інструменту «переписати весь сайт документації» немає — навмисно. Масштабна реструктуризація все ще потребує людського судження щодо інформаційної архітектури.

Інструменти запису створюють реальні зміни. Якщо ви дасте помічнику ключ зі scope write та delete, він зможе змінювати та видаляти сторінки. Почніть із режиму тільки для читання: створіть ключ лише зі scope read для аудиторських сценаріїв і надавайте scope на запис, коли довірятимете циклу перегляду. Scope перевіряються на боці сервера разом із роллю діючого користувача в робочому просторі.

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

Початок роботи

  1. Встановіть Valoryx — один бінарний файл, без залежностей, працює менш ніж за 2 хвилини
  2. Створіть API-ключ у Workspace Settings → API Keys
  3. Додайте конфігурацію MCP-сервера в Claude Desktop
  4. Почніть із процесу тільки для читання: пошук і аудит, перш ніж увімкнути запис

Документація MCP містить повну довідку для всіх 26 інструментів, включаючи типи параметрів і схеми відповідей.

Обслуговування документації не повинно бути ручним процесом. Зі структурованим протоколом між вашим ШІ-помічником і платформою документації рутинні частини — пошук застарілого контенту, перевірка узгодженості, внесення механічних оновлень — стають тим, що можна делегувати з упевненістю.