Kit LLM
Kit LLM
Il Kit LLM di FastComments aiuta gli assistenti AI per la programmazione come Claude, ChatGPT e Cursor a comprendere e integrarsi con FastComments fornendo loro accesso alla nostra documentazione completa tramite una semplice API di ricerca.
Aggiungendo uno snippet al file AGENT.md o CLAUDE.md del tuo progetto, abiliti gli assistenti AI a cercare e recuperare rapidamente la documentazione FastComments rilevante, rendendo l'implementazione più veloce e precisa.
Ottieni il Kit LLM 
Aggiungi questo snippet ai file di configurazione dell'assistente AI del tuo progetto (come AGENT.md o CLAUDE.md) che insegna agli assistenti di codifica AI come cercare e accedere alla documentazione di FastComments.
In questo modo il tuo assistente AI può facilmente ottenere informazioni aggiornate e fornire implementazioni più accurate in meno tempo.
Esempio di utilizzo
Quando usi un assistente AI come Claude Code o Cursor, puoi fare domande come:
- "Come installo FastComments su React?"
- "Mostrami come configurare SSO con FastComments"
- "Quali sono le opzioni di autenticazione dell'API FastComments?"
L'assistente AI cercherà automaticamente nella documentazione utilizzando l'endpoint API fornito e ti darà risposte accurate e aggiornate basate sulla documentazione ufficiale.
Server MCP
FastComments esegue un server Model Context Protocol (MCP) ospitato in modo che gli assistenti AI e i client agentici possano chiamare direttamente l'API di FastComments. Ogni strumento che il server MCP espone è generato automaticamente dalla specifica OpenAPI pubblica, quindi tutto ciò che l'API REST può fare, può farlo anche un client MCP.
L'endpoint è senza stato e basato su HTTP streamable. Non c'è alcuna sessione da mantenere attiva e nessuno stato lato server per client.
Endpoint
Connettersi con OAuth
Qualsiasi client MCP che supporta server remoti con OAuth (Claude, ChatGPT, Claude Code, Cursor e altri) può connettersi all'endpoint sopra senza configurazione da parte di FastComments. Il client si registra tramite Dynamic Client Registration o si identifica con un Client ID Metadata Document, apre un browser così puoi accedere a FastComments e approvare l'accesso, e riceve un token associato all'account con cui sei connesso.
I documenti di scoperta si trovano nelle posizioni standard:
Il tuo utente ha bisogno del permesso API Admin sull'account per approvare una connessione. Se gestisci più account, passa a quello corretto nella dashboard prima di approvare.
Un client può richiedere lo scope read, lo scope write, o entrambi. Un client che non richiede nulla ottiene entrambi. Gli strumenti che modificano i dati non sono offerti a un token in sola lettura.
La dashboard ha un assistente di configurazione con snippet pronti da incollare. Apri Integrate -> MCP Server, o visitalo direttamente:
Claude Code
Registra il server FastComments con un solo comando, poi esegui /mcp all'interno di una sessione per accedere e elencare gli strumenti disponibili:
Cursor e altri client basati su file di configurazione
Aggiungi questo blocco alla configurazione dei server MCP del tuo client (mcp.json per Cursor). Il client apre un browser per accedere al primo utilizzo.
Revocare l'accesso
Ogni connessione approvata è elencata sotto Integrate -> Connected Apps nella dashboard. Revocare una connessione invalida tutti i token che quell'applicazione possiede. Le applicazioni si registrano quando si connettono e FastComments non le revisiona, quindi revoca tutto ciò che non riconosci.
Usare il token con l'API REST
Il token di accesso che un client MCP ottiene è una credenziale API FastComments standard. Funziona su ogni endpoint /api/v1 come token bearer, quindi un'applicazione connessa tramite MCP può anche chiamare direttamente l'API REST:
Il tenant è implicito nel token. Un tenantId può ancora essere passato ma deve corrispondere. Le richieste GET richiedono lo scope read e tutto il resto richiede lo scope write.
Connettersi con una chiave API
I client che non possono completare l'accesso tramite browser, come i server headless, possono autenticarsi invece con una chiave API. Passa tenantId e API_KEY come parametri di query, o come intestazioni HTTP x-tenant-id e x-api-key se il tuo client supporta intestazioni personalizzate:
La pagina di configurazione genera questo URL per ciascuna delle tue chiavi API.
Sicurezza
Un URL endpoint che contiene una chiave API è un segreto: non incollarlo in chat pubbliche, screenshot o commit. Se una chiave viene esposta, ruotala nella pagina Chiavi API della tua dashboard. I token OAuth non comportano tale rischio perché sono legati a un'applicazione e possono essere revocati da Connected Apps.
Consenti a un agente di configurare il tuo account
Un agente di programmazione come Claude Code, Cursor o un assistente basato su MCP può configurare FastComments per te senza che tu debba compilare il modulo di registrazione. Questo è utile quando chiedi a un agente di "aggiungere commenti al mio sito" e non hai ancora un account.
Come funziona
- L'agente crea un nuovo account e riceve una chiave API e un link di rivendicazione. La chiave API funziona immediatamente, così l'agente può configurare l'account e installare il widget sul tuo sito.
- L'agente ti fornisce il link di rivendicazione. Aprilo nel tuo browser, accedi o crea un accesso, e conferma la rivendicazione. L'account è quindi tuo: lo gestisci, la sua fatturazione e le sue chiavi API dal cruscotto. La pagina elenca la chiave API che l'agente possiede così puoi revocarla se non desideri più che l'agente, o chiunque lo utilizzi, abbia accesso.
- Se nessuno apre il link di rivendicazione entro 72 ore, l'account e la sua chiave vengono eliminati. Chiedi all'agente di crearne uno nuovo.
Fino a quando non viene rivendicato, l'account ha gli stessi limiti di una normale prova gratuita.
Se hai già un account
Ogni accesso possiede un account. Se apri un link di rivendicazione mentre sei connesso a un account esistente, la pagina ti permette di scegliere:
- Allega al mio account rende il nuovo account un tenant gestito di quello a cui sei connesso. Questo richiede un piano a pagamento con white labeling, e l'utilizzo del nuovo tenant viene fatturato al tuo account.
- Disconnetti e rivendica con un altro accesso ti disconnette e ti riporta alla pagina di rivendicazione così puoi rivendicarlo con un accesso diverso.
Per gli autori di agenti
Le istruzioni per gli agenti su fastcomments.com/agents.md descrivono la chiamata di creazione dell'account, i campi nella risposta e come consegnare il link di rivendicazione alla persona per cui stai lavorando. La chiamata non richiede una chiave API ed è limitata per indirizzo IP.