Context7 MCP — ο βοηθός διαβάζει την τεκμηρίωση, δεν τη θυμάται

Τι κάνει

Ζητάς κώδικα για μια βιβλιοθήκη. Ο βοηθός απαντά με σιγουριά. Μόνο που η συνάρτηση που σου δίνει δεν υπάρχει πια, ή οι παράμετροι άλλαξαν πριν από δύο εκδόσεις. Αυτό λέγεται παραίσθηση: ο βοηθός βγάζει κάτι που ακούγεται σωστό. Δεν το κάνει από κακία. Απαντά από ό,τι είχε μάθει όταν τον εκπαίδευαν, και αυτό είναι παλιό.

Το Context7 είναι MCP server. MCP σημαίνει πρωτόκολλο πλαισίου μοντέλου· πρακτικά, ένας τυπικός τρόπος να συνδέεις εξωτερικά εργαλεία με τον βοηθό, ώστε να τα καλεί μόνος του. Το Context7 του δίνει ένα πράγμα: ενημερωμένη τεκμηρίωση βιβλιοθηκών, δεμένη με συγκεκριμένη έκδοση (τεκμηρίωση).

Η χρήση είναι απλή στην ιδέα της. Γράφεις το αίτημά σου κανονικά, και στο τέλος προσθέτεις τη φράση use context7. Ο βοηθός βρίσκει τη βιβλιοθήκη, τραβά τα σωστά κομμάτια, και απαντά με κώδικα που ταιριάζει στη σημερινή έκδοση.

Δύο εργαλεία μόνο εκθέτει: resolve-library-id, που βρίσκει το αναγνωριστικό της βιβλιοθήκης, και query-docs, που φέρνει την τεκμηρίωση. Δουλεύει και χωρίς κλειδί API. Με κλειδί απλώς σηκώνεις τα όρια χρήσης.

Για ποιον είναι

Για όποιον γράφει κώδικα που στηρίζεται σε άλλες βιβλιοθήκες. Δηλαδή για σχεδόν όλους.

Λάμπει όταν δουλεύεις με κάτι που αλλάζει γρήγορα: frameworks, SDK, εργαλεία αυτοματισμού.

Δεν έχει νόημα όταν γράφεις δικό σου κώδικα χωρίς εξωτερικές εξαρτήσεις. Εκεί δεν υπάρχει τεκμηρίωση να φέρει.

Εγκατάσταση

Ο ευκολότερος δρόμος είναι ένα εργαλείο που λέγεται ctx7. Το τρέχει το npx, το βοηθητικό πρόγραμμα που έρχεται μαζί με το Node.js, χωρίς να εγκαταστήσεις κάτι μόνιμα.

Το ctx7 κάνει τη σύνδεση με τη Context7, σου δίνει κλειδί, και γράφει τη ρύθμιση στον σωστό φάκελο του βοηθού σου. Ορίστε, με παράδειγμα το Claude Code:

npx ctx7 setup --claude

Η σημαία αλλάζει ανάλογα με τον βοηθό. Η σύνδεση γίνεται με σύντομο κωδικό που ανοίγεις από οποιαδήποτε συσκευή, οπότε δουλεύει και σε απομακρυσμένο μηχάνημα.

Αν θέλεις να το στήσεις με τα χέρια σου, κάθε βοηθός έχει τη δική του ενότητα παρακάτω.

Χρειάζεται Node.js στο μηχάνημα, γιατί όλα περνούν από το npx.

Χρήση σε κάθε LLM

Εδώ είναι το κομμάτι που λείπει από τα περισσότερα άρθρα. Υπάρχουν δύο δρόμοι: ο αυτόματος, που τα ρυθμίζει όλα με μία εντολή, και ο χειροκίνητος, όπου γράφεις εσύ τη ρύθμιση. Ξεκινώ από τον αυτόματο, και μετά δίνω τον χειροκίνητο για κάθε βοηθό.

Claude Code

Αυτόματη ρύθμιση:

npx ctx7 setup --claude

Μετά την εγκατάσταση, ένα skill αναλαμβάνει να καλέσει τη Context7 όταν ρωτάς για βιβλιοθήκη, χωρίς να πεις τίποτα.

Αν προτιμάς χειροκίνητα, με τον απομακρυσμένο server:

claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp

Ή με τοπικό server, που κατεβάζει το πακέτο στο μηχάνημά σου:

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Υπάρχει και plugin, που συνδέεται στον απομακρυσμένο server χωρίς κλειδί. Το στηρίζεις από μέσα στο Claude Code:

/plugin marketplace add upstash/context7

/plugin install context7@context7-marketplace

Μετά κάνε επανεκκίνηση και διάλεξε Context7 στο /mcp.

Codex CLI

Ίδια λογική, άλλο κλειδί:

npx ctx7 setup --codex

Αυτό γράφει τη ρύθμιση στο αρχείο ~/.codex/config.toml και στο AGENTS.md. Να το ξέρεις: το Codex CLI, το Codex Desktop και η επέκταση για editor διαβάζουν όλα το ίδιο αρχείο, οπότε με μία ρύθμιση τα καλύπτεις και τα τρία.

Χειροκίνητα, από το τερματικό:

codex mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Αν θέλεις να μη γράψεις καθόλου κλειδί, άνοιξε το ~/.codex/config.toml και δήλωσε τον απομακρυσμένο server με διεύθυνση https://mcp.context7.com/mcp. Βάλε και ένα όριο αναμονής γύρω στα 20000 χιλιοστά του δευτερολέπτου, γιατί ο server αργεί λίγο στην πρώτη εκκίνηση.

Υπάρχει και plugin για Codex:

codex plugin marketplace add upstash/context7

codex plugin add context7@context7-marketplace

Μετά άνοιξε νέα συνομιλία, ώστε το Codex να φορτώσει το skill και τα εργαλεία.

Cursor

Το Cursor έχει τον πιο καθαρό δρόμο από τους τρεις:

npx ctx7 setup --cursor

Αυτό εγκαθιστά skill που καλεί τη Context7 μόνο του. Αν προτιμάς κανόνα, άνοιξε το Cursor, πήγαινε στις ρυθμίσεις, στο Rules and Commands, και γράψε μια γραμμή που λέει να χρησιμοποιεί Context7 κάθε φορά που ρωτάς για τεκμηρίωση βιβλιοθήκης. Μπορείς να το βάλεις και σε αρχείο .cursorrules στη ρίζα του project, ώστε να πάει μαζί με τον κώδικα.

Χειροκίνητα, η ρύθμιση κάθεται στο ~/.cursor/mcp.json για όλα τα project, ή στο .cursor/mcp.json για ένα project μόνο. Εκεί δηλώνεις τον server με διεύθυνση https://mcp.context7.com/mcp και το κλειδί σου σε κεφαλίδα με όνομα CONTEXT7_API_KEY. Πρόσεξε το όνομα της κεφαλίδας· είναι το σημείο όπου χάνονται οι μισοί.

Πού κερδίζει, πού χάνει

Κερδίζει στο πρόβλημα που λύνει. Ο κώδικας από παλιά δεδομένα είναι από τα πιο ακριβά λάθη, γιατί κοστίζει χρόνο μέχρι να καταλάβεις γιατί δεν τρέχει.

Κερδίζει στην απλότητα. Δύο εργαλεία μόνο, χωρίς κλειδί, και μία φράση στο αίτημά σου.

Κερδίζει και στην ωριμότητα. Το αποθετήριο έχει 62.851 αστέρια, 3.060 forks και άδεια MIT, με δημιουργία τον Μάρτιο του 2025 (αποθετήριο).

Χάνει στην εξάρτηση. Είναι υπηρεσία, όχι αρχείο στον δίσκο σου. Θέλει δίκτυο, και το περιεχόμενο το συντηρεί η κοινότητα, όχι οι ίδιοι οι δημιουργοί των βιβλιοθηκών. Δεν είναι όλες οι καταχωρήσεις ίδιες.

Χάνει λίγο και στη ρύθμιση. Τρεις βοηθοί, τρεις δρόμοι, και σε κάθε δρόμο διαφορετικό όνομα κεφαλίδας ή αρχείου. Είναι εύκολο να βάλεις το κλειδί στο λάθος σημείο και να μη δουλέψει τίποτα, χωρίς καθαρό μήνυμα λάθους.

Δοκιμή

Δεν το στήσαμε από την αρχή σε Claude Code, Codex ή Cursor για τούτο το άρθρο. Το λέω πρώτο, γιατί αυτό είναι το τίμιο.

Το έχουμε όμως στημένο στη δική μας γραμμή, και εκεί έτρεξε αληθινή κλήση. Το εργαλείο resolve-library-id γύρισε πραγματικά αποτελέσματα. Για τη Serena, ένα εργαλείο ανάλυσης κώδικα, επέστρεψε το αναγνωριστικό /oraios/serena, με 714 δείγματα κώδικα, φήμη High και βαθμολογία 79,86. Δηλαδή η αλυσίδα ως το σημείο της αναγνώρισης βιβλιοθήκης δουλεύει, και δουλεύει χωρίς κλειδί API.

Τι δεν τρέξαμε, και το λέω καθαρά. Δεν τρέξαμε το δεύτερο εργαλείο, το query-docs. Δεν συνδέσαμε τη Context7 σε κάποιον από τους τρεις βοηθούς για χάρη αυτού του άρθρου. Ό,τι γράφω για τα βήματα ανά client είναι από την τεκμηρίωση, όχι δοκιμασμένο στα χέρια μας.

Ετυμηγορία

Το Context7 χτυπά ένα από τα πιο ενοχλητικά προβλήματα στη δουλειά με βοηθούς: τις παραισθήσεις σε κώδικα βιβλιοθηκών. Το κάνει με ένα εργαλείο που στήνεται σε λίγα λεπτά και δουλεύει χωρίς κλειδί.

Είναι και ώριμο. Τόσα αστέρια δεν μαζεύονται με ένα κόλπο, και το πακέτο στο npm τρέχει στην έκδοση 4.3.0, δείχνοντας στο ίδιο αποθετήριο (πακέτο).

Το αδύναμό του σημείο είναι η ίδια η φύση του: είναι υπηρεσία. Αν πέσει το δίκτυο ή η υπηρεσία, ο βοηθός γυρίζει στη μνήμη του. Και η ποιότητα κάθε καταχώρησης εξαρτάται από την κοινότητα.

Αν γράφεις κώδικα πάνω σε βιβλιοθήκες, θα το νιώσεις από την πρώτη μέρα. Δοκίμασέ το.

Βαθμολογία: 8.4/10.

Πηγές: https://github.com/upstash/context7 · https://context7.com/docs · https://context7.com/docs/clients/claude-code · https://context7.com/docs/clients/codex · https://context7.com/docs/clients/cursor · https://www.npmjs.com/package/@upstash/context7-mcp · https://github.com/upstash/context7/releases