LLM Kit

FastComments betreibt einen gehosteten Model Context Protocol (MCP)-Server, sodass KI‑Assistenten und agentische Clients die FastComments‑API direkt aufrufen können. Jedes Tool, das der MCP‑Server bereitstellt, wird automatisch aus dem öffentlichen OpenAPI‑Spec generiert, sodass alles, was die REST‑API kann, auch ein MCP‑Client ausführen kann.

Der Endpunkt ist zustandslos und streamable‑HTTP‑basiert. Es gibt keine Sitzung, die aufrechterhalten werden muss, und keinen serverseitigen Zustand pro Client.

Endpunkt

MCP-Endpunkt

Copy

1

2https://fastcomments.com/mcp

3

Verbindung mit OAuth

Jeder MCP‑Client, der Remote‑Server mit OAuth unterstützt (Claude, ChatGPT, Claude Code, Cursor und andere), kann sich ohne Einrichtung auf der FastComments‑Seite mit dem oben genannten Endpunkt verbinden. Der Client registriert sich über die dynamische Client‑Registrierung oder identifiziert sich mit einem Client‑ID‑Metadaten‑Dokument, öffnet einen Browser, sodass Sie sich bei FastComments anmelden und den Zugriff genehmigen können, und erhält ein Token, das an das Konto gebunden ist, bei dem Sie angemeldet waren.

Die Entdeckungsdokumente befinden sich an den Standardorten:

Entdeckung

Copy

1

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

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

4

Ihr Benutzer benötigt die API‑Admin‑Berechtigung für das Konto, um eine Verbindung zu genehmigen. Wenn Sie mehrere Konten verwalten, wechseln Sie im Dashboard zum richtigen Konto, bevor Sie genehmigen.

Ein Client kann den read‑Scope, den write‑Scope oder beide anfordern. Ein Client, der nichts anfordert, erhält beide. Werkzeuge, die Daten ändern, werden einem reinen Lese‑Token nicht angeboten.

Das Dashboard enthält einen Einrichtungs‑Assistenten mit sofort einfügbaren Snippets. Öffnen Sie Integrate → MCP Server oder rufen Sie die Seite direkt auf:

Setup-Seite

Copy

1

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

3

Claude Code

Registrieren Sie den FastComments‑Server mit einem Befehl und führen Sie anschließend /mcp innerhalb einer Sitzung aus, um sich anzumelden und die verfügbaren Werkzeuge aufzulisten:

Claude-Code-Einrichtung

Copy

1

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

3

Cursor und andere Konfigurationsdatei‑Clients

Fügen Sie diesen Block zur MCP‑Server‑Konfiguration Ihres Clients hinzu (mcp.json für Cursor). Der Client öffnet beim ersten Gebrauch einen Browser, um sich anzumelden.

MCP-Client-Konfiguration

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Zugriff widerrufen

Jede genehmigte Verbindung wird im Dashboard unter Integrate → Connected Apps angezeigt. Das Widerrufen einer Verbindung macht jedes Token, das diese Anwendung besitzt, ungültig. Anwendungen registrieren sich selbst, wenn sie sich verbinden, und FastComments prüft sie nicht, daher sollten Sie alles widerrufen, was Sie nicht erkennen.

Verwendung des Tokens mit der REST‑API

Das Zugriffstoken, das ein MCP‑Client erhält, ist ein reguläres FastComments‑API‑Credential. Es funktioniert auf jedem /api/v1‑Endpunkt als Bearer‑Token, sodass eine Anwendung, die über MCP verbunden ist, die REST‑API ebenfalls direkt aufrufen kann:

Bearer-Token

Copy

1

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

3

Der Mandant wird durch das Token impliziert. Ein tenantId kann weiterhin übergeben werden, muss jedoch übereinstimmen. GET‑Anfragen benötigen den read‑Scope und alle anderen benötigen den write‑Scope.

Verbindung mit einem API‑Schlüssel

Clients, die keinen Browser‑Login durchführen können, wie z. B. headless‑Server, können sich stattdessen mit einem API‑Schlüssel authentifizieren. Übergeben Sie tenantId und API_KEY als Abfrageparameter oder als die HTTP‑Header x-tenant-id und x-api-key, falls Ihr Client benutzerdefinierte Header unterstützt:

API-Schlüssel-Endpunkt

Copy

1

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

3

Die Einrichtungsseite erzeugt diese URL für jeden Ihrer API‑Schlüssel.

Sicherheit

Eine Endpunkt‑URL, die einen API‑Schlüssel enthält, ist ein Geheimnis: Fügen Sie sie nicht in öffentlichen Chats, Screenshots oder Commits ein. Wenn ein Schlüssel offengelegt wird, rotieren Sie ihn auf der Seite API‑Keys in Ihrem Dashboard. OAuth‑Tokens bergen dieses Risiko nicht, da sie an eine Anwendung gebunden sind und über Connected Apps widerrufen werden können.

Ein Coding‑Agent wie Claude Code, Cursor oder ein MCP‑basierter Assistent kann FastComments für Sie einrichten, ohne dass Sie das Anmeldeformular ausfüllen müssen. Das ist nützlich, wenn Sie einen Agenten bitten, „Kommentare zu meiner Seite hinzufügen“ und Sie noch kein Konto haben.

So funktioniert es

1. Der Agent erstellt ein neues Konto und erhält einen API‑Schlüssel sowie einen Anspruch‑Link. Der API‑Schlüssel funktioniert sofort, sodass der Agent das Konto konfigurieren und das Widget auf Ihrer Seite installieren kann.
2. Der Agent gibt Ihnen den Anspruch‑Link. Öffnen Sie ihn in Ihrem Browser, melden Sie sich an oder erstellen Sie ein Login und bestätigen Sie den Anspruch. Das Konto gehört dann Ihnen: Sie verwalten es, die Abrechnung und die API‑Schlüssel über das Dashboard. Die Seite listet den API‑Schlüssel auf, den der Agent hält, sodass Sie ihn widerrufen können, wenn Sie dem Agenten oder dem Betreiber keinen Zugriff mehr gewähren möchten.
3. Wenn niemand den Anspruch‑Link innerhalb von 72 Stunden öffnet, werden das Konto und sein Schlüssel gelöscht. Bitten Sie den Agenten, ein neues zu erstellen.

Bis es beansprucht wird, hat das Konto die gleichen Limits wie ein normaler kostenloser Test.

Wenn Sie bereits ein Konto haben

Jeder Login besitzt ein Konto. Wenn Sie einen Anspruch‑Link öffnen, während Sie bei einem bestehenden Konto angemeldet sind, lässt Sie die Seite wählen:

• Attach to my account macht das neue Konto zu einem verwalteten Mandanten des Kontos, bei dem Sie angemeldet sind. Dies erfordert einen kostenpflichtigen Plan mit White‑Labeling, und die Nutzung des neuen Mandanten wird Ihrem Konto in Rechnung gestellt.
• Sign out and claim with another login meldet Sie ab und führt Sie zurück zur Anspruch‑Seite, damit Sie sie mit einem anderen Login beanspruchen können.

Für Agenten‑Autoren

Die Agenten‑Anweisungen unter fastcomments.com/agents.md beschreiben den Aufruf zur Kontoerstellung, die Felder in der Antwort und wie man den Anspruch‑Link an die Person übergibt, für die Sie arbeiten. Der Aufruf benötigt keinen API‑Schlüssel und ist pro IP‑Adresse rate‑limitiert.