Claude Code

Claude Code is de codeerassistent van Anthropic voor de command line. Die heeft twee dingen van fremforge nodig: HTTPS-toegang tot Git om repository’s te clonen, en een Git-toegangstoken voor bewerkingen op issues en PR’s. De MCP-server van fremforge is optioneel en accepteert een apart fremforge-API-token (ffp_…): het Git-toegangstoken is voor repository’s, issues en pull requests, het API-token voor de eigen gegevens van fremforge, zoals bevindingen en componenten.

Inrichten in één keer

# 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>"

De MCP-server heeft een fremforge-API-token nodig met de leesscopes van de tools die je gebruikt. Zie Externe MCP-server voor de lijst met tools, de scopes en andere clients. (Deze pagina noemde vroeger een npm-pakket @fremforge/mcp-server. Dat pakket is nooit gepubliceerd; de externe server vervangt het.)

Wil je liever dat Claude Code de kale REST API gebruikt zonder MCP-server, zet dan een CLAUDE.md in de root van je repository:

# 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 leest CLAUDE.md als projectcontext.

Controleren

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

Dat hoort <org>/<repo> te tonen. Krijg je een 401 of 404, controleer dan het token en de scopes ervan opnieuw.

Wat je vanuit Claude Code kunt doen

Actie	Token en scope
Bestanden in repository’s lezen, zoeken over repository’s heen	Git-toegangstoken: `read:repository`
PR’s aanmaken en bijwerken, branches pushen	Git-toegangstoken: `write:repository`
Issues lezen, doorzoeken en erop reageren	Git-toegangstoken: `read:issue`, `write:issue`
Het auditlog van je organisatie lezen	fremforge-API-token: `audit:read`
Je eigen API-tokens aanmaken of intrekken	fremforge-API-token: `tokens:manage`

Over soevereiniteit

Als Claude Code je code leest en naar de API van Anthropic stuurt, is dat een zaak tussen jou en Anthropic: fremforge zit niet in dat pad. Je Git-toegangstoken en je fremforge-API-token zijn puur voor toegang tot Git en de REST API; ze machtigen Claude Code nooit om namens fremforge een AI-leverancier aan te roepen.

Wil je de AI-functies aan de serverkant (PR-review bij elke push, /ai/complete vanuit workflows), dan is dat een aparte inrichting; zie de trustpagina over AI-integraties.

Cursor