Zestaw LLM

FastComments uruchamia hostowany serwer Model Context Protocol (MCP), dzięki czemu asystenci AI i klienci agentowi mogą bezpośrednio wywoływać API FastComments. Każde narzędzie udostępniane przez serwer MCP jest automatycznie generowane na podstawie publicznej specyfikacji OpenAPI, więc wszystko, co potrafi REST API, może zrobić klient MCP.

Endpoint jest bezstanowy i oparty na streamable-HTTP. Nie ma sesji do utrzymywania ani stanu po stronie serwera dla poszczególnych klientów.

Endpoint

Endpoint MCP

Copy

1

2https://fastcomments.com/mcp

3

Połączenie przez OAuth

Każdy klient MCP obsługujący zdalne serwery z OAuth (Claude, ChatGPT, Claude Code, Cursor i inne) może połączyć się z powyższym endpointem bez żadnej konfiguracji po stronie FastComments. Klient rejestruje się samodzielnie poprzez Dynamic Client Registration lub identyfikuje się za pomocą Client ID Metadata Document, otwiera przeglądarkę, abyś mógł zalogować się do FastComments i zatwierdzić dostęp, a następnie otrzymuje token powiązany z kontem, na które byłeś zalogowany.

Dokumenty discovery znajdują się w standardowych lokalizacjach:

Discovery

Copy

1

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

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

4

Twój użytkownik musi mieć uprawnienie API Admin na koncie, aby zatwierdzić połączenie. Jeśli zarządzasz kilkoma kontami, przełącz się na właściwe w panelu przed zatwierdzeniem.

Klient może zażądać scope read, scope write lub obu. Klient, który niczego nie zażąda, otrzymuje oba. Narzędzia zmieniające dane nie są udostępniane tokenowi tylko do odczytu.

Panel zawiera kreator konfiguracji z gotowymi do wklejenia fragmentami kodu. Otwórz Integrate -> MCP Server lub odwiedź go bezpośrednio:

Strona konfiguracji

Copy

1

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

3

Claude Code

Zarejestruj serwer FastComments jedną komendą, a następnie uruchom /mcp wewnątrz sesji, aby się zalogować i wyświetlić dostępne narzędzia:

Konfiguracja Claude Code

Copy

1

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

3

Cursor i inni klienci z plikiem konfiguracyjnym

Dodaj ten blok do konfiguracji serwerów MCP swojego klienta (mcp.json w przypadku Cursor). Klient otworzy przeglądarkę do logowania przy pierwszym użyciu.

Konfiguracja klienta MCP

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Odwoływanie dostępu

Każde zatwierdzone połączenie jest widoczne w sekcji Integrate -> Connected Apps w panelu. Odwołanie połączenia unieważnia wszystkie tokeny, które dana aplikacja posiada. Aplikacje rejestrują się same podczas łączenia, a FastComments ich nie weryfikuje, więc odwołaj wszystko, czego nie rozpoznajesz.

Używanie tokenu z REST API

Token dostępu uzyskany przez klienta MCP to zwykłe poświadczenie API FastComments. Działa na każdym endpoincie /api/v1 jako token bearer, więc aplikacja, która połączyła się przez MCP, może również wywoływać REST API bezpośrednio:

Token Bearer

Copy

1

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

3

Tenant wynika z tokenu. tenantId nadal może być przekazany, ale musi się zgadzać. Żądania GET wymagają scope read, a wszystko inne wymaga scope write.

Połączenie za pomocą klucza API

Klienci, którzy nie mogą ukończyć logowania przez przeglądarkę, na przykład serwery headless, mogą uwierzytelnić się za pomocą klucza API. Przekaż tenantId i API_KEY jako parametry zapytania lub jako nagłówki HTTP x-tenant-id i x-api-key, jeśli Twój klient obsługuje niestandardowe nagłówki:

Endpoint z kluczem API

Copy

1

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

3

Strona konfiguracji generuje ten URL dla każdego z Twoich kluczy API.

Bezpieczeństwo

URL endpointu zawierający klucz API jest tajemnicą: nie wklejaj go do publicznych czatów, zrzutów ekranu ani commitów. Jeśli klucz został ujawniony, zmień go na stronie API Keys w panelu. Tokeny OAuth nie niosą takiego ryzyka, ponieważ są powiązane z jedną aplikacją i można je odwołać w Connected Apps.

Agent programistyczny, taki jak Claude Code, Cursor lub asystent oparty na MCP, może skonfigurować FastComments za Ciebie, bez wypełniania formularza rejestracji. Jest to przydatne, gdy prosisz agenta o "add comments to my site" i nie masz jeszcze konta.

Jak to działa

1. Agent tworzy nowe konto i otrzymuje klucz API oraz link do przejęcia. Klucz API działa od razu, więc agent może skonfigurować konto i zainstalować widget na Twojej stronie.
2. Agent przekazuje Ci link do przejęcia. Otwórz go w przeglądarce, zaloguj się lub utwórz konto, i potwierdź przejęcie. Konto staje się Twoje: zarządzasz nim, jego rozliczeniami oraz kluczami API z panelu. Strona wyświetla klucz API, który posiada agent, abyś mógł go odwołać, jeśli nie chcesz, aby agent lub jego operator miał dostęp.
3. Jeśli nikt nie otworzy linku do przejęcia w ciągu 72 godzin, konto i jego klucz zostaną usunięte. Poproś agenta o utworzenie nowego.

Do momentu przejęcia konto ma te same limity co standardowy darmowy okres próbny.

Jeśli już masz konto

Każde logowanie posiada jedno konto. Jeśli otworzysz link do przejęcia będąc zalogowanym na istniejące konto, strona pozwoli Ci wybrać:

• Dołącz do mojego konta sprawia, że nowe konto staje się zarządzanym najemcą tego, na które jesteś zalogowany. Wymaga to płatnego planu z białą etykietą, a zużycie nowego najemcy jest rozliczane na Twoim koncie.
• Wyloguj się i przejmij przy użyciu innego logowania wylogowuje Cię i przenosi z powrotem na stronę przejęcia, abyś mógł przejąć je przy użyciu innego konta.

Dla autorów agentów

Instrukcje dla agentów dostępne pod adresem fastcomments.com/agents.md opisują wywołanie tworzenia konta, pola w odpowiedzi oraz sposób przekazania linku do przejęcia osobie, dla której pracujesz. Wywołanie nie wymaga klucza API i jest limitowane pod względem liczby żądań na adres IP.