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

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

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

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

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

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

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

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

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

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

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

Параметр

Значение

URL

https://mcp.wiki.yandex.net

Идентификатор организации

Одно из значений:

  • Заголовок X-Org-Id для организации в Яндекс 360 для бизнеса
  • Заголовок X-Cloud-Org-Id для организации в Yandex Cloud

Заголовок Authorization

Одно из значений:

  • OAuth-токен в формате OAuth <токен>
  • IAM-токен в формате Bearer <токен> — только для организации в Yandex Cloud

О способах авторизации читайте в разделе Доступ к API.

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

Способ добавления 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 <токен>.

Предыдущая
Яндекс Метрика
Следующая
Обзор