OpenText Core Software Delivery Platform

Core Software Delivery Platform

Обзор · Подключение клиента · Пользовательские интеграции · Устранение неполадок

Ищете OpenText Software Delivery Management? См. README-Software-Delivery-Management.md. Общий обзор доступен в файле README.md.

Официальный сервер Model Context Protocol для OpenText Core Software Delivery Platform встроен непосредственно в продукт: локальный прокси или дополнительный процесс не требуются. После включения сервер предоставляет инструментам искусственного интеллекта доступ в реальном времени для чтения и изменения бэклога, рабочих элементов и данных о поставке. Для аутентификации используются OAuth 2.1 или ключи доступа API. Каждое действие выполняется с учётом существующих разрешений пользователя в рабочей области.

Доступность: функцию Model Context Protocol постепенно открывают для пользователей; по умолчанию она пока отключена. Чтобы включить её для своего клиента, обратитесь в службу поддержки OpenText.

Кратко


Продукт	OpenText Core Software Delivery Platform
Протокол	HTTP без сохранения состояния: POST для вызова инструментов, GET для обнаружения конечной точки; JSON-RPC 2.0
Аутентификация	OAuth 2.1 (интерактивный вход через браузер) · ключ доступа (для автономной работы или использования сервисами)
Размещение	Встроен в Core Software Delivery Platform
Базовый URL документации	`https://admhelp.microfocus.com/valueedge/en/latest/Online/Content/AdminGuide/`

Содержание

Кратко
Возможности
Принцип работы
Поддерживаемые инструменты
Перед началом работы
Настройка аутентификации
Подключение клиента искусственного интеллекта
Дополнительные примеры запросов
Советы и рекомендации
Безопасность
Поддержка и обратная связь

Возможности

Подключите клиент искусственного интеллекта к рабочей области и работайте с данными о поставке, не выходя из IDE:

Возможность	Пример запроса
Поиск и фильтрация	«Перечисли все открытые дефекты, назначенные на меня в текущем спринте».
Поиск по ключевым словам	«Найди в бэклоге все пользовательские истории, в которых упоминается производительность».
Создание рабочих элементов	«Создай пять пользовательских историй на основе этих заметок со встречи».
Обновление сущностей	«Обнови описание истории #1042, добавив эти критерии приёмки».
Изучение метаданных	«Какие поля есть у сущности Feature?»
Проверка статуса	«Каков текущий статус эпика #205?»

Принцип работы

Сервер встроен в продукт и доступен по HTTPS по пути /mcp.

Транспорт: HTTP без сохранения состояния — POST для вызова инструментов, GET для обнаружения конечной точки
Протокол: JSON-RPC 2.0; каждый запрос самодостаточен
Аутентификация: OAuth 2.1 (вход через браузер) или ключ доступа (статический bearer-токен)
Разрешения: действия выполняются в пределах доступа аутентифицированного пользователя к рабочей области

Конечная точка

Размещение	Базовый адрес
Облако — Северная и Южная Америка	`https://almoctane-ams.saas.microfocus.com/mcp`
Облако — Европа	`https://almoctane-eur.saas.microfocus.com/mcp`
Облако — Азиатско-Тихоокеанский регион	`https://almoctane-apj.saas.microfocus.com/mcp`

Используйте то же имя хоста, что и для входа в веб-интерфейс Core Software Delivery Platform, добавив в конце /mcp. Список региональных имён хостов облачной версии приведён в руководстве администратора.

Поддерживаемые инструменты

Сервер предоставляет следующие инструменты:

Инструмент	Описание
`get_entity_types`	Возвращает список типов сущностей, доступных в рабочей области
`get_filter_metadata`	Возвращает синтаксис фильтров и поддерживаемые операторы
`get_entity_field_metadata`	Показывает поля и их типы для указанного типа сущности
`get_entities`	Возвращает список сущностей с возможностью фильтрации, поиска, сортировки и постраничного вывода
`get_entity`	Получает одну сущность по идентификатору
`create_entity`	Создаёт сущность
`update_entity`	Обновляет выбранные поля существующей сущности

Полные спецификации инструментов и сведения о схемах см. в разделе Создание пользовательских интеграций.

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

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

Активное общее пространство OpenText
Для вашего клиента включена функция Model Context Protocol. Если она пока недоступна, обратитесь в службу поддержки OpenText
Один из поддерживаемых клиентов искусственного интеллекта (см. раздел «Подключение клиента искусственного интеллекта»)
Для OAuth 2.1: современный браузер для завершения входа
Для ключа доступа: токен доступа, созданный в целевой рабочей области
Лицензия Aviator AI для каждого агента или пользователя, который устанавливает подключение
Каждое подключение использует именную пользовательскую лицензию, как и любой обычный пользователь, работающий с этой рабочей областью

Настройка аутентификации

Поддерживаются два способа аутентификации. Выберите подходящий для вашего сценария.

Способ	Рекомендуется для
OAuth 2.1	Интерактивных клиентов IDE; долгосрочные учётные данные не хранятся в файлах конфигурации
Ключ доступа	Автономных сценариев и сервисов; в конфигурации клиента используется статический токен

OAuth 2.1

Для OAuth 2.1 используется интерактивный вход через браузер. При первом подключении клиент открывает окно браузера, в котором можно пройти аутентификацию в своём клиенте Core Software Delivery Platform. Долгосрочные учётные данные не сохраняются в конфигурации; подключение ограничено разрешениями пользователя в рабочей области.

Некоторым клиентам, например Claude Desktop, требуется зарегистрированный идентификатор клиента. Используйте идентификатор клиента, настроенный для вашего клиента, как описано в разделе Подключение клиента.

Ключ доступа

Создайте bearer-токен доступа в целевой рабочей области, используя тип Token. Подробности см. в разделе Доступ к API.

Внимание: Не вставляйте токены доступа в конфигурационные файлы в виде обычного текста. Если клиент поддерживает такую возможность, используйте переменную окружения или управляемую клиентом переменную ввода.

Подключение клиента искусственного интеллекта

Ниже найдите фрагмент конфигурации для своего клиента. Замените https://myvalueedge.company.com/mcp фактическим адресом сервера.

Visual Studio Code с GitHub Copilot

Откройте созданный файл mcp.json в Visual Studio Code и добавьте один из следующих вариантов:

OAuth 2.1:

{
  "servers": {
    "opentext-mcp": {
      "type": "http",
      "url": "https://myvalueedge.company.com/mcp"
    }
  }
}

Ключ доступа:

{
  "servers": {
    "opentext-mcp": {
      "type": "http",
      "url": "https://myvalueedge.company.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:valueEdgeAccessToken}"
      }
    }
  }
}

При первом использовании Visual Studio Code один раз запросит значение токена и сохранит его в защищённом хранилище секретов.

После сохранения откройте Copilot Chat, выберите Tools и убедитесь, что инструменты отображаются в списке.

IntelliJ с GitHub Copilot

Откройте файл mcp.json в IntelliJ и добавьте те же варианты конфигурации, что и для Visual Studio Code.

Claude Desktop

Расположение файла конфигурации:

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

OAuth 2.1:

{
  "mcpServers": {
    "opentext-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://myvalueedge.company.com/mcp",
        "--static-oauth-client-info",
        "{\"client_id\": \"<client_id>\"}"
      ]
    }
  }
}

Ключ доступа:

{
  "mcpServers": {
    "opentext-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://myvalueedge.company.com/mcp",
        "--header",
        "Authorization: Bearer <your-access-token>"
      ]
    }
  }
}

Для прокси mcp-remote требуется Node.js версии 18 или более поздней.

Cursor

Создайте или отредактируйте файл .cursor/mcp.json в корне проекта:

OAuth 2.1:

{
  "mcpServers": {
    "opentext-mcp": {
      "url": "https://myvalueedge.company.com/mcp"
    }
  }
}

Ключ доступа:

{
  "mcpServers": {
    "opentext-mcp": {
      "url": "https://myvalueedge.company.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-access-token>"
      }
    }
  }
}

Проверка подключения

После настройки:

Visual Studio Code и IntelliJ: откройте Copilot Chat, выберите Tools и убедитесь, что инструменты ValueEdge отображаются и включены
Claude Desktop: откройте в чате список инструментов и убедитесь, что нужные инструменты отображаются
Cursor: откройте Composer и убедитесь, что инструменты доступны в списке инструментов агента

Если инструменты не отображаются, проверьте путь к файлу конфигурации и адрес сервера, а затем перезапустите клиент. См. раздел Устранение неполадок.

Другие примеры запросов

Вот ещё несколько примеров запросов к AI-клиенту:

«Какие типы сущностей доступны в моей рабочей области?»
«Создай дефект с высоким уровнем серьёзности под названием „Не удаётся войти в Safari 17“»
«Найди в бэклоге все истории, в которых упоминается производительность»

Советы и рекомендации

Укажите рабочую область по умолчанию в инструкциях агента

Добавьте следующие строки в файл AGENTS.md (или в аналогичный файл с инструкциями), чтобы не выполнять запросы для определения параметров при каждом сеансе и сократить расход токенов:

ОБЯЗАТЕЛЬНО использовать идентификатор общего пространства =
ОБЯЗАТЕЛЬНО использовать базовый адрес = "https://myvalueedge.company.com"">

## OpenText Core Software Delivery Platform

When connected to the opentext-mcp server:
- **MUST** use workspace identifier = <your-workspace-id>
- **MUST** use shared space identifier = <your-shared-space-id>
- **MUST** use base address = "https://myvalueedge.company.com"

Используйте естественный язык для фильтрации

Инструмент get_entities поддерживает гибкую фильтрацию. Опишите запрос естественным языком, а клиент преобразует его в нужный синтаксис фильтра, предварительно вызвав get_filter_metadata.

Безопасность

Весь трафик передаётся по HTTPS с шифрованием TLS 1.2 или более поздней версии. Доступ строго ограничен разрешениями пользователя, прошедшего аутентификацию, в рабочей области продукта. Сервер не может предоставить пользователю больше прав, чем у него уже есть.

Использование сервера регулируется Лицензионным соглашением OpenText с конечным пользователем, доступным на странице соглашений OpenText, а также соответствующим описанием сервиса для вашей среды развёртывания.

Поддержка и обратная связь

Руководство администратора: Обзор сервера Model Context Protocol
Запросы в службу поддержки: Портал поддержки OpenText
Сообщество: отправляйте запросы на добавление функций через раздел идей сообщества OpenText

Отказ от ответственности

Сервер выполняет действия в Core Software Delivery Platform с правами пользователя, прошедшего аутентификацию. Предоставляйте только минимально необходимые права, проверяйте критически важные изменения перед подтверждением и отслеживайте журналы аудита на предмет необычной активности.