На этой странице
Подключите клиент 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.
Найдите и откройте подтверждение¶
Вызовите
list_knowledge_basesдля получения ID, имён и прав.Передайте
queryи, при необходимости,top_kвsearch_knowledge_base. Если схема требуетknowledge_base, укажите имя или ID. Читайте выдержки в порядке ранжирования.Передайте канонический
chunk_idвfetch_source, чтобы открыть фрагмент целиком. Если у записи из подключённого индекса нет канонического чанка, используйте полученную выдержку.Для ответа с источниками вызовите
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.
При изменении прав запросите список инструментов заново. Отзыв доступа
к пространству может разорвать подключение и потребовать подтверждения.