LLM komplet

FastComments vodi hostovani Model Context Protocol (MCP) server kako bi AI asistenti i agentski klijenti mogli direktno da pozivaju FastComments API. Svaki alat koji MCP server izlaže automatski se generiše iz javnog OpenAPI specifikacije, tako da sve što REST API može, MCP klijent može.

Endpoint je bezstanjan (stateless) i zasnovan na streamable-HTTP. Ne postoji sesija koju treba održavati niti server-side stanje po klijentu.

Endpoint

MCP Endpoint

Copy

1

2https://fastcomments.com/mcp

3

Povezivanje putem OAuth-a

Svaki MCP klijent koji podržava udaljene servere sa OAuth-om (Claude, ChatGPT, Claude Code, Cursor i drugi) može se povezati na gore navedeni endpoint bez ikakve konfiguracije na strani FastComments-a. Klijent se registruje putem Dynamic Client Registration-a ili se identifikuje pomoću Client ID Metadata Document-a, otvara pregledač kako biste se prijavili na FastComments i odobrili pristup, i dobija token vezan za nalog na koji ste bili prijavljeni.

Dokumenti za otkrivanje (discovery) nalaze se na standardnim lokacijama:

Discovery

Copy

1

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

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

4

Vaš korisnik treba da ima API Admin dozvolu na nalogu kako bi odobrio vezu. Ako upravljate više naloga, prebacite se na pravi u kontrolnoj tabli pre odobravanja.

Klijent može zahtevati read scope, write scope ili oba. Klijent koji ne zahteva ništa dobija oba. Alati koji menjaju podaci se ne nude read-only tokenu.

Kontrolna tabla ima pomoćnika za podešavanje sa gotovim isečcima koda spremnim za lepljenje. Otvorite Integrate -> MCP Server, ili posetite direktno:

Stranica za podešavanje

Copy

1

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

3

Claude Code

Registrujte FastComments server jednom komandom, a zatim pokrenite /mcp unutar sesije da se prijavite i izlistate dostupne alate:

Claude Code podešavanje

Copy

1

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

3

Cursor i drugi klijenti sa konfiguracionim fajlom

Dodajte ovaj blok u MCP servers konfiguraciju vašeg klijenta (mcp.json za Cursor). Klijent otvara pregledač za prijavu pri prvom korišćenju.

MCP klijent konfiguracija

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 je izlistana pod Integrate -> Connected Apps u kontrolnoj tabli. Opoziv jedne poništava svaki token koji ta aplikacija drži. Aplikacije se same registruju prilikom povezivanja i FastComments ih ne pregleda, pa opozovite sve što ne prepoznajete.

Korišćenje tokena sa REST API-jem

Access token koji MCP klijent dobije je običan FastComments API kredencijal. Radi na svakom /api/v1 endpointu kao bearer token, tako da aplikacija koja se povezala putem MCP-a može takođe direktno pozivati REST API:

Bearer Token

Copy

1

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

3

Tenant je podrazumevan iz tokena. tenantId se i dalje može proslediti ali mora da se poklapa. GET zahtevi zahtevaju read scope a sve ostalo write scope.

Povezivanje sa API ključem

Klijenti koji ne mogu da završe prijavu kroz pregledač, kao što su headless serveri, mogu se autentifikovati API ključem umesto toga. Prosledite tenantId i API_KEY kao query parametre, ili kao x-tenant-id i x-api-key HTTP header-e ako vaš klijent podržava prilagođene header-e:

Endpoint sa API ključem

Copy

1

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

3

Stranica za podešavanje generiše ovaj URL za svaki od vaših API ključeva.

Bezbednost

URL endpointa koji sadrži API ključ je tajna: ne lepite ga u javne razgovore, screenshot-ove ili commit-ove. Ako je ključ izložen, rotirajte ga na API Keys stranici u vašoj kontrolnoj tabli. OAuth tokeni ne nose takav rizik jer su vezani za jednu aplikaciju i mogu se opozvati iz Connected Apps.

A coding agent, poput Claude Code, Cursor ili asistenta zasnovanog na MCP, može postaviti FastComments za vas bez da popunjavate formular za registraciju. Ovo je korisno kada zatražite od agenta da "dodaje komentare na moj sajt" i još nemate nalog.

Kako funkcioniše

1. Agent kreira novi nalog i dobija API ključ i claim link. API ključ odmah funkcioniše, tako da agent može konfigurisati nalog i instalirati widget na vaš sajt.
2. Agent vam daje claim link. Otvorite ga u vašem pretraživaču, prijavite se ili kreirajte login, i potvrdite claim. Nalog tada postaje vaš: vi upravljate njime, njegovim naplatama i API ključevima putem kontrolne table. Stranica prikazuje API ključ koji agent drži, kako biste ga mogli opozvati ako više ne želite da agent, ili ko ga koristi, ima pristup.
3. Ako niko ne otvori claim link u roku od 72 sata, nalog i njegov ključ se brišu. Zamolite agenta da kreira novi.

Dok se ne preuzme, nalog ima ista ograničenja kao obična besplatna probna verzija.

Ako već imate nalog

Svaka prijava (login) poseduje jedan nalog. Ako otvorite claim link dok ste prijavljeni na postojeći nalog, stranica vam omogućava da izaberete:

• Attach to my account čini novi nalog upravljanim tenantom onog na koji ste prijavljeni. Ovo zahteva plaćeni plan sa white labeling-om, a korišćenje novog tenant-a se naplaćuje vašem nalogu.
• Sign out and claim with another login odjavljuje vas i vraća na stranicu za claim kako biste je mogli preuzeti drugim login-om.

Za autore agenata

Uputstva za agente na fastcomments.com/agents.md opisuju poziv za kreiranje naloga, polja u odgovoru i kako da predate claim link osobi za koju radite. Poziv ne zahteva API ključ i ograničen je po brzini po IP adresi.