LLM Κιτ

Το FastComments λειτουργεί έναν φιλοξενούμενο διακομιστή Model Context Protocol (MCP), ώστε οι AI βοηθοί και οι agentic πελάτες να μπορούν να καλούν απευθείας το FastComments API. Κάθε εργαλείο που εκθέτει ο διακομιστής MCP δημιουργείται αυτόματα από τη δημόσια προδιαγραφή OpenAPI, οπότε ό,τι μπορεί να κάνει το REST API, μπορεί να το κάνει και ένας πελάτης MCP.

Το endpoint είναι stateless και βασίζεται σε streamable-HTTP. Δεν υπάρχει συνεδρία που να χρειάζεται διατήρηση ούτε server-side κατάσταση ανά πελάτη.

Endpoint

Endpoint MCP

Copy

1

2https://fastcomments.com/mcp

3

Σύνδεση με OAuth

Οποιοσδήποτε πελάτης MCP που υποστηρίζει απομακρυσμένους διακομιστές με OAuth (Claude, ChatGPT, Claude Code, Cursor και άλλοι) μπορεί να συνδεθεί στο παραπάνω endpoint χωρίς καμία ρύθμιση από την πλευρά του FastComments. Ο πελάτης εγγράφεται μέσω Dynamic Client Registration ή ταυτοποιείται με ένα Client ID Metadata Document, ανοίγει ένα πρόγραμμα περιήγησης ώστε να συνδεθείτε στο FastComments και να εγκρίνετε την πρόσβαση, και λαμβάνει ένα token δεσμευμένο στον λογαριασμό στον οποίο ήσασταν συνδεδεμένοι.

Τα έγγραφα discovery βρίσκονται στις τυπικές τοποθεσίες:

Discovery

Copy

1

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

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

4

Ο χρήστης σας χρειάζεται την άδεια API Admin στον λογαριασμό για να εγκρίνει μια σύνδεση. Αν διαχειρίζεστε πολλούς λογαριασμούς, μεταβείτε στον σωστό στο dashboard πριν εγκρίνετε.

Ένας πελάτης μπορεί να ζητήσει το scope read, το scope write ή και τα δύο. Ένας πελάτης που δεν ζητά τίποτα λαμβάνει και τα δύο. Εργαλεία που τροποποιούν δεδομένα δεν προσφέρονται σε token μόνο ανάγνωσης.

Το dashboard διαθέτει έναν βοηθό ρύθμισης με έτοιμα αποσπάσματα κώδικα για επικόλληση. Ανοίξτε Integrate -> MCP Server, ή επισκεφθείτε το απευθείας:

Σελίδα Ρύθμισης

Copy

1

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

3

Claude Code

Καταχωρήστε τον διακομιστή FastComments με μία εντολή και, στη συνέχεια, εκτελέστε /mcp μέσα σε μια συνεδρία για να συνδεθείτε και να δείτε τα διαθέσιμα εργαλεία:

Ρύθμιση Claude Code

Copy

1

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

3

Cursor και άλλοι πελάτες με αρχείο ρυθμίσεων

Προσθέστε αυτό το μπλοκ στη ρύθμιση MCP servers του πελάτη σας (mcp.json για το Cursor). Ο πελάτης ανοίγει ένα πρόγραμμα περιήγησης για σύνδεση κατά την πρώτη χρήση.

Ρύθμιση Πελάτη MCP

Copy

1

2{

3 "mcpServers": {

4 "fastcomments": {

5 "type": "http",

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

7 }

8 }

9}

10

Ανάκληση πρόσβασης

Κάθε εγκεκριμένη σύνδεση εμφανίζεται κάτω από Integrate -> Connected Apps στο dashboard. Η ανάκληση μιας σύνδεσης ακυρώνει κάθε token που κατέχει η εφαρμογή. Οι εφαρμογές εγγράφονται μόνες τους όταν συνδέονται και το FastComments δεν τις ελέγχει, οπότε ανακαλέστε ό,τι δεν αναγνωρίζετε.

Χρήση του token με το REST API

Το access token που αποκτά ένας πελάτης MCP είναι ένα κανονικό διαπιστευτήριο του FastComments API. Λειτουργεί σε κάθε endpoint /api/v1 ως bearer token, οπότε μια εφαρμογή που συνδέθηκε μέσω MCP μπορεί επίσης να καλεί απευθείας το REST API:

Bearer Token

Copy

1

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

3

Ο tenant συνάγεται από το token. Ένα tenantId μπορεί ακόμα να περαστεί, αλλά πρέπει να ταιριάζει. Τα αιτήματα GET χρειάζονται το scope read και όλα τα υπόλοιπα το scope write.

Σύνδεση με κλειδί API

Πελάτες που δεν μπορούν να ολοκληρώσουν σύνδεση μέσω προγράμματος περιήγησης, όπως διακομιστές χωρίς γραφικό περιβάλλον, μπορούν να πιστοποιηθούν με κλειδί API. Περάστε tenantId και API_KEY ως παραμέτρους query, ή ως HTTP headers x-tenant-id και x-api-key αν ο πελάτης σας υποστηρίζει προσαρμοσμένα headers:

Endpoint με Κλειδί API

Copy

1

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

3

Η σελίδα ρύθμισης δημιουργεί αυτό το URL για κάθε ένα από τα κλειδιά API σας.

Ασφάλεια

Ένα URL endpoint που περιέχει κλειδί API είναι μυστικό: μην το επικολλάτε σε δημόσιες συνομιλίες, στιγμιότυπα οθόνης ή commits. Αν ένα κλειδί εκτεθεί, ανανεώστε το στη σελίδα API Keys στο dashboard σας. Τα OAuth tokens δεν ενέχουν τέτοιον κίνδυνο, επειδή είναι δεσμευμένα σε μία εφαρμογή και μπορούν να ανακληθούν από τα Connected Apps.

Ένας κωδικοποιητικός πράκτορας όπως ο Claude Code, ο Cursor ή ένας βοηθός βασισμένος σε MCP μπορεί να ρυθμίσει το FastComments για εσάς χωρίς να συμπληρώσετε τη φόρμα εγγραφής. Αυτό είναι χρήσιμο όταν ζητάτε από έναν πράκτορα να "add comments to my site" και δεν έχετε ακόμη λογαριασμό.

Πώς λειτουργεί

1. Ο πράκτορας δημιουργεί έναν νέο λογαριασμό και λαμβάνει ένα κλειδί API και έναν σύνδεσμο αξίωσης. Το κλειδί API λειτουργεί αμέσως, ώστε ο πράκτορας να μπορεί να ρυθμίσει το λογαριασμό και να εγκαταστήσει το widget στον ιστότοπό σας.
2. Ο πράκτορας σας δίνει τον σύνδεσμο αξίωσης. Ανοίξτε τον στο πρόγραμμα περιήγησής σας, συνδεθείτε ή δημιουργήστε έναν λογαριασμό, και επιβεβαιώστε την αξίωση. Ο λογαριασμός γίνεται δικός σας: τον διαχειρίζεστε, τη χρέωση του και τα κλειδιά API από τον πίνακα ελέγχου. Η σελίδα εμφανίζει το κλειδί API που κατέχει ο πράκτορας ώστε να μπορείτε να το ανακαλέσετε εάν δεν θέλετε πλέον ο πράκτορας, ή όποιος το εκτελεί, να έχει πρόσβαση.
3. Εάν κανείς δεν ανοίξει τον σύνδεσμο αξίωσης εντός 72 ωρών, ο λογαριασμός και το κλειδί του διαγράφονται. Ζητήστε από τον πράκτορα να δημιουργήσει ένα νέο.

Μέχρι να αξιώσει, ο λογαριασμός έχει τα ίδια όρια με μια κανονική δωρεάν δοκιμή.

Εάν έχετε ήδη λογαριασμό

Κάθε σύνδεση (login) κατέχει έναν λογαριασμό. Εάν ανοίξετε έναν σύνδεσμο αξίωσης ενώ είστε συνδεδεμένοι σε έναν υπάρχοντα λογαριασμό, η σελίδα σας επιτρέπει να επιλέξετε:

• Attach to my account κάνει τον νέο λογαριασμό έναν διαχειριζόμενο ενοικιαστή του λογαριασμού στον οποίο είστε συνδεδεμένοι. Αυτό απαιτεί ένα πληρωμένο πρόγραμμα με λευκή σήμανση, και η χρήση του νέου ενοικιαστή χρεώνεται στον λογαριασμό σας.
• Sign out and claim with another login σας αποσυνδέει και σας επιστρέφει στη σελίδα αξίωσης ώστε να το αξιώσετε με διαφορετική σύνδεση.

Για δημιουργούς πρακτόρων

Οι οδηγίες για τους πράκτορες στο fastcomments.com/agents.md περιγράφουν την κλήση δημιουργίας λογαριασμού, τα πεδία στην απάντηση, και πώς να παραδώσετε τον σύνδεσμο αξίωσης στο άτομο για το οποίο εργάζεστε. Η κλήση δεν απαιτεί κλειδί API και περιορίζεται ανά IP διεύθυνση.