MCP-сервер Яндекс Вики

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

Возможности MCP-сервера

Через MCP-сервер ассистент получает доступ к публичному API Вики и сможет:

• искать и читать страницы базы знаний;
• создавать и редактировать страницы;
• собирать саммари по нескольким страницам.

Как подключить

Чтобы подключить MCP-сервер Вики к AI-ассистенту:

1. Получите OAuth-токен для доступа к API Вики. Подробнее читайте в разделе Доступ к API.

2. Узнайте идентификатор организации. Для этого в Яндекс Трекер откройте страницу Администрирование → Организации и скопируйте значение поля идентификатор.

3. Добавьте конфигурацию MCP-сервера в настройки вашего AI-инструмента. В качестве параметров укажите URL и заголовки из таблицы ниже.

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

Примеры подключения

Способ добавления MCP-конфигурации зависит от конкретного инструмента. Обычно достаточно указать URL MCP-сервера и необходимые заголовки.

Пример настройки для Codex

Чтобы добавить MCP-сервер Вики в Codex, добавьте в файл .codex/config.toml:

[mcp_servers.wiki-oauth]
url = "https://mcp.wiki.yandex.net"
http_headers = {
    "X-Org-Id" = "<идентификатор_организации>",
}
env_http_headers = {
    "Authorization" = "WIKI_OAUTH_TOKEN",
}

Переменная окружения WIKI_OAUTH_TOKEN должна содержать OAuth-токен в формате OAuth <токен>.

Пример настройки для Claude Code

Чтобы добавить MCP-сервер Вики в Claude Code, выполните команды:

export WIKI_OAUTH_TOKEN="OAuth <токен>"

claude mcp add --transport http wiki-oauth https://mcp.wiki.yandex.net \
    --header "X-Org-Id: <идентификатор_организации>" \
    --header "Authorization: $WIKI_OAUTH_TOKEN"

set "WIKI_OAUTH_TOKEN=OAuth <токен>"

claude mcp add --transport http wiki-oauth https://mcp.wiki.yandex.net ^
    --header "X-Org-Id: <идентификатор_организации>" ^
    --header "Authorization: %WIKI_OAUTH_TOKEN%"

Переменная окружения WIKI_OAUTH_TOKEN должна содержать OAuth-токен в формате OAuth <токен>.

Пример настройки для Yandex AI Studio

Чтобы подключить MCP-сервер Вики через MCP Hub:

1. В Yandex AI Studio выберите каталог.

2. На панели слева разверните раздел Agent Atelier и выберите MCP-серверы.

3. Нажмите Создать MCP-сервер и выберите Внешний MCP-сервер.

4. Укажите имя сервера и нажмите Создать.

5. В поле URL укажите https://mcp.wiki.yandex.net, затем выберите транспорт Streamable HTTP.

6. В поле Тип авторизации выберите Токен доступа и добавьте заголовки:

   • для организации Яндекс 360 для бизнеса — Authorization: OAuth <OAuth-токен> и X-Org-Id: <идентификатор_организации>;
   • для организации Yandex Cloud — Authorization: OAuth <OAuth-токен> или Authorization: Bearer <IAM-токен>, а также X-Cloud-Org-Id: <идентификатор_организации>.

7. Нажмите Подключиться. В блоке Инструменты выберите необходимые инструменты и нажмите Сохранить.

8. На панели слева выберите Agent Atelier → Агенты и создайте или откройте агента.

9. В поле Инструменты нажмите Добавить, выберите MCP server и укажите сохраненный MCP-сервер Вики.

Проверьте подключение с помощью запроса на чтение:

Найди страницу <название_страницы>, прочитай ее и подготовь краткое саммари.

Подробнее читайте в инструкциях AI Studio о подключении внешнего MCP-сервера и о создании агента.