L’IA dans votre IDE

fremforge reste en dehors de votre IDE. Les assistants de code IA (Claude Code, Cursor, Continue, JetBrains AI Assistant, GitHub Copilot Workspace, Codeium et d’autres) dialoguent avec un hébergeur Git comme n’importe quel outil de développement : Git en HTTPS pour les clones et les push, plus l’API REST de l’hébergeur pour tout le reste. fremforge fournit les éléments standard (PAT, API REST, spécification OpenAPI), si bien que tout outil IA qui sait déjà parler à GitHub ou GitLab fonctionne avec fremforge moyennant trois lignes de configuration.

Ce que cette page est, et ce qu’elle n’est pas

Cette page est le guide de démarrage rapide outil par outil. Pour chaque outil, vous trouverez : les scopes de PAT à demander, où coller l’URL de base de fremforge, et une commande d’une ligne qui confirme que l’outil peut lire vos dépôts. Ce n’est PAS une recommandation sur l’outil à utiliser : fremforge est délibérément indépendant des outils.

Pour les fonctionnalités IA côté serveur (relecture de PR par IA, explications Renovate, /ai/complete appelable par le client depuis ses propres workflows), consultez la page d’administration des intégrations IA de votre organisation. C’est une surface distincte : public différent, enjeux de souveraineté différents. En bref :

Surface	Public	fremforge sous-traite-t-il le traitement de votre code ?
Cette page : assistant IA dans l’IDE	Développeurs individuels	Non : votre outil s’adresse directement à votre fournisseur d’IA, avec votre clé
Administration des intégrations IA : relecture de PR, /ai/complete	Administrateurs de l’organisation	Non : BYOK, votre outil, votre contrat, votre fournisseur

Dans les deux cas, fremforge ne fait jamais traiter le code de ses clients par un fournisseur d’IA américain dans la configuration par défaut : consultez la page confiance pour le schéma complet des flux de données.

Serveur MCP

Les assistants qui parlent le Model Context Protocol peuvent se connecter au serveur MCP distant de fremforge à l’adresse https://frem.sh/_app/mcp avec un jeton d’API fremforge (ffp_…), et non avec le jeton d’accès Git que vos outils utilisent pour les dépôts. Il propose des outils en lecture seule pour les résultats de sécurité, les composants, les déploiements, les politiques et les journaux CI. Voir Serveur MCP distant.

Comment fremforge se présente à un outil IA

Tout outil de développement IA qui dialogue avec « GitHub » a en réalité besoin de trois choses :

Git en HTTPS pour git clone / git push. fremforge le fournit à l’adresse https://frem.sh/<org>/<repo>.git.
Un PAT avec les scopes correspondant aux actions qu’il veut effectuer. Sur fremforge, c’est un jeton d’accès Git, avec les scopes Forgejo read:repository, write:repository, read:issue et write:issue.
Une API REST. Les dépôts, les tickets et les pull requests sont servis par l’API Forgejo à https://frem.sh/api/v1/*, qui accepte le jeton d’accès Git. L’API propre à fremforge (résultats de sécurité, composants, politiques, runners) se trouve à https://frem.sh/_app/api/v1/*, accepte un jeton d’API fremforge distinct (ffp_…), et sa spécification se trouve à https://docs.frem.sh/api/openapi.yaml.

Si l’outil propose une option « GitHub Enterprise auto-hébergé », pointez-la vers fremforge. La plupart des outils l’ont. Les pages par outil ci-dessous détaillent les clics exacts.

Créer un PAT pour votre outil IA

Ouvrez Paramètres utilisateur → Jetons d’accès Git (remplacez frem.sh par votre hôte fremforge s’il est auto-hébergé).
Dans la section de votre organisation, ouvrez Créer un nouveau PAT.
Donnez-lui le nom de l’outil (par exemple claude-code, cursor) pour faciliter sa révocation plus tard.
Choisissez les scopes dans les tableaux par outil ci-dessous (read:repository, write:repository, read:issue, write:issue) : commencez restreint, n’ajoutez des scopes que lorsque l’outil renvoie une erreur.
Choisissez la durée de vie la plus courte compatible avec votre façon de travailler ; la politique de votre organisation fixe le maximum.
Cliquez sur Créer le PAT et copiez le jeton. Il ne s’affiche qu’une fois.

L’administrateur de votre organisation décide si les jetons personnels sont autorisés et quels scopes vous pouvez choisir. Tous les guides par outil ci-dessous partent du principe que vous disposez d’un PAT créé de cette façon : il fonctionne pour Git en HTTPS et pour l’API Forgejo à https://frem.sh/api/v1, mais pas pour l’API propre à fremforge ni pour le serveur MCP, qui acceptent un jeton d’API fremforge (ffp_…) créé sur https://frem.sh/<org>/_admin/api-tokens. Les tableaux de scopes sont exacts : l’outil signale clairement une erreur s’il manque un scope.

Guides par outil

Si votre outil n’est pas listé mais prend en charge GitHub Enterprise Server, le principe est le suivant : URL de base = https://frem.sh/api/v1, jeton = votre jeton d’accès Git, et c’est tout. Écrivez à support@frem.sh et nous ajouterons votre outil à cette liste.