LLM Kit

FastComments pokreće hostani Model Context Protocol (MCP) poslužitelj kako bi AI asistenti i agentni klijenti mogli izravno pozivati FastComments API. Svaki alat koji MCP poslužitelj izlaže automatski je generiran iz javne OpenAPI specifikacije, pa sve što REST API može učiniti, MCP klijent također može učiniti.

Krajnja točka je bez stanja i temeljena na streamable-HTTP. Nema sesije koja se mora održavati i nema server‑side stanja po klijentu.

Endpoint

MCP krajnja točka

Copy

1

2https://fastcomments.com/mcp

3

Connect with OAuth

Bilo koji MCP klijent koji podržava udaljene poslužitelje s OAuth-om (Claude, ChatGPT, Claude Code, Cursor i drugi) može se povezati na gore navedenu krajnju točku bez ikakve postavke na FastComments strani. Klijent se registrira putem Dinamičke registracije klijenta ili se identificira pomoću Dokumenta metapodataka ID‑klijenta, otvara preglednik kako biste se mogli prijaviti u FastComments i odobriti pristup, te prima token vezan uz račun na koji ste prijavljeni.

Dokumenti za otkrivanje nalaze se na standardnim lokacijama:

Otkrivanje

Copy

1

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

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

4

Vaš korisnik treba imati dozvolu API Admin na računu kako bi odobrio vezu. Ako upravljate s više računa, prije odobravanja prebacite se na pravi račun u nadzornoj ploči.

Klijent može zatražiti read opseg, write opseg ili oba. Klijent koji ne zatraži ništa dobiva oba. Alati koji mijenjaju podatke nisu dostupni tokenu s pravom samo za čitanje.

Nadzorna ploča ima pomoćnik za postavljanje s isječcima spremnim za umetanje. Otvorite Integrate -> MCP Server, ili ga posjetite izravno:

Stranica postavki

Copy

1

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

3

Claude Code

Registrirajte FastComments poslužitelj jednim naredbom, zatim pokrenite /mcp unutar sesije za prijavu i popis dostupnih alata:

Postavljanje Claude Code

Copy

1

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

3

Cursor and other config-file clients

Dodajte ovaj blok u konfiguraciju MCP poslužitelja vašeg klijenta (mcp.json za Cursor). Klijent otvara preglednik za prijavu pri prvom korištenju.

MCP konfiguracija klijenta

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Revoking access

Svaka odobrena veza nalazi se pod Integrate -> Connected Apps u nadzornoj ploči. Povlačenjem jedne veze poništava se svaki token koji ta aplikacija drži. Aplikacije se registriraju kada se povežu, a FastComments ih ne pregledava, stoga povucite sve što ne prepoznajete.

Using the token with the REST API

Pristupni token koji MCP klijent dobije je regularna FastComments API vjerodajnica. Djeluje na svakoj /api/v1 krajnjoj točki kao token nositelja, pa aplikacija koja se poveže putem MCP-a također može izravno pozivati REST API:

Token nositelja

Copy

1

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

3

Najmodavac (tenant) je impliciran tokenom. tenantId se i dalje može proslijediti, ali mora se podudarati. GET zahtjevi trebaju read opseg, a sve ostalo write opseg.

Connect with an API key

Klijenti koji ne mogu dovršiti prijavu putem preglednika, poput headless poslužitelja, mogu se autentificirati pomoću API ključa. Proslijedite tenantId i API_KEY kao parametre upita, ili kao HTTP zaglavlja x-tenant-id i x-api-key ako vaš klijent podržava prilagođena zaglavlja:

Krajnja točka API ključa

Copy

1

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

3

Stranica postavki generira ovaj URL za svaki od vaših API ključeva.

Security

URL krajnje točke koji sadrži API ključ je tajna: nemojte ga zalijepiti u javne razgovore, snimke zaslona ili commitove. Ako je ključ otkriven, zamijenite ga na stranici API ključeva u vašoj nadzornoj ploči. OAuth tokeni ne nose takav rizik jer su vezani uz jednu aplikaciju i mogu se povući iz Connected Apps.

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.

Kako funkcionira

1. Agent kreira novi račun i dobiva API ključ i poveznicu za preuzimanje. API ključ odmah funkcionira, pa agent može konfigurirati račun i instalirati widget na vašu stranicu.
2. Agent vam daje poveznicu za preuzimanje. Otvorite je u pregledniku, prijavite se ili kreirajte prijavu, i potvrdite preuzimanje. Račun tada postaje vaš: vi ga upravljate, njegovu naplatu i API ključeve iz nadzorne ploče. Stranica prikazuje API ključ koji agent posjeduje kako biste ga mogli opozvati ako više ne želite da agent ili tko god ga koristi ima pristup.
3. Ako nitko ne otvori poveznicu za preuzimanje u roku od 72 sata, račun i njegov ključ se brišu. Zamolite agenta da kreira novi.

Dok se ne preuzme, račun ima iste ograničenja kao obična besplatna probna verzija.

Ako već imate račun

Svaka prijava posjeduje jedan račun. Ako otvorite poveznicu za preuzimanje dok ste prijavljeni na postojeći račun, stranica vam omogućuje odabir:

• Attach to my account čini novi račun upravljanim najemnikom onog na koji ste prijavljeni. To zahtijeva plaćeni plan s bijelim označavanjem, a korištenje novog najemnika naplaćuje se s vašeg računa.
• Sign out and claim with another login odjavljuje vas i vraća na stranicu za preuzimanje kako biste ga mogli preuzeti s drugom prijavom.

Za autore agenata

Upute za agente na fastcomments.com/agents.md opisuju poziv za kreiranje računa, polja u odgovoru i kako predati poveznicu za preuzimanje osobi za koju radite. Poziv ne zahtijeva API ključ i ograničen je po IP adresi.