Kit LLM

FastComments exécute un serveur Model Context Protocol (MCP) hébergé afin que les assistants IA et les clients agentiques puissent appeler directement l'API FastComments. Chaque outil exposé par le serveur MCP est généré automatiquement à partir de la spécification OpenAPI publique, de sorte que tout ce que l'API REST peut faire, un client MCP peut le faire.

L'endpoint est sans état et basé sur HTTP streamable. Il n'y a aucune session à maintenir et aucun état côté serveur par client.

Endpoint

Point de terminaison MCP

Copy

1

2https://fastcomments.com/mcp

3

Connect with OAuth

Tout client MCP qui prend en charge les serveurs distants avec OAuth (Claude, ChatGPT, Claude Code, Cursor et d'autres) peut se connecter à l'endpoint ci‑dessus sans configuration côté FastComments. Le client s'enregistre via l'enregistrement dynamique de client ou s'identifie avec un document de métadonnées d'ID client, ouvre un navigateur afin que vous puissiez vous connecter à FastComments et approuver l'accès, et reçoit un jeton lié au compte avec lequel vous étiez connecté.

Les documents de découverte se trouvent aux emplacements standard :

Découverte

Copy

1

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

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

4

Votre utilisateur doit disposer de l'autorisation API Admin sur le compte pour approuver une connexion. Si vous gérez plusieurs comptes, basculez vers le bon dans le tableau de bord avant d'approuver.

Un client peut demander le scope read, le scope write, ou les deux. Un client qui ne demande rien obtient les deux. Les outils qui modifient les données ne sont pas proposés à un jeton en lecture seule.

Le tableau de bord possède un assistant de configuration avec des extraits prêts à coller. Ouvrez Intégrer -> Serveur MCP, ou accédez-y directement :

Page de configuration

Copy

1

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

3

Claude Code

Enregistrez le serveur FastComments avec une seule commande, puis exécutez /mcp dans une session pour vous connecter et lister les outils disponibles :

Configuration Claude Code

Copy

1

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

3

Cursor and other config-file clients

Ajoutez ce bloc à la configuration des serveurs MCP de votre client (mcp.json pour Cursor). Le client ouvre un navigateur pour se connecter lors de la première utilisation.

Configuration client MCP

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Revoking access

Toute connexion approuvée est répertoriée sous Intégrer -> Applications connectées dans le tableau de bord. Révoquer une connexion invalide tous les jetons détenus par cette application. Les applications s'enregistrent lorsqu'elles se connectent et FastComments ne les examine pas, donc révoquez tout ce que vous ne reconnaissez pas.

Using the token with the REST API

Le jeton d'accès qu'un client MCP obtient est une credential API FastComments standard. Il fonctionne sur chaque endpoint /api/v1 en tant que token Bearer, ainsi une application connectée via MCP peut également appeler directement l'API REST :

Token Bearer

Copy

1

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

3

Le locataire est implicite dans le token. Un tenantId peut encore être fourni mais il doit correspondre. Les requêtes GET nécessitent le scope read et toutes les autres nécessitent le scope write.

Connect with an API key

Les clients qui ne peuvent pas effectuer une connexion via navigateur, comme les serveurs sans tête, peuvent s'authentifier avec une clé API à la place. Transmettez tenantId et API_KEY en tant que paramètres de requête, ou comme en‑têtes HTTP x-tenant-id et x-api-key si votre client prend en charge les en‑têtes personnalisés :

Endpoint clé API

Copy

1

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

3

La page de configuration génère cette URL pour chacune de vos clés API.

Security

Une URL d'endpoint contenant une clé API est un secret : ne la collez pas dans des discussions publiques, captures d'écran ou commits. Si une clé est exposée, renouvelez‑la sur la page Clés API de votre tableau de bord. Les jetons OAuth ne présentent pas ce risque car ils sont liés à une seule application et peuvent être révoqués depuis Applications connectées.

Un agent de codage tel que Claude Code, Cursor ou un assistant basé sur MCP peut configurer FastComments pour vous sans que vous ayez à remplir le formulaire d'inscription. Cela est utile lorsque vous demandez à un agent d'« ajouter des commentaires à mon site » et que vous n'avez pas encore de compte.

Comment ça fonctionne

1. L'agent crée un nouveau compte et reçoit une clé API ainsi qu'un lien de réclamation. La clé API fonctionne immédiatement, ce qui permet à l'agent de configurer le compte et d'installer le widget sur votre site.
2. L'agent vous donne le lien de réclamation. Ouvrez-le dans votre navigateur, connectez‑vous ou créez un compte, puis confirmez la réclamation. Le compte devient alors le vôtre : vous le gérez, ainsi que sa facturation et ses clés API depuis le tableau de bord. La page répertorie la clé API détenue par l'agent afin que vous puissiez la révoquer si vous ne souhaitez plus que l'agent, ou quiconque l'utilise, y ait accès.
3. Si personne n'ouvre le lien de réclamation dans les 72 heures, le compte et sa clé sont supprimés. Demandez à l'agent d'en créer un nouveau.

Jusqu'à ce qu'il soit réclamé, le compte bénéficie des mêmes limites qu'un essai gratuit standard.

Si vous avez déjà un compte

Chaque identifiant possède un compte. Si vous ouvrez un lien de réclamation alors que vous êtes connecté à un compte existant, la page vous propose de choisir :

• Attacher à mon compte rend le nouveau compte un locataire géré de celui auquel vous êtes connecté. Cela nécessite un plan payant avec marque blanche, et l'utilisation du nouveau locataire est facturée à votre compte.
• Se déconnecter et réclamer avec un autre identifiant vous déconnecte et vous ramène à la page de réclamation afin que vous puissiez la réclamer avec un identifiant différent.

Pour les auteurs d'agents

Les instructions pour les agents disponibles sur fastcomments.com/agents.md décrivent l'appel de création de compte, les champs de la réponse, et la manière de transmettre le lien de réclamation à la personne pour laquelle vous travaillez. L'appel ne nécessite aucune clé API et est limité en fréquence par adresse IP.