MCP-сервер Yahont

Обзор

MCP-сервер Yahont позволяет любому MCP-совместимому клиенту LLM (Claude Desktop, Claude Code, Cursor, Windsurf и др.) получать доступ к вашей базе знаний Yahont, веб-поиску и получению содержимого по URL через Model Context Protocol.

Предварительные требования

Перед подключением вам понадобятся:

Работающий инстанс Yahont (с самостоятельным размещением или Yahont Cloud)
Аутентификация — см. Персональные токены доступа или Ключи API
MCP-совместимый клиент (Claude Desktop, Claude Code, Cursor и др.)

Конфигурация MCP-сервера с самостоятельным размещением

Перейти к переменным окружения, сети и параметрам развёртывания MCP-сервера с самостоятельным размещением

Быстрый старт

Claude Code (CLI)

claude mcp add --transport http yahont https://your-yahont-domain.com/mcp \
  --header "Authorization: Bearer YOUR_YAHONT_TOKEN_HERE"

Или добавьте его в .mcp.json вашего проекта:

{
  "mcpServers": {
    "yahont": {
      "type": "http",
      "url": "https://your-yahont-domain.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ONYX_TOKEN}"
      }
    }
  }
}

Затем задайте переменную окружения перед запуском Claude Code:

export ONYX_TOKEN="your-token-here"
claude

Claude Desktop

Добавьте следующее в файл конфигурации Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "yahont": {
      "url": "https://your-yahont-domain.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_YAHONT_TOKEN_HERE"
      }
    }
  }
}

Замените your-yahont-domain.com на адрес вашего Yahont. После запуска Yahont Cloud добавим его адрес.

Cursor / Windsurf / другие MCP-клиенты

Большинство MCP-клиентов поддерживают транспорт HTTP с пользовательскими заголовками. Параметры подключения:

Параметр	Значение
URL	`https://your-yahont-domain.com/mcp`
Transport	HTTP (Streamable HTTP)
Auth Header	`Authorization: Bearer YOUR_TOKEN`

Точные шаги настройки см. в документации MCP вашего клиента.

Доступные инструменты

MCP-сервер предоставляет три инструмента, которые могут вызывать клиенты LLM:

search_indexed_documents

Поиск по вашей приватной базе знаний, проиндексированной в Yahont. Возвращает ранжированные фрагменты документов с содержимым, оценками релевантности и метаданными.Параметры:

Параметр	Тип	Обязателен	По умолчанию	Описание
`query`	string	Да	—	Поисковый запрос на естественном языке
`source_types`	string[]	Нет	Все источники	Фильтр по типу коннектора (например, `["confluence", "github", "jira"]`)
`time_cutoff`	string	Нет	Без ограничения	Дата и время в формате ISO 8601 — возвращаются только документы, обновлённые после этого момента
`limit`	integer	Нет	`10`	Максимальное число возвращаемых результатов

Пример вызова:

{
  "query": "What is the latest status of PROJ-1234?",
  "source_types": ["jira", "google_drive"],
  "time_cutoff": "2025-01-01T00:00:00Z",
  "limit": 5
}

Поля ответа:

Поле	Описание
`documents`	Массив объектов результатов
`documents[].semantic_identifier`	Понятное название документа
`documents[].content`	Релевантный фрагмент текста
`documents[].source_type`	Источник коннектора (например, `"confluence"`)
`documents[].link`	URL исходного документа
`documents[].score`	Оценка релевантности
`total_results`	Число возвращённых результатов
`query`	Исходный запрос
`executed_queries`	Список фактически выполненных запросов (может включать расширения)

Чтобы узнать, какие типы источников доступны, используйте ресурс indexed_sources (см. ниже).

search_web

Поиск в публичном интернете по общим знаниям и текущим событиям.Параметры:

Параметр	Тип	Обязателен	По умолчанию	Описание
`query`	string	Да	—	Поисковый запрос
`limit`	integer	Нет	`5`	Максимальное число результатов

Пример вызова:

{
  "query": "React 19 migration guide",
  "limit": 5
}

Поля ответа:

Поле	Описание
`results`	Массив результатов веб-поиска
`results[].title`	Заголовок страницы
`results[].url`	URL страницы
`results[].snippet`	Короткий фрагмент текста
`query`	Исходный запрос

search_web возвращает фрагменты, а не полное содержимое страницы. Используйте open_urls, чтобы получить полный текст любого результата.

open_urls

Получение полного текстового содержимого одного или нескольких веб-URL.Параметры:

Параметр	Тип	Обязателен	Описание
`urls`	string[]	Да	Список URL для получения

Пример вызова:

{
  "urls": [
    "https://react.dev/blog/2024/12/05/react-19",
    "https://react.dev/learn/react-compiler"
  ]
}

Поля ответа:

Поле	Описание
`results`	Массив полученных страниц
`results[].title`	Заголовок страницы
`results[].url`	Полученный URL
`results[].content`	Полный извлечённый текст

Доступные ресурсы

indexed_sources

URI: resource://indexed_sourcesПеречисляет все типы коннекторов документов, проиндексированные в вашем инстансе Yahont в данный момент (например, "confluence", "github", "google_drive", "slack").Используйте это, чтобы узнать допустимые значения фильтра source_types в search_indexed_documents.Пример ответа:

{
  "indexed_sources": ["confluence", "github", "google_drive", "jira", "slack"]
}

Конфигурация с самостоятельным размещением

Чтобы разместить MCP-сервер самостоятельно, нужно включить его развёртывание через переменные окружения. Docker Compose:

Раскомментируйте блок mcp_server

В deployment/docker_compose/docker-compose.yml раскомментируйте блок mcp_server и в секции volumes строку mcp_server_logs:.

Включите MCP-сервер

Задайте в .env:

.env

MCP_SERVER_ENABLED=true

Запустите сервисы

docker compose up -d

Клиентам MCP-сервер доступен через nginx по адресу https://your-yahont-domain.com/mcp. Порт 8090 в Docker Compose не публикуется.

Проверка состояния

Убедитесь, что MCP-сервер работает. Запрос идёт через nginx: он убирает префикс /mcp и передаёт /health серверу.

curl https://your-yahont-domain.com/mcp/health

Ожидаемый ответ:

{
  "status": "healthy",
  "service": "mcp_server"
}

Переменные окружения

Большинству пользователей не нужно настраивать эти переменные окружения.

Переменная	По умолчанию	Описание
`MCP_SERVER_ENABLED`	`false`	Задайте `"true"`, чтобы включить MCP-сервер
`MCP_SERVER_HOST`	`0.0.0.0`	Хост, к которому привязывается MCP-сервер
`MCP_SERVER_PORT`	`8090`	Порт MCP-сервера
`MCP_SERVER_CORS_ORIGINS`	(пусто)	Список разрешённых источников CORS через запятую
`API_SERVER_PROTOCOL`	`http`	Протокол внутреннего подключения к API-серверу
`API_SERVER_HOST`	`127.0.0.1`	Имя хоста внутреннего подключения к API-серверу
`API_SERVER_URL_OVERRIDE_FOR_HTTP_REQUESTS`	(не задано)	Полное переопределение URL API-сервера. Используйте, когда вы размещаете MCP-сервер самостоятельно для Yahont Cloud

Отладка и тестирование

MCP Inspector

MCP Inspector — интерактивный инструмент отладки MCP-серверов:

npx @modelcontextprotocol/inspector

Настройка в Inspector:

Игнорируйте меню настройки OAuth
Откройте вкладку Authentication
Выберите аутентификацию Bearer Token
Вставьте ваш PAT или ключ API Yahont
Нажмите Connect

После подключения можно просматривать инструменты, тестировать вызовы с разными параметрами и изучать запросы и ответы.

Дальнейшие шаги

Персональные токены доступа

Создайте токен для аутентификации на MCP-сервере

Ключи API

Создайте общие ключи API для командного доступа к MCP

Коннекторы

Добавьте источники данных, чтобы сделать знания доступными для поиска через MCP

Действия MCP

Подключите Yahont к внешним MCP-серверам как клиент

Начало работы

Локальное развёртывание

Продакшен

Yahont Anywhere

Аутентификация

Разное

Обзор

Предварительные требования

Конфигурация MCP-сервера с самостоятельным размещением

Быстрый старт

Claude Code (CLI)

Claude Desktop

Cursor / Windsurf / другие MCP-клиенты

Доступные инструменты

Доступные ресурсы

Конфигурация с самостоятельным размещением

Проверка состояния

Переменные окружения

Отладка и тестирование

MCP Inspector

Дальнейшие шаги

Персональные токены доступа

Ключи API

Коннекторы

Действия MCP

​Обзор

​Предварительные требования

Конфигурация MCP-сервера с самостоятельным размещением

​Быстрый старт

​Claude Code (CLI)

​Claude Desktop

​Cursor / Windsurf / другие MCP-клиенты

​Доступные инструменты

​Доступные ресурсы

​Конфигурация с самостоятельным размещением

​Проверка состояния

​Переменные окружения

​Отладка и тестирование

​MCP Inspector

​Дальнейшие шаги

Персональные токены доступа

Ключи API

Коннекторы

Действия MCP

Обзор

Предварительные требования

Быстрый старт

Claude Code (CLI)

Claude Desktop

Cursor / Windsurf / другие MCP-клиенты

Доступные инструменты

Доступные ресурсы

Конфигурация с самостоятельным размещением

Проверка состояния

Переменные окружения

Отладка и тестирование

MCP Inspector

Дальнейшие шаги