LLM komplet

FastComments poganja gostovan strežnik Model Context Protocol (MCP), tako da AI asistenti in agentni odjemalci lahko neposredno kličijo FastComments API. Vsako orodje, ki ga strežnik MCP razkrije, je samodejno ustvarjeno iz javne specifikacije OpenAPI, zato lahko MCP odjemalec naredi vse, kar lahko REST API.

Končna točka je brez stanja in temelji na streamable‑HTTP. Ni seje, ki bi jo bilo treba ohranjati, in ni strežniškega stanja na odjemalca.

Končna točka

MCP končna točka

Copy

1

2https://fastcomments.com/mcp

3

Povezava z OAuth

Katerikoli MCP odjemalec, ki podpira oddaljene strežnike z OAuth (Claude, ChatGPT, Claude Code, Cursor in drugi), se lahko poveže z zgornjo končno točko brez dodatne nastavitve na strani FastComments. Odjemalec se registrira prek dinamične registracije odjemalcev ali se identificira z dokumentom metapodatkov ID‑ja odjemalca, odpre brskalnik, da se lahko prijavite v FastComments in odobrite dostop, ter prejme žeton, vezan na račun, v katerega ste se prijavili.

Dokumenti za odkrivanje so na standardnih lokacijah:

Odkrivanje

Copy

1

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

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

4

Vaš uporabnik potrebuje dovoljenje API Admin na računu, da odobri povezavo. Če upravljate z več računi, preklopite na pravi v nadzorni plošči, preden odobrite.

Odjemalec lahko zahteva obseg read, obseg write ali oba. Odjemalec, ki ne zahteva ničesar, prejme oba. Orodja, ki spreminjajo podatke, niso na voljo za žeton samo za branje.

Nadzorna plošča ima pomočnika za nastavitve s pripravljenimi izrezki za lepljenje. Odprite Integrate -> MCP Server, ali obiščite neposredno:

Stran nastavitve

Copy

1

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

3

Claude Code

Registrirajte FastComments strežnik z enim ukazom, nato zaženite /mcp v seji, da se prijavite in izpišete razpoložljiva orodja:

Nastavitev Claude Code

Copy

1

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

3

Cursor in drugi odjemalci s konfiguracijsko datoteko

Dodajte ta blok v konfiguracijo MCP strežnikov vašega odjemalca (mcp.json za Cursor). Odjemalec odpre brskalnik za prijavo ob prvi uporabi.

Konfiguracija MCP odjemalca

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Preklic dostopa

Vsaka odobrena povezava je navedena pod Integrate -> Connected Apps v nadzorni plošči. Preklic ene povezave razveljavi vsak žeton, ki ga aplikacija ima. Aplikacije se registrirajo, ko se povežejo, FastComments jih ne pregleda, zato prekličite vse, kar ne prepoznate.

Uporaba žetona z REST API

Dostopni žeton, ki ga pridobi MCP odjemalec, je običajno poverilnico FastComments API. Deluje na vsaki končni točki /api/v1 kot žeton nosilca, zato lahko aplikacija, ki se je povezana prek MCP, neposredno kliče tudi REST API:

Žeton nosilca

Copy

1

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

3

Najemnik je impliciran v žetonu. tenantId je še vedno mogoče posredovati, vendar se mora ujemati. GET zahteve potrebujejo obseg read, vse ostalo pa obseg write.

Povezava z API ključem

Odjemalci, ki ne morejo dokončati prijave v brskalniku, kot so brezglave strežniki, se lahko namesto tega avtenticirajo z API ključem. Posredujte tenantId in API_KEY kot parametra poizvedbe ali kot HTTP glave x-tenant-id in x-api-key, če vaš odjemalec podpira prilagojene glave:

Končna točka API ključa

Copy

1

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

3

Stran za nastavitve ustvari ta URL za vsak vaš API ključ.

Varnost

URL končne točke, ki vsebuje API ključ, je skrivnost: ne prilepite ga v javne klepete, posnetke zaslona ali commite. Če je ključ izpostavljen, ga zamenjajte na strani API ključev v vaši nadzorni plošči. OAuth žetoni ne predstavljajo takšnega tveganja, ker so vezani na eno aplikacijo in jih je mogoče preklicati v Connected Apps.

Kodirni agent, kot so Claude Code, Cursor ali pomočnik na osnovi MCP, lahko nastavi FastComments namesto vas, brez da bi izpolnili prijavni obrazec. To je uporabno, ko agenta prosite, da "doda komentarje moji spletni strani", vi pa še nimate računa.

Kako deluje

1. Agent ustvari nov račun in prejme API ključ ter povezavo za prevzem računa. API ključ deluje takoj, zato lahko agent konfigurira račun in namesti pripomoček (widget) na vašo spletno stran.
2. Agent vam posreduje povezavo za prevzem. Odprite jo v brskalniku, se prijavite ali ustvarite prijavo in potrdite prevzem. Račun je nato vaš: upravljate ga, njegovo obračunavanje in njegove API ključe iz nadzorne plošče. Stran navaja API ključ, ki ga ima agent, tako da ga lahko prekličete, če ne želite več, da ima agent ali tisti, ki ga upravlja, dostop.
3. Če nihče ne odpre povezave za prevzem v 72 urah, sta račun in njegov ključ izbrisana. Prosite agenta, da ustvari novega.

Dokler račun ni prevzet, ima enake omejitve kot običajno brezplačno preizkusno obdobje.

Če že imate račun

Vsaka prijava ima en račun. Če odprete povezavo za prevzem, medtem ko ste prijavljeni v obstoječi račun, vam stran omogoča izbiro:

• Pripni k mojemu računu naredi nov račun upravljani najemnik (tenant) računa, v katerega ste prijavljeni. To zahteva plačljivi paket z belo označbo (white labeling), uporaba novega najemnika pa se obračuna na vaš račun.
• Odjavi se in prevzemi z drugo prijavo vas odjavi in vrne na stran za prevzem, da ga lahko prevzamete z drugo prijavo.

Za avtorje agentov

Navodila za agente na fastcomments.com/agents.md opisujejo klic za ustvarjanje računa, polja v odgovoru in kako posredovati povezavo za prevzem osebi, za katero delate. Klic ne potrebuje API ključa in je omejen na hitrost glede na IP naslov.