На этой странице

Подключите клиент MCP

Подключитесь и выдайте права

Скопируйте адрес подключения из раздела Доступ и ключи в клиент MCP. Для локального запуска это http://localhost:13000/mcp. Агент может получить список доступных пространств, найти документы и открыть исходные фрагменты.

  • OAuth. Войдите через браузер, выберите пространства и права, подтвердите запрос. Для поиска достаточно чтения. Клиент передаёт токен через Authorization: Bearer …. Подключения можно проверить и отозвать в разделе Доступ и ключи.

  • Ключ API. Создайте ключ типа Для агента (MCP), выберите хотя бы одно пространство, задайте срок действия и сохраните полный ключ в защищённых настройках клиента. Заголовок — X-API-Key.

Передавайте один вид учётных данных за запрос. Для проверки ключа задайте CONTEXTBASE_BASE_URL с адресом установки и CONTEXTBASE_API_KEY с ключом MCP. Выполните:

curl --fail-with-body "$CONTEXTBASE_BASE_URL/mcp" \
  -H "X-API-Key: $CONTEXTBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Список инструментов находится в result.tools.

Найдите и откройте подтверждение

  1. Вызовите list_knowledge_bases для получения ID, имён и прав.

  2. Передайте query и, при необходимости, top_k в search_knowledge_base. Если схема требует knowledge_base, укажите имя или ID. Читайте выдержки в порядке ранжирования.

  3. Передайте канонический chunk_id в fetch_source, чтобы открыть фрагмент целиком. Если у записи из подключённого индекса нет канонического чанка, используйте полученную выдержку.

  4. Для ответа с источниками вызовите answer_from_knowledge_base. Нужен настроенный генератор. Запрос может расходовать квоту модели.

Реализуйте подключение в своём клиенте

Отправляйте сообщения JSON-RPC методом POST на /mcp. Вызовите initialize и передавайте согласованную версию в MCP-Protocol-Version. Добавляйте учётные данные в каждый вызов. На запрос приходит один полный ответ. Сервер не выдаёт ID сессии.

Метаданные OAuth доступны по /.well-known/oauth-authorization-server и /.well-known/oauth-protected-resource. Для авторизации по коду с PKCE используйте /oauth/authorize и /oauth/token. При изменении прав запросите список инструментов заново. Отзыв доступа к пространству может разорвать подключение и потребовать подтверждения.

Согласование версии · Контроллер поиска

ContextBase0.1.0

Поиск в документации