AI in je IDE
fremforge blijft buiten je IDE. AI-codeerassistenten (Claude Code, Cursor, Continue, JetBrains AI Assistant, GitHub Copilot Workspace, Codeium en andere) praten met een Git-host zoals elke ontwikkeltool dat doet: HTTPS-Git voor clones en pushes, plus de REST API van de host voor al het andere. fremforge levert de standaardonderdelen (PAT’s, REST API, OpenAPI-specificatie), dus elke AI-tool die al met GitHub of GitLab overweg kan, werkt met drie regels configuratie ook met fremforge.
Wat deze pagina wel en niet is
Deze pagina is de snelstart per tool. Voor elke tool lees je welke PAT-scopes je aanvraagt, waar je de basis-URL van fremforge invult en met welk commando van één regel je controleert of de tool je repository’s kan lezen. Het is GEEN aanbeveling voor een bepaalde tool: fremforge is bewust toolonafhankelijk.
Voor de AI-functies aan de serverkant (AI-review van PR’s, uitleg bij Renovate, het door klanten aan te roepen /ai/complete voor je eigen workflows), zie de beheerpagina AI-integraties binnen je organisatie. Dat is een aparte omgeving, met een ander publiek en een ander soevereiniteitsverhaal. Kort samengevat:
| Omgeving | Publiek | Verwerkt fremforge je code als subverwerker? |
|---|---|---|
| Deze pagina: AI-assistent in de IDE | Individuele ontwikkelaars | Nee: je tool praat rechtstreeks met je AI-leverancier, met jouw sleutel |
| Beheer AI-integraties: PR-review, /ai/complete | Beheerders van de organisatie | Nee: BYOK, jouw tool, jouw contract, jouw leverancier |
Welke weg je ook kiest, standaard laat fremforge klantcode nooit door een Amerikaanse AI-leverancier verwerken; zie de trustpagina voor het volledige diagram van de gegevensstromen.
MCP-server
Assistenten die het Model Context Protocol spreken, kunnen met een fremforge-API-token (ffp_…) verbinding maken met de externe MCP-server van fremforge op https://frem.sh/_app/mcp, niet met het Git-toegangstoken dat je tools voor repository’s gebruiken. Die biedt alleen-lezentools voor bevindingen, componenten, deployments, beleid en CI-logs. Zie Externe MCP-server.
Hoe fremforge eruitziet voor een AI-tool
Elke AI-ontwikkeltool die met “GitHub” praat, wil eigenlijk drie dingen:
- HTTPS-Git voor
git clone/git push. fremforge biedt dat ophttps://frem.sh/<org>/<repo>.git. - Een PAT met scopes voor de acties die de tool wil uitvoeren. Op fremforge is dat een Git-toegangstoken, met de Forgejo-scopes
read:repository,write:repository,read:issueenwrite:issue. - Een REST API. Repository’s, issues en pull requests komen van de Forgejo-API op
https://frem.sh/api/v1/*, die het Git-toegangstoken accepteert. De eigen API van fremforge (bevindingen, componenten, beleid, runners) staat ophttps://frem.sh/_app/api/v1/*, accepteert een apart fremforge-API-token (ffp_…), en de specificatie staat ophttps://docs.frem.sh/api/openapi.yaml.
Heeft de tool een optie voor “self-hosted GitHub Enterprise”, richt die dan op fremforge. De meeste tools hebben die. De pagina’s per tool hieronder lopen de precieze klikken in de interface door.
Een PAT aanmaken voor je AI-tool
- Open Instellingen → Git-toegangstokens (vervang
frem.shdoor je eigen fremforge-host als je zelf host). - Open in het onderdeel van je organisatie Nieuwe PAT aanmaken.
- Noem het naar de tool (bijv.
claude-code,cursor), zodat je het later eenvoudig kunt intrekken. - Kies scopes uit de tabellen per tool hieronder (
read:repository,write:repository,read:issue,write:issue). Begin smal en voeg alleen scopes toe als de tool een fout geeft. - Kies de kortste geldigheidsduur die bij je werkwijze past; het beleid van je organisatie bepaalt het maximum.
- Klik op PAT aanmaken en kopieer het token. Je ziet het maar één keer.
De beheerder van je organisatie bepaalt of persoonlijke tokens zijn toegestaan en welke scopes je kunt kiezen. Elke handleiding per tool hieronder gaat uit van een PAT dat op deze manier is aangemaakt: het werkt voor Git via HTTPS en voor de Forgejo-API op https://frem.sh/api/v1, niet voor de eigen API van fremforge of de MCP-server, die een fremforge-API-token (ffp_…) van https://frem.sh/<org>/_admin/api-tokens accepteren. De scopetabellen zijn exact: ontbreekt er een scope, dan geeft de tool een duidelijke foutmelding.
Handleidingen per tool
Staat je tool er niet bij maar ondersteunt hij GitHub Enterprise Server, dan is het patroon: basis-URL = https://frem.sh/api/v1, token = je Git-toegangstoken, en je bent klaar. Open een issue via support@frem.sh en we voegen je tool aan deze lijst toe.