LLM Κιτ

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

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

Endpoint

Τελικό Σημείο MCP

Copy

1

2https://fastcomments.com/mcp

3

Connect with OAuth

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

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

Ανακάλυψη

Copy

1

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

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

4

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

Ένας πελάτης μπορεί να ζητήσει το πεδίο read, το πεδίο 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 and other config-file clients

Προσθέστε αυτό το μπλοκ στη διαμόρφωση 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

Revoking access

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

Using the token with the REST API

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

Token Φορέα

Copy

1

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

3

Το tenant προκύπτει από το token. Ένα tenantId μπορεί ακόμη να περαστεί αλλά πρέπει να ταιριάζει. Τα αιτήματα GET χρειάζονται το πεδίο read και όλα τα άλλα χρειάζονται το πεδίο write.

Connect with an API key

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

Τελικό Σημείο API Key

Copy

1

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

3

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

Security

Ένα URL endpoint που περιέχει API key είναι μυστικό: μην το επικολλάτε σε δημόσιες συνομιλίες, στιγμιότυπα οθόνης ή 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 διεύθυνση.