LLM-sæt

FastComments driver en hostet Model Context Protocol (MCP)-server, så AI-assistenter og agentiske klienter kan kalde FastComments API direkte. Hvert værktøj, som MCP-serveren eksponerer, er automatisk genereret fra den offentlige OpenAPI-spec, så alt hvad REST API'en kan, kan en MCP-klient også gøre.

Endpointet er stateless og baseret på streamable-HTTP. Der er ingen session, der skal holdes i live, og ingen server-side tilstand pr. klient.

Endpoint

MCP Endpoint

Copy

1

2https://fastcomments.com/mcp

3

Forbind med OAuth

Enhver MCP-klient, der understøtter fjernservere med OAuth (Claude, ChatGPT, Claude Code, Cursor og andre), kan forbinde til endpointet ovenfor uden opsætning på FastComments-siden. Klienten registrerer sig selv via Dynamic Client Registration eller identificerer sig med et Client ID Metadata Document, åbner en browser, så du kan logge ind på FastComments og godkende adgangen, og modtager en token bundet til den konto, du var logget ind på.

Discovery-dokumenterne findes på standardplaceringerne:

Discovery

Copy

1

2https://fastcomments.com/.well-known/oauth-protected-resource/mcp

3https://fastcomments.com/.well-known/oauth-authorization-server

4

Din bruger skal have API Admin-tilladelsen på kontoen for at godkende en forbindelse. Hvis du administrerer flere konti, så skift til den rigtige i dashboardet, før du godkender.

En klient kan anmode om read-scope, write-scope eller begge. En klient, der ikke anmoder om noget, får begge. Værktøjer, der ændrer data, tilbydes ikke til en read-only token.

Dashboardet har en opsætningshjælper med klar-til-indsættelse kodestykker. Åbn Integrate -> MCP Server, eller besøg den direkte:

Opsætningsside

Copy

1

2https://fastcomments.com/auth/my-account/mcp-setup

3

Claude Code

Registrér FastComments-serveren med én kommando, og kør derefter /mcp inde i en session for at logge ind og se de tilgængelige værktøjer:

Claude Code Opsætning

Copy

1

2claude mcp add --transport http fastcomments https://fastcomments.com/mcp

3

Cursor og andre config-fil-klienter

Tilføj denne blok til din klients MCP-servers-konfiguration (mcp.json for Cursor). Klienten åbner en browser til login ved første brug.

MCP-klientkonfiguration

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

6 "url": "https://fastcomments.com/mcp"

7 }

8 }

9}

10

Tilbagekaldelse af adgang

Enhver godkendt forbindelse er listet under Integrate -> Connected Apps i dashboardet. Tilbagekaldelse af en forbindelse ugyldiggør alle tokens, som applikationen holder. Applikationer registrerer sig selv, når de forbinder, og FastComments gennemgår dem ikke, så tilbagekald alt, du ikke genkender.

Brug af token med REST API'en

Den access token, som en MCP-klient opnår, er en almindelig FastComments API-credential. Den virker på alle /api/v1-endpoints som en bearer token, så en applikation, der har forbundet via MCP, også kan kalde REST API'en direkte:

Bearer Token

Copy

1

2curl -H "Authorization: Bearer fcat_..." https://fastcomments.com/api/v1/comments

3

Tenanten er underforstået af tokenen. En tenantId kan stadig sendes med, men den skal matche. GET-requests kræver read-scope, og alt andet kræver write-scope.

Forbind med en API-nøgle

Klienter, der ikke kan gennemføre et browser-login, såsom headless-servere, kan i stedet autentificere med en API-nøgle. Send tenantId og API_KEY som query-parametre, eller som x-tenant-id- og x-api-key-HTTP-headers, hvis din klient understøtter custom headers:

API-nøgle Endpoint

Copy

1

2https://fastcomments.com/mcp?tenantId=YOUR_TENANT_ID&API_KEY=YOUR_API_KEY

3

Opsætningssiden genererer denne URL for hver af dine API-nøgler.

Sikkerhed

En endpoint-URL, der indeholder en API-nøgle, er en hemmelighed: indsæt den ikke i offentlige chats, screenshots eller commits. Hvis en nøgle er blevet eksponeret, så rotér den på API Keys-siden i dit dashboard. OAuth-tokens bærer ikke denne risiko, da de er bundet til én applikation og kan tilbagekaldes fra Connected Apps.

En kodningsagent såsom Claude Code, Cursor eller en MCP-baseret assistent kan sætte FastComments op for dig, uden at du skal udfylde tilmeldingsformularen. Dette er nyttigt, når du beder en agent om at "tilføje kommentarer til mit site", og du endnu ikke har en konto.

Sådan fungerer det

1. Agenten opretter en ny konto og modtager en API-nøgle og et claim-link. API-nøglen virker med det samme, så agenten kan konfigurere kontoen og installere widget'en på dit site.
2. Agenten giver dig claim-linket. Åbn det i din browser, log ind eller opret et login, og bekræft claimet. Kontoen er derefter din: du administrerer den, dens fakturering og dens API-nøgler fra dashboardet. Siden viser den API-nøgle, som agenten har, så du kan tilbagekalde den, hvis du ikke længere ønsker, at agenten – eller den, der driver den – skal have adgang.
3. Hvis ingen åbner claim-linket inden for 72 timer, slettes kontoen og dens nøgle. Bed agenten om at oprette en ny.

Indtil den bliver claimet, har kontoen de samme begrænsninger som en normal gratis prøveperiode.

Hvis du allerede har en konto

Hvert login ejer én konto. Hvis du åbner et claim-link, mens du er logget ind på en eksisterende konto, giver siden dig mulighed for at vælge:

• Tilknyt min konto gør den nye konto til en administreret tenant under den konto, du er logget ind på. Dette kræver en betalt plan med white labeling, og den nye tenants forbrug faktureres til din konto.
• Log ud og claim med et andet login logger dig ud og bringer dig tilbage til claim-siden, så du kan claimet den med et andet login.

Til agentforfattere

Agentinstruktionerne på fastcomments.com/agents.md beskriver kaldet til oprettelse af konto, felterne i svaret og hvordan claim-linket overdrages til den person, du arbejder for. Kaldet kræver ingen API-nøgle og er rate-begrænset pr. IP-adresse.