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
A coding agent such as Claude Code, Cursor, or an MCP-based assistant can set up FastComments for you without you filling in the signup form. This is useful when you ask an agent to "add comments to my site" and you do not have an account yet.
Hoe het werkt
- De agent maakt een nieuw account aan en ontvangt een API‑sleutel en een claim‑link. De API‑sleutel werkt meteen, zodat de agent het account kan configureren en de widget op je site kan 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 en de API‑sleutels via het dashboard. De pagina toont de API‑sleutel die de agent bezit, zodat je deze kunt intrekken als je de agent, of wie het ook uitvoert, geen toegang meer wilt geven.
- Als niemand de claim‑link binnen 72 uur opent, worden het account en de sleutel verwijderd. Vraag de agent om een nieuwe aan te maken.
Totdat het is geclaimd, heeft het account dezelfde limieten als een normale gratis proefperiode.
Als je al een account hebt
Elke login bezit één account. Als je een claim‑link opent terwijl je bent ingelogd op een bestaand account, laat de pagina je kiezen:
- Koppel aan mijn account maakt van het nieuwe account een beheerde tenant van het account waarin je bent ingelogd. Dit vereist een betaald abonnement met white‑labeling, en het gebruik van de nieuwe tenant wordt gefactureerd aan 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‑aanmaak‑call, de velden in de respons, en hoe je de claim‑link aan de persoon kunt overhandigen waarvoor je werkt. De call vereist geen API‑sleutel en is per IP‑adres rate‑gelimiteerd.