Ρύθμιση AI agent: σύνδεση zaDojo και skills
Σύνδεσε Claude Code, Codex, Claude Cowork, Hermes ή άλλον AI agent με το zaDojo με ένα prompt, επιβεβαίωσε ότι δουλεύει και κράτα ενημερωμένα τα SEO skills.
Ένας AI agent χρειάζεται δύο κομμάτια από το zaDojo. Η σύνδεση MCP του επιτρέπει να καλεί εργαλεία του zaDojo για ζωντανά δεδομένα SEO στο https://app.zadojo.com/mcp. Τα skills είναι αρχεία SKILL.md που του λένε πώς να τρέξει μια δουλειά, όπως έναν έλεγχο ή μια έρευνα λέξεων-κλειδιών, από την αρχή ως το τέλος. Ο πιο γρήγορος τρόπος να πάρεις και τα δύο είναι να επικολλήσεις το prompt ρύθμισης παρακάτω στον agent σου και να τον αφήσεις να κάνει την εγκατάσταση.
Χρησιμοποιείς ChatGPT; Πήγαινε στον οδηγό για ChatGPT. Μια κανονική συνομιλία ChatGPT δεν μπορεί να εγκαταστήσει τίποτα, οπότε το prompt απλώς τυπώνει τα χειροκίνητα βήματα. Η custom σύνδεση δουλεύει στο ChatGPT Free όπως και στα συνδρομητικά πλάνα.
Τι χρειάζεσαι
- Λογαριασμό zaDojo. Κάνε εγγραφή για να πάρεις 0,10 € δοκιμαστικά credits χωρίς κάρτα ή δημιούργησε τον λογαριασμό όταν η ρύθμιση ανοίξει τη σελίδα σύνδεσης.
- Έναν agent που μπορεί να συνδεθεί σε απομακρυσμένο MCP server: Claude Code, Claude Cowork, Codex (CLI ή η εφαρμογή ChatGPT για desktop), Hermes, Grok Bot, Cursor και παρόμοιους clients.
- Έναν browser όπου μπορείς να εγκρίνεις τη σύνδεση στο zaDojo. Για agent χωρίς browser, χρησιμοποίησε API key.
Στήσε τον agent σου
- Αντίγραψε το παρακάτω prompt. Μπορείς επίσης να το αντιγράψεις από το Agent setup μέσα στο app του zaDojo ή να δείξεις στον agent σου την έκδοση απλού κειμένου στο
https://zadojo.com/agent-setup.txt. - Επικόλλησέ το σε νέα συνομιλία ή συνεδρία στον agent σου.
- Ο agent καταλαβαίνει ποιος client είναι, ελέγχει αν υπάρχει ήδη σύνδεση με το zaDojo και εγκαθιστά το plugin όπου υπάρχει. Όπου δεν υπάρχει plugin, προσθέτει ξεχωριστά τον MCP server και τα δημόσια skills.
- Όταν ο browser σου ανοίξει τη σύνδεση στο zaDojo, συνδέσου και ενέκρινε την πρόσβαση.
- Αν ο agent σου ζητήσει επαναφόρτωση, επανεκκίνηση ή ένα κλικ σε κάτι που δεν μπορεί να φτάσει, κάνε αυτό το βήμα. Σου λέει ακριβώς τι να κάνεις.
Set up zaDojo in this agent. Do what you can; guide me through anything that needs my input.
## 1. Check this agent
- Identify this agent and its version. Ask only if you cannot tell.
- Check for an existing zaDojo connection. Preserve other integrations and avoid duplicates.
- Check for zaDojo skills separately. A connection without skills is incomplete.
## 2. If this is ChatGPT
If I pasted this into a regular ChatGPT conversation (web or desktop app, not Codex), you cannot install zaDojo from here. Don't run commands or edit files. Instead, give me these steps and stop:
1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. This works on Free and paid plans; no upgrade is needed.
2. Open **Settings → Plugins → Developer mode** (or **Plugins → + → Create MCP App**). Name it zaDojo, enter the server URL `https://app.zadojo.com/mcp` in full, including `https://` (otherwise ChatGPT reports "Unsafe URL"), and keep **OAuth** selected.
3. Create it, sign in to zaDojo, and approve the connection.
4. Start a new chat, select zaDojo from the **+** menu, and send: "Use zaDojo to check my connection and list my projects."
Link the [ChatGPT setup guide](https://zadojo.com/docs/chatgpt) for screenshots and troubleshooting. If I'm in Codex, continue below.
## 3. Install the plugin first
The official plugin bundles MCP + SEO skills, with zaDojo namespacing and shared updates.
- **Codex:** follow the [plugin guide](https://zadojo.com/docs/codex-plugin).
- **Claude Code:** follow the [plugin guide](https://zadojo.com/docs/claude-code-plugin).
- **Claude Cowork or the Claude desktop app:** you cannot install plugins from this chat, so don't run commands. Tell me to open **Customize** (in Cowork, the **Cowork** tab first) → **Plugins** → **+** or **Add** → **Add marketplace** → **Add from a repository**, enter `https://github.com/zadojo/seo-geo-mcp`, and install **zaDojo**. Then I start a new task and type `/` to check that zaDojo skills appear. If I already have a custom zaDojo connector, have me remove it once the plugin signs in. Plugins need a paid Claude plan. If I'm on Claude Free, have me add `https://app.zadojo.com/mcp` under **Customize → Connectors** → **Add custom connector** and upload the [public skills](https://zadojo.com/docs/skills/setup) in **Customize → Skills**. Then continue at step 5.
- **Other agents:** verify plugin compatibility in their current documentation.
- Check the installed client's help before running commands.
## 4. Fall back to MCP + skills
If the plugin is unsupported:
- Add `https://app.zadojo.com/mcp` using the [MCP guide](https://zadojo.com/docs/mcp).
- Install the [public SEO skills](https://zadojo.com/docs/skills/setup) for this agent only.
- Do not copy internal repository skills or duplicate bundled skills.
- If skills are unsupported, use MCP alone and link to the workflow guides.
## 5. Sign in
- Prefer OAuth and let me approve login in my browser. If this client cannot use OAuth, send me to `https://app.zadojo.com/settings` → API keys. Have me enter the key in the client's secret settings or environment, never chat or a repository.
- **Manual setup needed?** Use this agent’s current documentation and give only the steps I need to do myself.
## 6. Reload and verify
- Use the current agent’s native reload flow, checking its installed version, help, or official documentation. Prefer automatic discovery or an in-place reload; restart only if required to load the new tools and skills.
- Once tools load in this session, run whoami and list_projects (free reads). Check skill discovery too. If a reload needs my action, give the instructions rather than repeatedly retrying unavailable tools.
- Track installation, sign-in, and verification separately. A connected server is not proof that this session can use its tools. Never claim verification before the free reads succeed.
- Do not create projects or run paid research during installation.
## 7. Finish with a short handoff
Keep progress updates brief. The final reply must be **140 words or fewer** and follow this template:
**Status**
[Briefly say what succeeded or what blocked setup.]
**Next**
1. `[Give the native reload command or UI action for this agent, only if needed.]` Then say “Check that zaDojo is connected.” Approve sign-in if prompted.
2. Try one of these:
- `[SEO Audit invocation]` **(recommended)**: find your website's biggest SEO issues.
- `[SEO Project Setup invocation]`: interview you about your website and set up its project context.
- `[Keyword Research invocation]`: find keywords worth targeting.
- `[Local SEO invocation]`: review your Google Business Profile and local competitors.
Want to know what was set up? Just ask.
Adapt the template to the actual result:
- If I must install the plugin by hand, as in Claude Cowork, replace step 1 with those clicks.
- If installation failed, name the blocker and replace reload with the fix. If fully verified, say it is ready and omit reload. Do not claim sign-in failed or is required merely because tools need reloading.
- Recommend this agent’s idiomatic way to invoke each installed skill: its native command, mention, picker, or natural-language request. Use the discovered skill name and plugin namespace; do not assume `/skill-name` works everywhere or create aliases to force it. Check the agent’s help or official documentation when unsure. If skills are unsupported, give equivalent plain-language requests using the connected tools. Recommend workflows; do not run them during installation.
- Keep tool names such as whoami and list_projects in your checks, not the final reply. Omit versions, paths, connection details, skill counts, other integrations, and cleanup commands unless they explain the blocker or I ask. Do not add more sections or a verification checklist.Ο agent τελειώνει με ένα σύντομο μήνυμα κατάστασης και μερικές προτεινόμενες πρώτες εργασίες. Δεν δημιουργεί projects ούτε τρέχει πληρωμένη έρευνα κατά τη ρύθμιση.
Χειροκίνητη ρύθμιση ανά agent
Παράλειψε αυτή την ενότητα αν το prompt ολοκλήρωσε ήδη την εγκατάσταση. Κάθε block παρακάτω κάνει την ίδια δουλειά με το χέρι.
| Agent | Τι εγκαθίσταται | Πλήρης οδηγός |
|---|---|---|
| Claude Code | Plugin (σύνδεση MCP και 12 skills) | Plugin για Claude Code |
| Claude Cowork ή Claude desktop | Plugin, από το μενού Customize | Βήματα για Cowork |
| Codex CLI | Plugin (σύνδεση MCP και 12 skills) | Codex plugin |
| Codex στην εφαρμογή ChatGPT για desktop | Prompt ρύθμισης ή plugin | Βήματα για Codex desktop |
| Συνομιλία ChatGPT στο web ή desktop | Custom σύνδεση MCP (μόνο εργαλεία) | Οδηγός για ChatGPT |
| Cursor και άλλοι MCP clients | Σύνδεση MCP και μετά ξεχωριστά τα skills | Ρύθμιση MCP |
Claude Code
Μέσα σε μια συνεδρία Claude Code, πρόσθεσε το marketplace και εγκατάστησε το plugin:
/plugin marketplace add zadojo/seo-geo-mcp
/plugin install zadojo@zadojoΤρέξε /reload-plugins αν το Claude Code σου ζητήσει να ενεργοποιήσεις το plugin. Ενέκρινε τη σύνδεση στο zaDojo και μετά γράψε /zadojo:seo-coach για να επιβεβαιώσεις ότι φορτώθηκαν τα skills. Ο οδηγός plugin για Claude Code καλύπτει scopes, ενημερώσεις και λύσεις.
Claude Cowork
Στο Cowork τα plugins προστίθενται μέσα από μενού, οπότε ένας agent δεν μπορεί να κάνει αυτό το κομμάτι για σένα. Πήγαινε στο Customize > Plugins > Add marketplace > Add from a repository, γράψε https://github.com/zadojo/seo-geo-mcp και εγκατάστησε το zaDojo. Χρειάζεται συνδρομητικό πλάνο Claude. Τα βήματα για Cowork εξηγούν την εναλλακτική για το πλάνο Free.
Codex στην εφαρμογή ChatGPT για desktop
- Άνοιξε το Codex και ξεκίνα νέα συνομιλία.
- Επικόλλησε το prompt ρύθμισης από αυτή τη σελίδα.
- Ενέκρινε τη σύνδεση στο zaDojo όταν εμφανιστεί.
- Αν το Codex πει ότι τα εργαλεία δεν έχουν φορτωθεί ακόμα, ξεκίνα άλλη μία νέα συνομιλία.
Για εγκατάσταση με το χέρι, ακολούθησε τα βήματα για Codex desktop. Ποια πλάνα ChatGPT περιλαμβάνουν το Codex το ορίζει η OpenAI, οπότε δες τη σελίδα πλάνων της OpenAI. Μια σύνδεση στο Codex είναι ξεχωριστή από το chatgpt.com: μια κανονική συνομιλία ChatGPT δεν τη βλέπει.
Codex CLI
Από ένα terminal:
codex plugin marketplace add zadojo/seo-geo-mcp
codex plugin add zadojo@zadojoΑν το plugin δεν εμφανιστεί, κάνε επαναφόρτωση ή επανεκκίνηση του Codex. Μετά συνδέσου:
codex mcp login zadojoΖήτα από το Codex να χρησιμοποιήσει το SEO Coach για να ελέγξει ότι όλα δουλεύουν. Ο οδηγός για το Codex plugin περιλαμβάνει τα μηνύματα σφάλματος που μπορεί να δεις. Αν το εγκατέστησες από κατάλογο plugins σε desktop, διαχειρίσου το plugin από εκείνον τον κατάλογο.
Hermes
Επικόλλησε το prompt ρύθμισης για να συνδέσεις τον MCP server. Τα skills έρχονται από το skills hub του Hermes. Για να προσθέσεις το SEO Coach:
hermes skills install zadojo/seo-geo-mcp/plugins/seo-geo-mcp/skills/seo-coachΤρέξε την ίδια εντολή με άλλο όνομα φακέλου για κάθε επιπλέον skill του zaDojo που θέλεις, για παράδειγμα seo-audit ή keyword-research. Το Hermes καταγράφει από πού ήρθε κάθε skill, ώστε να ελέγχει αργότερα για ενημερώσεις. Η δική του τεκμηρίωση βρίσκεται στο Hermes skill management.
Grok Bot
Επικόλλησε το prompt ρύθμισης στο Bot σου και κάνε όσα βήματα σου επιστρέψει. Τα πακέτα skills και οι connectors βρίσκονται στο Marketplace στην πλαϊνή στήλη. Τα ιδιωτικά skills βρίσκονται στο Your plugins > Manage plugins and skills > Private skills και κάθε Bot του λογαριασμού σου μπορεί να τα χρησιμοποιεί. Δες τα Grok Bot skills για την αναφορά της xAI.
Claude web και άλλοι agents
Σύνδεσε τον server με τον οδηγό ρύθμισης MCP. Μετά πρόσθεσε τα skills με όποιο εργαλείο διαχείρισης skills υποστηρίζει ο agent σου. Στο Claude, τα custom skills διαχειρίζονται στο Customize > Skills. Σε συνδρομητικό πλάνο Claude, το plugin του zaDojo προσθέτει μαζί τη σύνδεση και τα skills.
Οι agents που δουλεύουν με το CLI skills μπορούν να διαλέξουν skills του zaDojo από λίστα:
npx skills add https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skillsΔιάλεξε τον τρέχοντα agent σου και το scope εγκατάστασης που προτιμάς. Μην το τρέξεις πάνω από το plugin, γιατί το plugin περιλαμβάνει ήδη τα skills. Άλλοι τρόποι καλύπτονται στη χειροκίνητη ρύθμιση skills.
Έλεγξε ότι δούλεψε
Ξεκίνα νέα συνομιλία και στείλε:
Χρησιμοποίησε το zaDojo για να ελέγξεις τη σύνδεσή μου και να δείξεις τα projects μου.Μια ρύθμιση που δουλεύει καλεί εργαλεία του zaDojo και επιστρέφει τον λογαριασμό σου και τη λίστα projects. Και μια κενή λίστα είναι επιτυχία: σημαίνει ότι δεν έχεις δημιουργήσει ακόμα project. Αυτός ο έλεγχος μόνο διαβάζει δεδομένα και δεν καταναλώνει credits.
Μετά έλεγξε τα skills. Στο Claude Code, γράψε /zadojo: και ψάξε τα δώδεκα ονόματα skills. Στο Codex, γράψε $. Σε άλλους agents, ρώτα "Ποια skills του zaDojo βλέπεις;" Μια σύνδεση που δουλεύει χωρίς κανένα skill είναι μόνο μισοστημένη.
Αν περάσουν και οι δύο έλεγχοι, ζήτα από τον agent σου να τρέξει το SEO Coach. Κοιτάζει πού βρίσκεται το project σου και προτείνει ένα επόμενο βήμα.
Ενημέρωση των skills σου
Τα skills βελτιώνονται με τον καιρό και τα αντίγραφα μέσα στον agent σου δεν ενημερώνονται μόνα τους. Η ανανέωση της σύνδεσης MCP ενημερώνει τη λίστα εργαλείων, όχι τα αρχεία των skills.
Οι χρήστες του ChatGPT θα πρέπει να ακολουθήσουν τα βήματα ενημέρωσης για ChatGPT. Μια custom σύνδεση ChatGPT δεν έχει αρχεία skills για ενημέρωση.
Ο πιο εύκολος δρόμος είναι να επικολλήσεις αυτό το prompt στον agent όπου χρησιμοποιείς το zaDojo. Βρίσκει πώς εγκαταστάθηκαν τα skills, τα ενημερώνει στο ίδιο σημείο και κρατά τη σύνδεσή σου και όποιες αλλαγές έκανες στα αρχεία των skills.
Update my installed zaDojo skills using https://zadojo.com/docs/agent-setup#update-your-skills.
If this is ChatGPT on the web or a regular desktop chat, use https://zadojo.com/docs/chatgpt#update-zadojo. For a public directory plugin, start a new chat to load the available tools and skills; reconnect only if sign-in needs attention. For a custom MCP connection, select Refresh in its details, then start a new chat. Refreshing a custom connection updates tools, not skill files. Do not run local Codex commands to update ChatGPT web.
Identify this agent and how zaDojo was installed. Use the matching plugin or skills installer, checking the installed client's help before running commands. Update only zaDojo in its existing scope. Preserve my MCP endpoint, sign-in, and personal skill edits; ask before replacing conflicting edits. Avoid duplicate skills and do not install internal repository skills.
If the skills were copied manually, compare them with https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills and update the installed public skill folders, including their supporting files. For Grok Bot or another agent without a verified update command, use its supported skill management flow or give me the exact manual steps available in this version.
Reload skills if supported. If I need to reload or start a new session, tell me what to do. Verify the updated skill files and that this agent can discover them; an active MCP connection alone does not prove the skills updated. Briefly tell me what changed and anything left to do. Do not run SEO research during the update.Ακολουθούν τα χειροκίνητα βήματα ενημέρωσης για κάθε τρόπο εγκατάστασης.
Ενημέρωση του plugin για Claude Code
/plugin marketplace update zadojo
/plugin update zadojo@zadojo
/reload-pluginsΓια να μην το κάνεις πια με το χέρι, άνοιξε το /plugin, πήγαινε στα Marketplaces, διάλεξε zadojo και επίλεξε Enable auto-update. Η αυτόματη ενημέρωση ξεκινά απενεργοποιημένη για marketplaces που δεν διαχειρίζεται η Anthropic. Όταν το Claude Code σου πει ότι περιμένει μια ενημέρωση, τρέξε /reload-plugins. Η Anthropic περιγράφει τη ρύθμιση στο configure auto-updates.
Ενημέρωση του plugin για Codex CLI
codex plugin marketplace upgrade zadojoΚάνε επανεκκίνηση ή επαναφόρτωση του Codex αν δεν εμφανιστούν οι νέες εκδόσεις των skills. Οι εντολές plugin του Codex έχουν αλλάξει ανάμεσα σε εκδόσεις, οπότε αν αυτή απορριφθεί, τρέξε codex plugin --help για να δεις τι δέχεται η έκδοσή σου. Η OpenAI περιγράφει τα marketplaces στην τεκμηρίωση plugins.
Ενημέρωση skills από το Hermes hub
Ρώτα το Hermes ποια skills έχουν ενημερώσεις και μετά ενημέρωσε ονομαστικά αυτά του zaDojo:
hermes skills check
hermes skills update seo-coachΕπανάλαβε τη γραμμή ενημέρωσης για κάθε skill του zaDojo που εγκατέστησες. Αν άλλαξες τοπικά ένα skill, το Hermes από προεπιλογή δεν το αγγίζει. Διάβασε πρώτα τις αλλαγές σου. Πρόσθεσε --force μόνο όταν δεν σε πειράζει να τις χάσεις. Λεπτομέρειες στο Hermes update lifecycle.
Ενημέρωση skills που εγκαταστάθηκαν με το skills CLI
npx skills list
npx skills update seo-coach seo-auditΒάλε τα ονόματα των skills που πραγματικά εγκατέστησες. Χρησιμοποίησε το ίδιο scope με την εγκατάσταση: -g για global skills ή -p για skills project. Κράτα αντίγραφο των προσωπικών σου αλλαγών πριν από την ενημέρωση. Νέα skills που προστέθηκαν μετά την εγκατάστασή σου δεν τα πιάνει το update, οπότε τρέξε ξανά την εντολή εγκατάστασης για να τα επιλέξεις. Η τεκμηρίωση του skills CLI έχει όλες τις επιλογές.
Ενημέρωση Grok Bot ή skills που αντιγράφηκαν με το χέρι
Για το Grok Bot, επικόλλησε το prompt ενημέρωσης ή άνοιξε το Marketplace > Your plugins > Manage plugins and skills και ενημέρωσε εκεί την καταχώρηση του zaDojo. Η xAI δεν δημοσιεύει ξεχωριστή εντολή ενημέρωσης για skills, οπότε χρησιμοποίησε τα χειριστήρια που δείχνει η έκδοσή σου.
Αν αντέγραψες φακέλους skills με το χέρι, σύγκρινέ τους με τους τρέχοντες φακέλους skills. Αντικατάστησε κάθε φάκελο ολόκληρο, μαζί με τα αρχεία δίπλα στο SKILL.md, και μετάφερε τις δικές σου αλλαγές. Τα skills που ανέβηκαν μέσω του Customize > Skills του Claude αντικαθίστανται στο ίδιο σημείο.
Όταν τελειώσεις, κάνε επαναφόρτωση των skills ή άνοιξε νέα συνεδρία και ζήτα από τον agent να επιβεβαιώσει ότι βλέπει τα ενημερωμένα skills του zaDojo.
Αντιμετώπιση προβλημάτων
| Πρόβλημα | Λύση |
|---|---|
| Ο agent εξηγεί το MCP αλλά δεν καλεί ποτέ εργαλείο zaDojo | Η σύνδεση δεν έχει φορτωθεί σε αυτή τη συνεδρία. Κάνε επαναφόρτωση ή επανεκκίνηση του agent, ξεκίνα νέα συνομιλία και στείλε ξανά το αίτημα ελέγχου. |
| Η σελίδα σύνδεσης δεν ανοίγει ποτέ | Επίτρεψε τα pop-ups για τον agent και δοκίμασε ξανά τη σύνδεση από τις ρυθμίσεις MCP ή connector. Οι agents χωρίς browser μπορούν να χρησιμοποιήσουν API key. |
| Τα εργαλεία δουλεύουν, αλλά δεν εμφανίζονται skills | Πρόσθεσες τη σύνδεση MCP χωρίς τα skills. Εγκατάστησε το plugin ή πρόσθεσε τα skills με το εργαλείο διαχείρισης skills του agent σου. |
| Εμφανίζονται δύο καταχωρήσεις zaDojo | Κράτα το plugin και αφαίρεσε τον επιπλέον custom connector ή την καταχώρηση MCP, ώστε να μείνει μία σύνδεση. |
Μια εντολή plugin του Codex απορρίπτεται | Τρέξε codex plugin --help. Τα ονόματα των subcommands διαφέρουν ανάμεσα σε εκδόσεις του Codex. |
| Δεν είσαι σίγουρος ότι η ενημέρωση δούλεψε | Ξεκίνα νέα συνεδρία και ζήτα από τον agent να δείξει τα skills του zaDojo που βλέπει. |
Για οτιδήποτε άλλο, στείλε email στο hello@zadojo.com με το όνομα και την έκδοση του agent σου, το βήμα που απέτυχε και το ακριβές κείμενο του σφάλματος. Μη στέλνεις ποτέ κωδικούς, API keys ή κωδικούς σύνδεσης.
Τι καταναλώνει credits
Η ρύθμιση, η σύνδεση, ο έλεγχος σύνδεσης και οι ενημερώσεις skills δεν κοστίζουν τίποτα. Το SEO Coach είναι επίσης δωρεάν, εκτός αν του ζητήσεις να τρέξει έρευνα. Credits ξοδεύονται μόνο όταν ο agent σου φέρνει πληρωμένα δεδομένα, και 1.000 credits αντιστοιχούν σε 1 €. Μερικές τυπικές τιμές:
- Μια αναζήτηση έρευνας λέξεων-κλειδιών: περίπου 0,07 €.
- Μια επισκόπηση domain ή backlinks με ιστορικό ενός έτους: περίπου 0,10 €.
- Prompt Research για μία λέξη-κλειδί: περίπου 0,25 €.
Οι αναγνώσεις από Search Console και Google Analytics, το context του project, οι αποθηκευμένες λέξεις-κλειδιά, οι αναφορές και οι απλοί έλεγχοι site είναι δωρεάν. Το πλάνο κοστίζει 10 € τον μήνα και περιλαμβάνει χρήση 10 € κάθε μήνα. Δες την τιμολόγηση για την πλήρη λίστα και έναν υπολογιστή κόστους.