Claude Code

Claude Code est l’assistant de code en ligne de commande d’Anthropic. Il a besoin de deux choses de la part de fremforge : un accès Git en HTTPS pour cloner les dépôts, et un jeton d’accès Git pour les opérations sur les tickets et les PR. Le serveur MCP de fremforge est facultatif et accepte un jeton d’API fremforge distinct (ffp_…) : le jeton d’accès Git sert aux dépôts, aux tickets et aux pull requests, le jeton d’API aux données propres à fremforge, comme les résultats de sécurité et les composants.

Configuration en une fois

# 1. Mint a Git access token at frem.sh/user/settings#ff-git-pats with these scopes:
#      read:repository  write:repository  read:issue  write:issue
#    Copy the token.

# 2. Tell Git Credential Manager about it so HTTPS clones don't prompt:
export FREMFORGE_GIT_TOKEN='<your-git-token>'
git config --global credential.https://frem.sh.helper '!f() { echo username=token; echo password=$FREMFORGE_GIT_TOKEN; }; f'

# 3. Connect Claude Code to fremforge's remote MCP server (fremforge API token, not the Git access token):
claude mcp add --transport http fremforge https://frem.sh/_app/mcp \
  --header "Authorization: Bearer ffp_<your-token>"

Le serveur MCP a besoin d’un jeton d’API fremforge avec les scopes de lecture des outils que vous utilisez. Consultez Serveur MCP distant pour la liste des outils, les scopes et les autres clients. (Cette page mentionnait autrefois un paquet npm @fremforge/mcp-server. Ce paquet n’a jamais été publié ; le serveur distant le remplace.)

Ou, si vous préférez que Claude Code utilise directement l’API REST sans serveur MCP, placez un fichier CLAUDE.md à la racine de votre dépôt :

# fremforge config

Repositories, issues, PRs: https://frem.sh/api/v1 (Forgejo API)
Auth header:   Authorization: token $FREMFORGE_GIT_TOKEN
fremforge API: https://frem.sh/_app/api/v1 (findings, components, policies)
OpenAPI spec:  https://docs.frem.sh/api/openapi.yaml
Auth header:   Authorization: Bearer $FREMFORGE_TOKEN (an ffp_… API token)

Claude Code lit CLAUDE.md comme contexte du projet.

Vérifier

curl -sf https://frem.sh/api/v1/repos/<org>/<repo> -H "Authorization: token $FREMFORGE_GIT_TOKEN" | jq .full_name

La commande doit afficher <org>/<repo>. Si elle renvoie une erreur 401 ou 404, revérifiez le jeton et ses scopes.

Ce que vous pouvez faire depuis Claude Code

Action	Jeton et scope
Lire les fichiers d’un dépôt, rechercher dans plusieurs dépôts	Jeton d’accès Git : `read:repository`
Créer / mettre à jour des PR, pousser des branches	Jeton d’accès Git : `write:repository`
Lire / rechercher / commenter des tickets	Jeton d’accès Git : `read:issue`, `write:issue`
Lire le journal d’audit de votre organisation	Jeton d’API fremforge : `audit:read`
Créer ou révoquer vos propres jetons d’API	Jeton d’API fremforge : `tokens:manage`

Note sur la souveraineté

Lorsque Claude Code lit votre code et l’envoie à l’API d’Anthropic, cela se passe entre vous et Anthropic : fremforge n’est pas sur le chemin. Votre jeton d’accès Git et votre jeton d’API fremforge servent uniquement à l’accès Git et REST ; ils n’autorisent jamais Claude Code à appeler un fournisseur d’IA au nom de fremforge.

Si vous voulez les fonctionnalités IA côté serveur (relecture de PR à chaque push, /ai/complete depuis les workflows), c’est une configuration distincte, décrite sur la page confiance des intégrations IA.

Cursor