AI та інтеграція з MCP

Valoryx Cloud має вбудований MCP-сервер (Model Context Protocol), який дозволяє AI-асистентам взаємодіяти з вашою документацією напряму.

Що таке MCP?

MCP — це стандартний протокол, який дозволяє AI-інструментам підключатися до зовнішніх сервісів. Уявіть, що це спосіб дати Claude або Cursor можливість “бачити” вашу документацію та вносити зміни — з вашого дозволу.

Що AI може робити з вашою документацією

  • Читати сторінки, щоб відповідати на питання про вашу документацію
  • Шукати по всіх сторінках, щоб знаходити потрібний контент
  • Створювати нові сторінки за вашими інструкціями
  • Редагувати наявні сторінки (переписувати, покращувати, перекладати)
  • Аналізувати документацію на предмет прогалин, неточностей або застарілого контенту

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

Статус: хмарний MCP-ендпоінт для Valoryx Cloud ще не увімкнено — віддалені ШІ-інструменти поки не можуть під’єднатися до app.valoryx.dev. Цю сторінку буде оновлено, щойно він запрацює. На самостійно розгорнутій інстанції MCP працює вже сьогодні — виконайте кроки нижче на машині, де запущено DocPlatform.

Самостійне розгортання: Claude Desktop

  1. Перейдіть у Workspace Settings → API Keys
  2. Створіть API-ключ — він починається з dp_live_ і показується лише один раз
  3. У claude_desktop_config.json додайте:
{
  "mcpServers": {
    "docplatform": {
      "command": "docplatform",
      "args": ["mcp", "--workspace", "my-docs", "--api-key", "dp_live_abc123"]
    }
  }
}
  1. Перезапустіть Claude Desktop
  2. Запитайте Claude: “Що є в моїй документації?”

У Cursor

Та сама конфігурація — додайте той самий запис docplatform у файл .cursor/mcp.json вашого проєкту.

Доступні MCP-інструменти

MCP-сервер надає 26 інструментів:

Інструмент Що робить
list_pages Перелік усіх сторінок у робочому просторі
read_page Читання вмісту конкретної сторінки
write_page Створення сторінки або її оновлення, якщо вона вже існує
update_page Оновлення наявної сторінки
delete_page Видалення сторінки
search Повнотекстовий пошук по всіх сторінках
list_workspaces Перелік доступних робочих просторів
…та інші Коментарі, метадані, структура дерева

Безпека

  • API-ключі хешуються (ніколи не зберігаються у відкритому вигляді)
  • Ви контролюєте рівень доступу для кожного ключа: read, write і delete
  • Відкликайте ключі будь-коли з Workspace Settings
  • Невдалі спроби авторизації логуються, а кожна зміна вмісту відстежується в історії сторінки