# Интеграция с Origin {#origin}

Tuist может публиковать отчёты о сборках, тестах, превью и бандлах в пул-реквестах в нативных репозиториях [Cursor Origin](https://cursor.com/docs/api/origin). Он обновляет существующий отчёт Tuist Run Report вместо того, чтобы создавать новый комментарий для каждой загрузки.

Установка приложения не запускает сборки или тесты. Ваши текущие рабочие процессы продолжают загружать результаты в Tuist, а интеграция добавляет эти результаты в ваши пул-реквесты.

## Настройка {#setup}

Администратор аккаунта Tuist должен открыть **Settings → Integrations**, выбрать **Install Origin App** в карточке Origin и подтвердить доступ в Cursor. Выберите аккаунт или пространство имён Origin и репозитории, к которым Tuist должен получить доступ, затем вернитесь в Tuist. Подключение относится к аккаунту Tuist, а не к отдельному проекту.

Вы также можете установить приложение напрямую из Origin. После подтверждения доступа войдите в Tuist, если это необходимо, и выберите организацию для подключения. Доступны только организации, которыми вы управляете, и ваш личный аккаунт. Если доступен только один аккаунт, Tuist подключает его автоматически, не показывая выбор. Если вы начинаете процесс из Tuist, организация уже выбрана, и этот шаг пропускается.

Выберите **Add new project connection**, чтобы открыть модальное окно выбора репозитория. Выберите неподключённый проект Tuist и один из репозиториев, обнаруженных в подключённом аккаунте Origin, затем выберите **Create Connection**. Если подключено несколько аккаунтов Origin, сначала выберите аккаунт. Для подключения доступны только нативные репозитории Origin. Перед подключением проекта Tuist повторно проверяет доступ к пул-реквестам и использует ветку по умолчанию репозитория.

Используйте **Manage integration**, чтобы открыть поток согласия Cursor в новой вкладке и настроить доступ к репозиториям или подключить другой аккаунт Origin. При ошибках загрузки репозиториев отображается кнопка **Retry**, отдельно от успешного пустого списка репозиториев.

Используйте <.localized_link href="/guides/server/authentication#account-tokens">токен аккаунта</.localized_link> для аутентификации загрузок результатов.

## Отчёты и разрешения {#reports-and-permissions}

При одобрении приложения вы предоставляете разрешения, необходимые для подключения репозиториев и публикации отчётов:

| Разрешение | Используется для |
| --- | --- |
| Пул-реквесты: чтение | Поиск открытого пул-реквеста для указанного коммита. |
| Обзоры пул-реквестов: чтение и запись | Чтение, публикация и обновление комментария Tuist Run Report. |
| Метаданные репозитория: чтение | Обнаружение репозиториев и их веток по умолчанию. Включается автоматически Origin. |

Tuist не нуждается в доступе к вашему исходному коду или разрешении на слияние пул-реквестов.

Чтобы связать результаты с пул-реквестом, загрузки должны включать URL клонирования Origin репозитория, Git-ссылку и полный SHA коммита. Tuist публикует отчёт только тогда, когда эти данные однозначно определяют один открытый пул-реквест на его текущем головном коммите. Результаты для заменённых коммитов не перезаписывают текущий отчёт.

В карточке Origin перечислены подключения проектов к репозиториям. Выберите **Manage → Remove connection** для подключения проекта, чтобы остановить его отчётность без удаления приложения. Удалите приложение в Cursor, чтобы отозвать его доступ; Tuist удалит установку и её подключения проектов при обработке уведомления об установке.

## Самостоятельно размещаемые серверы {#server-configuration}

Если вы размещаете собственный сервер Tuist, сначала зарегистрируйте и настройте приложение Origin для вашего развёртывания. Следуйте <.localized_link href="/guides/server/self-host/server#platform-origin">инструкциям по самостоятельному размещению Origin</.localized_link>, затем вернитесь к шагам настройки выше, чтобы подключить аккаунты и проекты.