Zestaw LLM

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

Endpoint jest bezstanowy i oparty na strumieniowym HTTP. Nie ma sesji do utrzymania oraz nie istnieje stan po stronie serwera dla poszczególnych klientów.

Endpoint

Punkt końcowy MCP

Copy

1

2https://fastcomments.com/mcp

3

Connect with OAuth

Każdy klient MCP, który obsługuje zdalne serwery z OAuth (Claude, ChatGPT, Claude Code, Cursor i inne), może połączyć się z powyższym endpointem bez dodatkowej konfiguracji po stronie FastComments. Klient rejestruje się poprzez Dynamic Client Registration lub identyfikuje się za pomocą dokumentu metadanych Client ID, 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 jesteś zalogowany.

Dokumenty odkrywania znajdują się w standardowych lokalizacjach:

Odkrywanie

Copy

1

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

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

4

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

Klient może żądać zakresu read, zakresu write lub obu. Klient, który nie żąda żadnego zakresu, otrzymuje oba. Narzędzia zmieniające dane nie są oferowane tokenowi tylko do odczytu.

Panel ma kreatora konfiguracji z gotowymi do wklejenia fragmentami kodu. Otwórz Integrate -> MCP Server lub przejdź bezpośrednio:

Strona konfiguracji

Copy

1

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

3

Claude Code

Zarejestruj serwer FastComments jednym poleceniem, a następnie uruchom /mcp w sesji, aby zalogować się i wyświetlić dostępne narzędzia:

Konfiguracja Claude Code

Copy

1

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

3

Cursor and other config-file clients

Dodaj ten blok do konfiguracji serwerów MCP swojego klienta (mcp.json dla Cursor). Klient otworzy przeglądarkę, aby zalogować się 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

Revoking access

Każde zatwierdzone połączenie jest wymienione w Integrate -> Connected Apps w panelu. Cofnięcie jednego połączenia unieważnia każdy token, który dana aplikacja posiada. Aplikacje rejestrują się samodzielnie przy połączeniu, a FastComments ich nie weryfikuje, więc odwołaj wszystko, czego nie rozpoznajesz.

Using the token with the REST API

Token dostępu uzyskany przez klienta MCP jest zwykłym poświadczeniem API FastComments. Działa on na każdym endpointzie /api/v1 jako token typu bearer, więc aplikacja połączona 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 jest domyślnie określany na podstawie tokenu. tenantId może nadal być przekazywany, ale musi się zgadzać. Żądania GET wymagają zakresu read, a wszystkie pozostałe wymagają zakresu write.

Connect with an API key

Klienci, którzy nie mogą przeprowadzić logowania w przeglądarce, np. serwery bez interfejsu graficznego, mogą uwierzytelnić się przy użyciu 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 klucza 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.

Security

URL endpointu zawierający klucz API jest tajny: nie wklejaj go w publicznych czatach, zrzutach ekranu ani w commitach. Jeśli klucz zostanie ujawniony, zresetuj go na stronie API Keys w panelu. Tokeny OAuth nie niosą takiego ryzyka, ponieważ są powiązane z jedną aplikacją i mogą być odwołane w sekcji 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.