LLM Kit
LLM-kit
De FastComments LLM-kit helpt AI-codeerassistenten zoals Claude, ChatGPT en Cursor FastComments te begrijpen en ermee te integreren door ze toegang te geven tot onze volledige documentatie via een eenvoudige zoek-API.
Door een snippet toe te voegen aan het AGENT.md- of CLAUDE.md-bestand van je project, stel je AI-assistenten in staat snel te zoeken en relevante FastComments-documentatie op te halen, waardoor de implementatie sneller en nauwkeuriger verloopt.
Verkrijg de LLM Kit 
Voeg dit fragment toe aan de AI-assistent configuratiebestanden van je project (zoals AGENT.md of CLAUDE.md) dat AI-codeerassistenten leert hoe ze FastComments-documentatie kunnen zoeken en openen.
Op deze manier kan je AI-assistent gemakkelijk actuele informatie krijgen en nauwkeurigere implementaties in minder tijd leveren.
Gebruiksvoorbeeld
Wanneer je een AI-assistent zoals Claude Code of Cursor gebruikt, kun je vragen stellen zoals:
- "Hoe installeer ik FastComments op React?"
- "Laat me zien hoe ik SSO met FastComments configureer"
- "Wat zijn de authenticatie-opties van de FastComments API?"
De AI-assistent zal automatisch de documentatie doorzoeken met behulp van het opgegeven API-eindpunt en je nauwkeurige, actuele antwoorden geven op basis van de officiële documentatie.
MCP Server
FastComments draait een gehoste Model Context Protocol (MCP) server zodat AI‑assistenten en agentische clients de FastComments API direct kunnen aanroepen. Elke tool die de MCP‑server beschikbaar stelt, wordt automatisch gegenereerd vanuit de openbare OpenAPI‑specificatie, dus alles wat de REST API kan doen, kan een MCP‑client doen.
Het eindpunt is stateless en gebaseerd op streamable‑HTTP. Er is geen sessie die actief moet blijven en geen server‑side status per client.
Endpoint
Verbinden met OAuth
Elke MCP‑client die externe servers met OAuth ondersteunt (Claude, ChatGPT, Claude Code, Cursor en anderen) kan verbinding maken met het bovenstaande eindpunt zonder enige configuratie aan de FastComments‑kant. De client registreert zichzelf via Dynamic Client Registration of identificeert zichzelf met een Client ID Metadata Document, opent een browser zodat je kunt inloggen bij FastComments en toegang kunt goedkeuren, en ontvangt een token dat gekoppeld is aan het account waarmee je bent ingelogd.
De discovery‑documenten bevinden zich op de standaardlocaties:
Je gebruiker heeft de API Admin‑rechten op het account nodig om een verbinding goed te keuren. Als je meerdere accounts beheert, schakel dan in het dashboard naar het juiste account voordat je goedkeurt.
Een client kan de read scope, de write scope, of beide aanvragen. Een client die niets aanvraagt, krijgt beide. Tools die gegevens wijzigen, worden niet aangeboden aan een token met alleen‑lezen rechten.
Het dashboard heeft een installatiehulp met kant‑en‑klare snippets om te plakken. Open Integrate -> MCP Server, of bezoek het direct:
Claude Code
Registreer de FastComments‑server met één commando, en voer vervolgens /mcp uit binnen een sessie om in te loggen en de beschikbare tools te tonen:
Cursor en andere config‑bestand clients
Voeg dit blok toe aan de MCP‑serversconfiguratie van je client (mcp.json voor Cursor). De client opent een browser om bij het eerste gebruik in te loggen.
Toegang intrekken
Elke goedgekeurde verbinding wordt weergegeven onder Integrate -> Connected Apps in het dashboard. Het intrekken van één verbinding maakt elk token dat die applicatie bezit ongeldig. Applicaties registreren zichzelf wanneer ze verbinding maken en FastComments beoordeelt ze niet, dus trek alles in dat je niet herkent.
Het token gebruiken met de REST API
Het toegangstoken dat een MCP‑client verkrijgt, is een reguliere FastComments API‑credential. Het werkt op elk /api/v1 eindpunt als een bearer‑token, zodat een applicatie die via MCP is verbonden ook direct de REST API kan aanroepen:
De tenant wordt afgeleid uit het token. Een tenantId kan nog steeds worden meegegeven, maar moet overeenkomen. GET‑verzoeken hebben de read scope nodig en alle andere verzoeken hebben de write scope nodig.
Verbinden met een API‑sleutel
Clients die geen browseraanmelding kunnen voltooien, zoals headless servers, kunnen in plaats daarvan authenticeren met een API‑sleutel. Geef tenantId en API_KEY mee als query‑parameters, of als de x-tenant-id en x-api-key HTTP‑headers als je client aangepaste headers ondersteunt:
De instellingspagina genereert deze URL voor elk van je API‑sleutels.
Beveiliging
Een eindpunt‑URL die een API‑sleutel bevat, is een geheim: plak deze niet in openbare chats, screenshots of commits. Als een sleutel wordt blootgesteld, roteer deze op de API‑sleutels‑pagina in je dashboard. OAuth‑tokens dragen dit risico niet omdat ze gebonden zijn aan één applicatie en kunnen worden ingetrokken via Connected Apps.
Laat een agent uw account instellen
Een coding agent zoals Claude Code, Cursor, of een MCP-gebaseerde assistent kan FastComments voor je instellen zonder dat je het registratieformulier hoeft in te vullen. Dit is handig wanneer je een agent vraagt om "comments toe te voegen aan mijn site" en je nog geen account hebt.
Hoe het werkt
- De agent maakt een nieuw account aan en ontvangt een API key en een claim link. De API key werkt meteen, dus de agent kan het account configureren en de widget op je site installeren.
- De agent geeft je de claim link. Open deze in je browser, log in of maak een login aan, en bevestig de claim. Het account is dan van jou: je beheert het, de facturering ervan, en de API keys vanuit het dashboard. De pagina toont de API key die de agent heeft, zodat je deze kunt intrekken als je niet langer wilt dat de agent, of wie deze ook beheert, toegang heeft.
- Als niemand de claim link binnen 72 uur opent, worden het account en de key verwijderd. Vraag de agent om een nieuw account aan te maken.
Tot het geclaimd is, gelden voor het account dezelfde limieten als voor een normale gratis proefperiode.
Als je al een account hebt
Elke login heeft één account. Als je een claim link opent terwijl je bent ingelogd op een bestaand account, kun je op de pagina kiezen:
- Koppel aan mijn account maakt van het nieuwe account een beheerde tenant van het account waarop je bent ingelogd. Dit vereist een betaald abonnement met white labeling, en het gebruik van de nieuwe tenant wordt gefactureerd op jouw account.
- Log uit en claim met een andere login logt je uit en brengt je terug naar de claim pagina zodat je deze kunt claimen met een andere login.
Voor agent auteurs
De agent instructies op fastcomments.com/agents.md beschrijven de account creation call, de velden in de response, en hoe je de claim link overhandigt aan de persoon voor wie je werkt. De call heeft geen API key nodig en is rate limited per IP address.