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 пока этого не умеет, и инструмент с авторизованным доступом сейчас подойдёт лучше.