MCP server zaDojo: ρύθμιση για Claude, Cursor

Το zaDojo τρέχει έναν απομακρυσμένο MCP server στον οποίο μπορεί να συνδεθεί κάθε client που υποστηρίζει απομακρυσμένο MCP. Το MCP (Model Context Protocol) είναι ο καθιερωμένος τρόπος με τον οποίο οι εφαρμογές AI καλούν εξωτερικά εργαλεία. Μέσα από αυτό, ο agent σου μπορεί να ερευνά λέξεις-κλειδιά, να διαβάζει ζωντανά αποτελέσματα Google, να βλέπει θέσεις και backlinks οποιουδήποτε domain, να τρέχει ελέγχους site, να παρακολουθεί θέσεις και απαντήσεις AI και να διαβάζει τα δικά σου δεδομένα από Search Console και Google Analytics.

Η διεύθυνση του server:

https://app.zadojo.com/mcp

Την πρώτη φορά που συνδέεται ένας client, ανοίγει τη σύνδεση στο zaDojo στον browser σου και σου ζητά να εγκρίνεις την πρόσβαση. Μετά από αυτό, ο client μπορεί να χρησιμοποιεί τα εργαλεία για τα projects που βλέπεις. Για εργασίες CI και servers χωρίς browser, χρησιμοποίησε API key.

Οι χρήστες του Claude Code και του Codex κερδίζουν περισσότερα από το plugin, που προσθέτει αυτή τη σύνδεση και τα δώδεκα skills του zaDojo με μία εγκατάσταση. Ακολούθησε τα βήματα αυτής της σελίδας όταν θέλεις μόνο τη σύνδεση MCP ή όταν ο client σου δεν έχει plugin. Ο οδηγός ρύθμισης agent έχει ένα prompt που διαλέγει τον σωστό δρόμο για σένα.

Τι χρειάζεσαι

• Λογαριασμό zaDojo. Κάνε εγγραφή για να πάρεις 0,10 € δοκιμαστικά credits χωρίς κάρτα.
• Έναν client που υποστηρίζει απομακρυσμένους MCP servers μέσω HTTP: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex στην εφαρμογή ChatGPT για desktop, ChatGPT με custom σύνδεση, VS Code με Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed ή κάτι παρόμοιο.
• Έναν browser για τη σύνδεση ή ένα API key για χρήση χωρίς browser.

Η σελίδα Agent setup μέσα στο app δείχνει την ίδια διεύθυνση με κουμπί αντιγραφής. Θέλεις να δοκιμάσεις δεδομένα του zaDojo πριν κάνεις εγγραφή; Τα δωρεάν εργαλεία SEO δεν χρειάζονται λογαριασμό.

Σύνδεσε τον client σου

Claude Code

Το plugin για Claude Code είναι η καλύτερη επιλογή για τους περισσότερους. Μόνο για τη σύνδεση, τρέξε αυτό σε ένα terminal:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

Το --scope user κάνει το zaDojo διαθέσιμο σε κάθε project του υπολογιστή σου. Χρησιμοποίησε --scope local για να το περιορίσεις στο τρέχον repository. Μετά το Claude Code σου ζητά να συνδεθείς στο zaDojo. Αν δεν εμφανιστεί το αίτημα, τρέξε /mcp, διάλεξε zaDojo και ολοκλήρωσε τη σύνδεση εκεί.

Claude Desktop

Σε συνδρομητικό πλάνο Claude, το plugin του zaDojo προσθέτει μαζί τη σύνδεση και τα skills. Στο πλάνο Free, ή μόνο για τη σύνδεση, πρόσθεσε έναν custom connector:

1. Άνοιξε το Customize > Connectors.
2. Πάτα Add ή + και διάλεξε Add custom connector.
3. Επικόλλησε https://app.zadojo.com/mcp.
4. Συνδέσου στο zaDojo και ενέκρινε την πρόσβαση.

Οι custom connectors δουλεύουν σε Claude Free, Pro, Max, Team και Enterprise. Το πλάνο Free επιτρέπει έναν custom connector.

Cursor

1. Άνοιξε το Customize και πήγαινε στους MCP servers ή επεξεργάσου απευθείας το ~/.cursor/mcp.json.
2. Πρόσθεσε την καταχώρηση του zaDojo:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

3. Αποθήκευσε το αρχείο και ενέκρινε τη σύνδεση στο zaDojo όταν σου τη ζητήσει το Cursor.

Ο οδηγός για Cursor έχει link εγκατάστασης με ένα κλικ και την εγκατάσταση των skills.

Codex CLI

Το Codex plugin προσθέτει μαζί τη σύνδεση και τα skills. Μόνο για τη σύνδεση:

codex mcp add zadojo --url https://app.zadojo.com/mcp

Ενέκρινε τη σύνδεση στο zaDojo όταν ανοίξει. Αν δεν ανοίξει, τρέξε codex mcp login zadojo.

Codex στην εφαρμογή ChatGPT για desktop

Το Codex plugin περιλαμβάνει και τα skills. Μόνο για τη σύνδεση:

1. Άνοιξε το Codex και μετά πήγαινε στο Settings > MCP servers > Add server.
2. Γράψε το όνομα zadojo, διάλεξε Streamable HTTP και επικόλλησε https://app.zadojo.com/mcp.
3. Αποθήκευσε και πάτα Restart όταν σου το ζητήσει το Codex.
4. Πάτα Authenticate δίπλα στο zaDojo και ενέκρινε τη σύνδεση.
5. Άνοιξε νέα συνομιλία Codex και κάνε τον έλεγχο σύνδεσης.

Αυτή η σύνδεση καλύπτει μόνο το Codex. Το ChatGPT στο web χρειάζεται τη δική του. Η αναφορά της OpenAI είναι η τεκμηρίωση MCP του Codex.

ChatGPT

Πρόσθεσε το zaDojo ως custom σύνδεση MCP με OAuth. Δουλεύει στο ChatGPT Free και στα συνδρομητικά πλάνα, αν και οι διαχειριστές ενός workspace μπορούν να μπλοκάρουν τις custom συνδέσεις. Ο οδηγός για ChatGPT περνά από κάθε οθόνη.

VS Code, Windsurf και Gemini CLI

Το καθένα έχει τη δική του σελίδα με την ακριβή ρύθμιση, τη ρύθμιση με API key και την εγκατάσταση των skills:

• VS Code με GitHub Copilot
• Windsurf (Devin Desktop)
• Gemini CLI και Antigravity CLI

Άλλοι MCP clients

Κάθε client που φτάνει σε απομακρυσμένο MCP server μέσω streamable HTTP και υποστηρίζει σύνδεση OAuth μπορεί να χρησιμοποιήσει την παραπάνω διεύθυνση. Αν ο client δεν υποστηρίζει OAuth, στείλε ένα API key σε header όπως περιγράφεται παρακάτω.

Όλοι αυτοί ανοίγουν τη σύνδεση στο zaDojo στον browser σου την πρώτη φορά που συνδέονται.

Σύνδεση με API key

Ένα API key αντικαθιστά τη σύνδεση μέσω browser. Χρησιμοποίησέ το για pipelines CI, απομακρυσμένους servers, agents όπως το Hermes όπου η ροή σύνδεσης δεν δουλεύει, ή οποιονδήποτε client χωρίς υποστήριξη OAuth.

Ένα κλειδί ανήκει προσωπικά σε σένα. Ό,τι κάνει ένας agent με αυτό εκτελείται με τον λογαριασμό σου στο workspace σου, οπότε φύλαξέ το ως μυστικό και μην το κάνεις ποτέ commit σε repository.

Για να δημιουργήσεις ένα, άνοιξε τα Settings στο app του zaDojo, βρες το API keys και πάτα Create API key. Αντίγραψε το κλειδί αμέσως, γιατί το zaDojo το δείχνει μόνο μία φορά. Τα κλειδιά ξεκινούν με zadojo_.

Claude Code:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor: πρόσθεσε ένα block headers στην καταχώρηση του zaDojo στο mcp.json:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI: κράτα το κλειδί σε μεταβλητή περιβάλλοντος και δείξε στο Codex πού είναι:

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

Οποιοσδήποτε άλλος client: στείλε είτε Authorization: Bearer zadojo_YOUR_KEY είτε x-api-key: zadojo_YOUR_KEY σε κάθε αίτημα.

Για να ανακαλέσεις ένα κλειδί, άνοιξε την ίδια ενότητα API keys και αφαίρεσέ το.

Έλεγξε τη σύνδεση

Άνοιξε νέα συνομιλία ή συνεδρία και στείλε:

Χρησιμοποίησε το zaDojo για να ελέγξεις τη σύνδεσή μου και να δείξεις τα projects μου.

Ο agent θα πρέπει να καλέσει τα whoami και list_projects. Παίρνεις πίσω τον λογαριασμό σου, το υπόλοιπο των credits σου και τα projects σου, ή μια κενή λίστα αν δεν έχεις ακόμα. Και τα δύο εργαλεία είναι δωρεάν. Αν ο agent περιγράφει το MCP αντί να καλέσει εργαλείο, ο server δεν έχει φορτωθεί σε αυτή τη συνεδρία: κάνε επαναφόρτωση του client ή ξεκίνα νέα συνομιλία.

Διαθέσιμα εργαλεία

Ο server έχει πάνω από 80 εργαλεία. Ο πίνακας τα ομαδοποιεί ανά δουλειά. Τα ονόματα των εργαλείων είναι αυτά που βλέπει ο agent σου.

Μερικές συμπεριφορές που αξίζει να ξέρεις:

• Το context του project είναι κοινή μνήμη για ένα project: επισκόπηση της επιχείρησης, τρέχων στόχος, positioning, προτιμήσεις γραφής, ανταγωνιστές, βασικές σελίδες και ημερολόγιο έρευνας. Οι agents το διαβάζουν πριν ξεκινήσουν, και το app και οι άλλοι agents βλέπουν τις ίδιες καταχωρήσεις.
• Οι αναφορές που αποθηκεύει ένας agent εμφανίζονται στο project, ώστε όλη η ομάδα σου να τις διαβάζει, να τις εκτυπώνει ή να τις εξάγει. Οι νέες αναφορές είναι ιδιωτικές. Δημόσιο link δημιουργείται μόνο όταν ζητήσεις από τον agent να καλέσει το set_report_sharing με public: true, και το public: false το ανακαλεί. Το get_report επιστρέφει report.shareUrl όταν υπάρχει δημόσιο link ή null όταν δεν υπάρχει.
• Τα εργαλεία Search Console και Google Analytics διαβάζουν το property που είναι ήδη συνδεδεμένο με το project. Η πρόσβαση είναι μόνο για ανάγνωση.
• Πρώτα οι εκτιμήσεις για οτιδήποτε επαναλαμβανόμενο. Το tracking θέσεων και το tracking AI έχουν εργαλεία εκτίμησης, ώστε ο agent να σου δείχνει το κόστος πριν προγραμματίσει ελέγχους.

Τι καταναλώνει credits

Τα credits έρχονται από το υπόλοιπό σου στο zaDojo. 1.000 credits αντιστοιχούν σε 1 € και το πλάνο των 10 € τον μήνα περιλαμβάνει χρήση 10 €. Τυπικές τιμές:

Δωρεάν: έλεγχοι λογαριασμού, context του project, αποθηκευμένες λέξεις-κλειδιά, αναφορές, Search Console, Google Analytics, απλοί έλεγχοι site και ανάγνωση αποτελεσμάτων tracking θέσεων, ελέγχων ή ορατότητας σε AI που έχεις ήδη συλλέξει. Οι agents που είναι συνδεδεμένοι με το zaDojo έχουν οδηγία να σε ρωτούν πριν από μια προγραμματισμένη παρτίδα πάνω από 2.000 credits (περίπου 2 €). Όταν το υπόλοιπο μηδενίσει, τα πληρωμένα εργαλεία σταματούν μέχρι να κάνεις ανανέωση. Δες την τιμολόγηση για τον υπολογιστή κόστους.

Μετά τη σύνδεση

Η σύνδεση δίνει δεδομένα στον agent σου. Τα skills του λένε τι να κάνει με αυτά τα δεδομένα, βήμα προς βήμα. Αν χρησιμοποίησες MCP χωρίς plugin, εγκατάστησε τα skills στη συνέχεια.

Δώσε στον agent μία συγκεκριμένη δουλειά αντί να του ζητήσεις να "κάνει SEO":

• SEO Project Setup: αποθήκευσε τον στόχο, το positioning, τους ανταγωνιστές και τις βασικές σελίδες σου, ώστε κάθε επόμενη εργασία να ξεκινά από αυτά.
• SEO Coach: πάρε ένα προτεινόμενο επόμενο βήμα αν είσαι νέος στο SEO.
• SEO Audit: βρες τις λίγες αλλαγές που είναι πιο πιθανό να αυξήσουν την επισκεψιμότητα.
• Keyword Research και Keyword Clustering: βρες όρους αναζήτησης που αξίζει να στοχεύσεις και ομαδοποίησέ τους σε σελίδες.
• Competitive Landscape και Competitor Analysis: χαρτογράφησε μια αγορά ή μελέτησε σε βάθος έναν ανταγωνιστή.
• Link Prospecting: βρες sites που μπορεί να κάνουν link σε μια σελίδα και γράψε προσχέδια outreach.
• AI Prompt Research και AI Visibility Audit: δες τι λένε τα εργαλεία AI για την αγορά σου και γιατί αναφέρονται οι ανταγωνιστές.

Ο οδηγός ορατότητας σε AI καλύπτει μηχανές, κάλυψη και κόστος για το tracking απαντήσεων AI.

Αντιμετώπιση προβλημάτων

Ο client δεν μπορεί να συνδεθεί. Έλεγξε ότι η διεύθυνση είναι ακριβώς https://app.zadojo.com/mcp, με https:// και χωρίς κενά στο τέλος.

Το Codex αναφέρει Authorization server response missing required issuer: expected https://app.zadojo.com. Οι εκδόσεις 0.143 έως 0.146 του Codex χάνουν τον issuer κατά το OAuth. Ενημέρωσε το Codex CLI ή την εφαρμογή Codex για desktop σε 0.147.0 ή νεότερη, ή χρησιμοποίησε API key.

Η σύνδεση αποτυγχάνει ή λήγει συνέχεια. Αφαίρεσε τον server του zaDojo από τον client σου, πρόσθεσέ τον ξανά και επανάλαβε τη σύνδεση.

Ο agent δεν βρίσκει ένα project. Ζήτησέ του να καλέσει πρώτα το list_projects και να χρησιμοποιεί το ID του project που επιστρέφεται στις επόμενες κλήσεις. Αν δεν έχεις projects, ζήτησέ του να δημιουργήσει ένα για το domain σου με το create_project, που είναι δωρεάν.

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

Ακόμα κολλημένος; Στείλε email στο hello@zadojo.com με το όνομα και την έκδοση του client σου και το ακριβές σφάλμα. Μη συμπεριλάβεις ποτέ API keys.