Kit LLM

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

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

Endpoint

Endpoint MCP

Copy

1

2https://fastcomments.com/mcp

3

Connexion avec OAuth

Tout client MCP prenant en charge les serveurs distants avec OAuth (Claude, ChatGPT, Claude Code, Cursor, et autres) peut se connecter au endpoint ci-dessus sans aucune configuration côté FastComments. Le client s'enregistre via Dynamic Client Registration ou s'identifie avec un Client ID Metadata Document, ouvre un navigateur pour que vous puissiez vous connecter à FastComments et approuver l'accès, puis reçoit un token lié au compte auquel vous étiez connecté.

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

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 la permission API Admin sur le compte pour approuver une connexion. Si vous gérez plusieurs comptes, basculez vers le bon compte dans le dashboard 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 des données ne sont pas proposés à un token en lecture seule.

Le dashboard dispose d'un assistant de configuration avec des snippets prêts à copier. Ouvrez Integrate -> MCP Server, ou visitez 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 de Claude Code

Copy

1

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

3

Cursor et autres clients à fichier de configuration

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 du client MCP

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Révocation de l'accès

Chaque connexion approuvée est listée sous Integrate -> Connected Apps dans le dashboard. Révoquer une connexion invalide tous les tokens détenus par cette application. Les applications s'enregistrent elles-mêmes lorsqu'elles se connectent et FastComments ne les examine pas, donc révoquez tout ce que vous ne reconnaissez pas.

Utilisation du token avec l'API REST

Le token d'accès qu'un client MCP obtient est un identifiant FastComments API ordinaire. Il fonctionne sur chaque endpoint /api/v1 en tant que bearer token, donc une application connectée via MCP peut aussi appeler l'API REST directement :

Bearer Token

Copy

1

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

3

Le tenant est déduit du token. Un tenantId peut toujours être passé mais il doit correspondre. Les requêtes GET nécessitent le scope read et tout le reste nécessite le scope write.

Connexion avec une clé API

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

Endpoint avec 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.

Sécurité

Une URL de endpoint contenant une clé API est un secret : ne la collez pas dans des chats publics, des captures d'écran ou des commits. Si une clé est exposée, faites-la pivoter sur la page API Keys de votre dashboard. Les tokens OAuth ne présentent pas ce risque car ils sont liés à une seule application et peuvent être révoqués depuis Connected Apps.

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.