ONES MCP for GitHub Copilot

Подключите GitHub Copilot к ONES, чтобы управлять проектами и работать с базой знаний в авторизованном рабочем пространстве. Этот удалённый MCP-сервер и данный репозиторий поддерживаются ONES.

Возможности

Поиск и управление проектами, задачами, спринтами и комментариями.
Работа с тест-кейсами и записями о затраченном времени.
Создание и получение материалов Wiki, а также чтение поддерживаемых вложений.

Доступные инструменты и действия зависят от разрешений вашей учётной записи и включённых возможностей ONES.

Требования

VS Code с GitHub Copilot и включённой поддержкой MCP.
Учётная запись ONES с доступом к рабочему пространству, обслуживаемому через https://us.ones.com/mcp.
Разрешение на использование MCP-серверов в соответствии с правилами вашей организации.

Эта конечная точка обслуживает развёртывание для США. Для других региональных или частных развёртываний может потребоваться другая конечная точка MCP. Перед подключением проверьте настройки MCP своего рабочего пространства.

Подключение в VS Code

Откройте палитру команд и выполните MCP: Add Server.
Выберите HTTP и укажите https://us.ones.com/mcp.
Назовите сервер ones. Для подключения в новом рабочем пространстве выберите .mcp.json; для доступа из разных проектов выберите глобальный вариант конфигурации, предлагаемый клиентом.
Запустите сервер и подтвердите доверие, когда появится запрос. Пройдите авторизацию OAuth в браузере: войдите в ONES и проверьте запрашиваемые разрешения.
Откройте Copilot Chat в режиме агента с поддержкой инструментов. С помощью Configure Tools убедитесь, что инструменты ONES доступны.

Также можно создать файл .mcp.json в корневой папке своего проекта и добавить в него следующую конфигурацию. Если файл уже существует, добавьте запись ones в объект mcpServers:

{
  "mcpServers": {
    "ones": {
      "type": "http",
      "url": "https://us.ones.com/mcp"
    }
  }
}

Примеры для копирования: portable-mcp.json использует приведённый выше формат .mcp.json; vscode-mcp.json использует формат servers для существующих конфигураций .vscode/mcp.json. Настройте сервер только в одном месте, чтобы избежать дублирующихся записей. Клонировать этот репозиторий или запускать локальный сервер ONES не требуется.

ONES использует авторизацию OAuth. Не указывайте пароли, токены доступа или секреты клиента в файлах конфигурации, которые коммитятся в Git. Доступ по-прежнему ограничен разрешениями авторизованного пользователя ONES.

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

После сохранения конфигурации выполните MCP: List Servers, выберите ones и при необходимости запустите сервер. Пройдите авторизацию в браузере с учётной записью ONES, которую собираетесь использовать, а затем вернитесь в VS Code. В Copilot Chat откройте Configure Tools и проверьте, что инструменты ONES доступны и включены.

Отправьте первый запрос:

Используй ONES, чтобы вывести список доступных мне проектов. Не изменяй данные.

При успешной проверке будут возвращены реальные результаты по доступным проектам или явный пустой результат, если у учётной записи нет доступа ни к одному проекту. Общий ответ об ONES не подтверждает вызов инструмента: разверните сведения о действиях инструментов Copilot и убедитесь, что инструмент ONES выполнился успешно. Если авторизация или вызов инструмента завершились ошибкой, воспользуйтесь приведёнными ниже рекомендациями по устранению неполадок.

Работа с ONES в Copilot Chat

Выберите режим чата с поддержкой инструментов и включите нужные инструменты ONES. Укажите проект, задачу или страницу Wiki, с которыми нужно работать. Если названия неоднозначны, попросите Copilot сначала показать подходящие записи. Замените заполнители в угловых скобках ниже своими значениями.

Поиск и обобщение рабочих данных

Найди в ONES проект с названием ``. Если найдётся несколько проектов, дай мне выбрать. Затем перечисли назначенные мне задачи в этом проекте, включая их названия и статусы. Ничего не изменяй.

Используйте полученные идентификаторы задач в последующих запросах:

Получи задачу ONES `` и кратко изложи её описание, статус и комментарии.

Получение знаний из рабочего пространства

Найди в содержимом Wiki ONES, доступном моей учётной записи, материалы по запросу ``. Покажи названия подходящих страниц, получи нужную страницу и кратко изложи шаги выпуска. Укажи ссылку на исходную страницу, если она возвращена.

Результаты зависят от содержимого Wiki, к которому у авторизованной учётной записи есть доступ.

Создание задачи

Подготовь задачу в проекте ONES с названием и следующим описанием: ``. Если не хватает обязательных полей, запроси их у меня, а перед созданием покажи целевой проект, тип задачи и предлагаемые значения полей.

Проверьте предложенные значения, затем попросите Copilot создать задачу. Если VS Code запросит разрешение на использование инструмента, проверьте действие перед подтверждением. Проверьте полученный идентификатор задачи и откройте её в ONES, чтобы убедиться, что данные сохранены. При проверке операций записи используйте тестовый проект.

Обновление существующей задачи

Получи задачу ONES ``. Покажи её текущий статус и доступные целевые статусы, а затем спроси, какой статус установить.

После обновления проверьте запись в ONES. Доступные операции и обязательные поля зависят от конфигурации рабочего пространства и разрешений учётной записи.

Отключение

Выполните MCP: List Servers, чтобы остановить сервер ones. Чтобы удалить конфигурацию подключения, удалите только соответствующую запись из выбранного файла конфигурации. Остановка сервера или удаление конфигурации клиента сами по себе не отзывают ранее выданное разрешение OAuth; управляйте им отдельно в настройках учётной записи ONES.

Устранение неполадок

Не удаётся пройти авторизацию: убедитесь, что ваша учётная запись ONES и рабочее пространство относятся к настроенному развёртыванию, затем подключитесь снова и повторно пройдите OAuth-авторизацию.
Инструменты не отображаются: проверьте состояние сервера с помощью MCP: List Servers, изучите его вывод и проверьте выбранные инструменты в Copilot Chat.
Операция запрещена: уточните у администратора разрешения ONES и включённые возможности рабочего пространства.
Использование MCP ограничено: спросите администратора организации, разрешено ли подключение к этому серверу.

Если проблему интеграции можно воспроизвести, создайте issue, указав версию клиента и очищенное от конфиденциальных данных сообщение об ошибке. Не включайте в него токены, учётные данные или закрытые данные рабочего пространства.

Метаданные реестра

Идентификатор сервера в Official MCP Registry — com.ones/ones. В файле server.json содержатся подготовленные для публикации метаданные, в том числе URL общедоступного репозитория. Наличие файла в этом репозитории не доказывает, что соответствующая версия опубликована или одобрена GitHub; опубликованную версию можно проверить в актуальной записи Registry.

В этом репозитории представлены общедоступная документация и метаданные подключения к размещённой службе ONES MCP. Исходный код серверной части размещённой службы здесь отсутствует.