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

Авторский МСР-сервер Документерры позволяет подключить документацию вашего портала к ИИ-ассистентам и запрашивать контент, используя естественный язык. На этой странице описано, как настроить подключение в наиболее популярных ИИ-инструментах.


Перед началом работы

Прежде чем начать, убедитесь, что у вас есть адрес эндпоинта (endpoint URL) авторского MCP-сервера вашего портала. Вы можете найти его в настройках портала: ИИ интеграции → МСР-сервер. Эндпоинт (endpoint) авторского MCP-сервера для портала выглядит примерно так: https://ru.mcp.documenterra.com/portals/yourportal.documenterra.net

Для аудита и управления правами доступа мы рекомендуем настроить отдельную учётную запись для ИИ-агента:

  1. Создайте отдельную учетную запись Автора или Авторизованного читателя для ИИ-агента.
  2. Настройте права для этой учётной записи, чтобы ИИ-агент имел доступ только к выбранным проектам.
  3. Выйдите из портала в текущем браузере и войдите снова с использованием отдельной учетной записи ИИ — или откройте отдельный профиль браузера/сессию в режиме Инкогнито и войдите там.
  4. Подключите авторский MCP-сервер к вашему ИИ-инструменту и следуя инструкциям для конкретного ИИ-агента, которые представлены ниже.

После установки соединения агент сохраняет токен для этой учетной записи и использует его в течение следующих 30 дней.

Сессия портала используется только один раз — в момент первоначального подключения. После этого агент работает с сохраненным токеном и не зависит от того, какая учетная запись в данный момент авторизована на портале в вашем браузере.

Claude Desktop

Claude Desktop позволяет добавлять пользовательские коннекторы MCP через настройки организации.

  1. Откройте Claude Desktop и перейдите в Organization settings (Настройки организации).
  2. Перейдите в раздел Connectors (Коннекторы) и нажмите Add → Custom → Web .
  3. Введите адрес эндпоинта авторского MCP-сервера вашего портала, укажите имя и подтвердите.
  4. Теперь вы можете задавать Claude вопросы о вашей документации прямо в чате.

Claude (Cloud)

Веб-версия Claude также позволяет добавлять пользовательские коннекторы MCP через настройки организации.

  1. В Claude (Cloud) откройте Organization settings (Настройки организации) и перейдите в раздел Connectors (Коннекторы).
  2. Нажмите Add custom connector и введите адрес эндпоинта авторского MCP-сервера вашего портала.
  3. В списке коннекторов найдите только что добавленный коннектор и нажмите Connect. Убедитесь, что статус изменился на подключенный (connected).
  4. Теперь вы можете отправлять вопросы о вашей документации на естественном языке в Claude — специальные команды не требуются.

Для получения более подробной информации обратитесь к статье: Используйте коннекторы для расширения возможностей Claude.

Gemini CLI

Вы можете подключить Gemini CLI к авторскому MCP-серверу с помощью команды gemini mcp add.

  1. Откройте Gemini CLI.
  2. Выполните следующую команду:
    Скопировать код
    Код
    gemini mcp add --transport http my-mcp-server https://ru.mcp.documenterra.com/portals/yourportal.documenterra.net
    где:
    my-mcp-server — имя вашего пользовательского сервера,
    https://ru.mcp.documenterra.com/portals/yourportal.documenterra.net — URL-адрес конечной точки вашего авторского MCP-сервера.
  3. Инструменты Документерры теперь будут доступны во время ваших сессий.

Кроме того, вы можете добавить подключение непосредственно в файл конфигурации. Для получения более подробной информации обратитесь к документации Gemini CLI MCP.

ChatGPT (Codex)

OpenAI Codex CLI поддерживает MCP-серверы. добавленные через файл config.toml.

  1. Откройте ~/.codex/config.toml.
  2. Добавьте ваш сервер в таблицу [mcp_servers.<server-name>], указав адрес вашего эндпоинта в качестве параметра url.
  3. Сохраните файл. Сервер будет доступен во время вашей следующей сессии Codex.
  4. Теперь вы можете обращаться к документации Документерры в Codex, используя естественный язык.

Для получения более подробной информации обратитесь к документации OpenAI Codex.

Microsoft Copilot

Microsoft Copilot Studio поддерживает MCP-серверы в качестве инструментов для ваших агентов.

  1. Откройте Copilot Studio.
  2. Перейдите на страницу Tools (Инструменты) для вашего агента.
  3. Выберите Model Context Protocol.
  4. Нажмите New tool (Новый инструмент) и введите адрес эндпоинта авторского MCP-сервера вашего портала.
  5. Теперь ваш агент может использовать документацию Документерры в качестве источника знаний.

Для получения более подробной информации обратитесь к документации Microsoft Copilot Studio.