LLM Kit

FastComments vodi hostirani Model Context Protocol (MCP) poslužitelj kako bi AI asistenti i agentski klijenti mogli izravno pozivati FastComments API. Svaki alat koji MCP poslužitelj izlaže automatski se generira iz javne OpenAPI specifikacije, tako da sve što REST API može učiniti, može učiniti i MCP klijent.

Endpoint je bezstanjski i temelji se na streamable-HTTP. Nema sesije koju treba održavati niti stanja na poslužitelju po klijentu.

Endpoint

MCP Endpoint

Copy

1

2https://fastcomments.com/mcp

3

Povezivanje putem OAuth-a

Svaki MCP klijent koji podržava udaljene poslužitelje s OAuth-om (Claude, ChatGPT, Claude Code, Cursor i drugi) može se povezati s gore navedenim endpointom bez ikakve postavke na strani FastComments. Klijent se registrira putem Dynamic Client Registration ili se identificira s Client ID Metadata Documentom, otvara preglednik kako biste se prijavili u FastComments i odobrili pristup, te prima token vezan uz račun na koji ste bili 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 API Admin dozvolu na računu kako bi odobrio vezu. Ako upravljate s više računa, prije odobrenja prebacite se na pravi račun u nadzornoj ploči.

Klijent može zatražiti read scope, write scope ili oboje. Klijent koji ništa ne zatraži dobiva oboje. Alati koji mijenjaju podatke nisu dostupni tokenima s samo čitanjem.

Nadzorna ploča ima pomoćnika za postavku s gotovim isječcima za lijepljenje. Otvorite Integrate -> MCP Server ili ga posjetite izravno:

Stranica za postavku

Copy

1

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

3

Claude Code

Registrirajte FastComments poslužitelj jednom naredbom, a zatim pokrenite /mcp unutar sesije kako biste se prijavili i prikazali dostupne alate:

Postavka za Claude Code

Copy

1

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

3

Cursor i drugi klijenti s konfiguracijskom datotekom

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

Konfiguracija MCP klijenta

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Opoziv pristupa

Svaka odobrena veza navedena je pod Integrate -> Connected Apps u nadzornoj ploči. Opoziv jedne poništava svaki token koji ta aplikacija ima. Aplikacije se same registriraju prilikom povezivanja i FastComments ih ne pregledava, pa opozovite sve što ne prepoznajete.

Korištenje tokena s REST API-jem

Pristupni token koji MCP klijent dobije je redovna FastComments API vjerodajnica. Radi na svakom /api/v1 endpointu kao bearer token, tako da aplikacija koja se povezala putem MCP-a može izravno pozivati i REST API:

Bearer Token

Copy

1

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

3

Tenant je impliciran tokenom. tenantId se i dalje može proslijediti, ali mora odgovarati. GET zahtjevi trebaju read scope, a sve ostalo treba write scope.

Povezivanje s API ključem

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

Endpoint s API ključem

Copy

1

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

3

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

Sigurnost

URL endpointa koji sadrži API ključ je tajna: ne lijepite ga u javne razgovore, snimke zaslona ili commitove. Ako je ključ izložen, rotirajte ga na stranici API Keys u vašoj nadzornoj ploči. OAuth tokeni nemaju takav rizik jer su vezani uz jednu aplikaciju i mogu se opozvati iz Connected Apps.

Agent za kodiranje poput Claude Code, Cursor ili MCP-baziranog asistenta može postaviti FastComments za vas bez da vi ispunjavate obrazac za prijavu. Ovo je korisno kada od agenta zatražite da "dodaje komentare mojoj stranici", a još nemate račun.

Kako to funkcionira

1. Agent stvara novi račun i prima API ključ te poveznicu za preuzimanje (claim link). API ključ odmah radi, tako da agent može konfigurirati račun i instalirati widget na vašu stranicu.
2. Agent vam daje poveznicu za preuzimanje. Otvorite je u svom pregledniku, prijavite se ili stvorite prijavu i potvrdite preuzimanje. Račun je tada vaš: njime upravljate, kao i njegovom naplatom i API ključevima, iz nadzorne ploče. Stranica navodi API ključ koji agent drži, tako da ga možete opozvati ako više ne želite da agent, ili tko god ga vodi, ima pristup.
3. Ako nitko ne otvori poveznicu za preuzimanje u roku od 72 sata, račun i njegov ključ brišu se. Zatražite od agenta da stvori novi.

Dok se ne preuzme, račun ima ista ograničenja kao normalno besplatno probno razdoblje.

Ako već imate račun

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

• Pripoji mom računu čini novi račun upravljanim tenantom računa u koji ste prijavljeni. To zahtijeva plaćeni plan s white labeling opcijom, a korištenje novog tenanta naplaćuje se vašem računu.
• Odjavi se i preuzmi s drugom prijavom vas odjavljuje i vraća na stranicu za preuzimanje kako biste ga preuzeli s drugom prijavom.

Za autore agenata

Upute za agenta na fastcomments.com/agents.md opisuju poziv za stvaranje 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 brzini po IP adresi.