DocumentationConnecter vos outils

Connecter un dépôt à un projet

Branches, commits et pull requests sur chaque ticket, incidents vers et depuis le dépôt, et Helpi Agent dans votre code.

Mis à jour 22 novembre 2026

Connectez un dépôt GitHub ou GitLab à un projet et chaque ticket affiche les branches, commits et pull requests qui le nomment. Les incidents peuvent venir du dépôt ou y partir, et Helpi Agent peut travailler sur des tickets dans votre code.

Connecter avec un jeton

  1. Ouvrez la page Dépôt du projet et cliquez sur Connecter le dépôt.
  2. Choisissez le fournisseur : GitHub ou GitLab.
  3. Collez l'adresse du dépôt, comme https://github.com/acme/app.
  4. Collez un jeton d'accès personnel créé dans vos réglages GitHub ou GitLab.
  5. Cliquez sur Connecter le dépôt. Octopora vérifie le jeton sur le dépôt et confirme la connexion.

github.com et gitlab.com sont pris en charge. Un projet a un seul dépôt ; en connecter un autre le remplace.

L'accès dont un jeton a besoin

JetonPour lire l'activitéPour que Helpi Agent pousse et ouvre des pull requests
GitHub, à granularité fineContents et Pull requests : readContents : write et Pull requests : write
GitHub, classiquereporepo
GitLabread_apiRôle Developer, api et write_repository

L'app GitHub Helpi (facultatif)

Avec un dépôt GitHub connecté, Paramètres > Helpi Agent > Dépôt propose Installer l'app GitHub Helpi. Installez-la sur le même dépôt : dès lors, pull requests, commits et commentaires apparaissent sous le nom de l'app plutôt que d'une personne.

Nommez votre travail d'après le ticket

Mettez la clé du ticket n'importe où dans une branche, un message de commit ou le titre d'une pull request et elle apparaît sur le ticket. La carte Workflow Git de chaque ticket donne des exemples à copier.

QuoiExemple
Branchefeature/ML-13-login-screen
CommitML-13: add the login form
Pull request[ML-13] Login screen
  • La casse ne compte pas, et ML-1 ne correspond pas à ML-10.
  • Sur GitLab, les pull requests sont des merge requests ; les mêmes noms fonctionnent.
  • Si votre dépôt utilise un autre préfixe, comme CP-12 pour ML-12, indiquez-le dans Paramètres > Général > Préfixe des clés dans git.

Incidents

Sur la page Incidents, Importer les incidents GitHub (ou GitLab) liste les incidents du dépôt à faire venir : les ouverts arrivent comme Ouverts, les fermés comme Résolus. Depuis le menu d'un incident, Pousser vers un incident GitHub le crée dans le dépôt.

Déconnecter

Sur la page Dépôt, cliquez sur Déconnecter. La connexion et son jeton sont supprimés ; vous pouvez reconnecter plus tard. Helpi Agent demande alors un dépôt avant de pouvoir travailler.

Questions

Helpi Agent dit que le jeton ne peut pas pousser.

Le jeton ne peut pas écrire. Créez-en un avec l'accès en écriture ci-dessus et cliquez sur Reconnecter le dépôt.

Une branche n'apparaît pas sur son ticket.

Vérifiez que la clé est dans la branche, le commit ou le titre de la pull request, et qu'une clé renommée est indiquée comme préfixe git.

Puis-je connecter un GitLab auto-hébergé ?

Pas encore : github.com et gitlab.com uniquement.

Voir la visiteLe module Dépôt en une minute.