MCP-сервер для вашої бази знань

Що робить MCP-сервер бази знань

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

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

Ендпоінт: один на портал, працює за замовчуванням

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

• URL: https://be.multibase.io/api/mcp/<portal-slug>, а також /mcp на власному хості порталу (зокрема на вашому домені).
• Транспорт: Streamable HTTP, без збереження стану, відповіді в JSON.
• Сумісний із будь-яким MCP-клієнтом, що підтримує віддалені Streamable HTTP-сервери, наприклад Claude, Cursor і VS Code.
• Статті повертаються в Markdown із канонічним URL, тож асистенти можуть цитувати їх і посилатися на ваш портал.

Підключення MCP-клієнта

Більшість клієнтів приймають віддалений сервер як назву та URL. Приклад нижче використовує поширену структуру mcpServers. Точні ключі конфігурації відрізняються залежно від клієнта: наприклад, VS Code використовує об'єкт servers із "type": "http", а в Claude віддалений сервер додається як користувацький конектор за URL. Перевірте формат у документації свого клієнта.

{
  "mcpServers": {
    "acme-help": {
      "url": "https://be.multibase.io/api/mcp/acme"
    }
  }
}

Перевірка через curl

Ендпоінт — це JSON-RPC поверх HTTP без стану, тож його можна перевірити без клієнта. Надішліть POST із заголовками content-type та accept, як показано нижче. Перший запит повертає список інструментів, другий виконує пошук.

curl -X POST https://be.multibase.io/api/mcp/acme \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://be.multibase.io/api/mcp/acme \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search_kb","arguments":{"query":"reset password","limit":5}}}'

Довідник інструментів

Аргумент locale дає асистенту змогу запросити конкретну мову, якщо статтю нею опубліковано. Це важливо для порталів, що ведуть контент кількома з 9 підтримуваних мов.

Безпека та межі доступу

• Лише публічний опублікований контент. Чернетки, неопубліковані мовні версії та статті, обмежені групами читачів, ніколи не віддаються.
• Лише читання. Жоден інструмент не може створити, змінити чи видалити дані.
• Обмеження частоти запитів для кожного ендпоінту захищає портал і робить навантаження передбачуваним.
• Ізоляція порталів. Ендпоінт повертає статті лише свого порталу.
• Видно в аналітиці. Пошуки та читання статей через MCP відображаються з джерелом "MCP" поруч із вебтрафіком і AI-чатом, тож видно, про що питають асистенти.

Сценарії використання

• Агенти підтримки в Claude або Cursor відповідають на звернення за вашою реальною документацією й одразу мають посилання для клієнтів.
• Внутрішні копілоти та інженерні асистенти знаходять опис поведінки продукту без окремої копії документації.
• AI-агенти ваших клієнтів підключаються до публічного довідкового центру й вирішують питання «як зробити» без створення тікета.
• Невдалі MCP-пошуки потрапляють у ту саму аналітику, що й пошуки читачів, тож прогалини, знайдені асистентами, стають ідеями для статей.

Чого поки немає

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