Configurare l'agente AI: zaDojo e skill

Un agente AI ha bisogno di due elementi di zaDojo. La connessione MCP gli permette di chiamare gli strumenti di zaDojo per avere dati SEO in tempo reale all'indirizzo https://app.zadojo.com/mcp. Le skill sono file SKILL.md che gli spiegano come svolgere dall'inizio alla fine un lavoro come un audit o una ricerca keyword. Il modo più rapido per avere entrambi è incollare il prompt di configurazione qui sotto nel tuo agente e lasciare che sia lui a installare.

Usi ChatGPT? Vai invece alla guida a ChatGPT. Una normale chat di ChatGPT non può installare nulla, quindi il prompt le fa solo stampare i passaggi manuali. La connessione personalizzata funziona su ChatGPT Free e sui piani a pagamento.

Cosa ti serve

• Un account zaDojo. Registrati per ricevere 0,10 € di crediti di prova senza carta, oppure crea l'account quando la configurazione apre la pagina di accesso.
• Un agente in grado di collegarsi a un server MCP remoto: Claude Code, Claude Cowork, Codex (CLI o app desktop di ChatGPT), Hermes, Grok Bot, Cursor e client simili.
• Un browser in cui approvare l'accesso a zaDojo. Per un agente senza interfaccia e senza browser, usa invece una API key.

Configura il tuo agente

1. Copia il prompt qui sotto. Puoi copiarlo anche da Agent setup nell'app zaDojo, oppure indicare al tuo agente la versione in testo semplice su https://zadojo.com/agent-setup.txt.
2. Incollalo in una nuova chat o sessione del tuo agente.
3. L'agente capisce quale client è, controlla se esiste già una connessione a zaDojo e installa il plugin dove disponibile. Dove non esiste un plugin, aggiunge separatamente il server MCP e le skill pubbliche.
4. Quando il browser apre l'accesso a zaDojo, accedi e approva.
5. Se l'agente ti chiede di ricaricare, riavviare o cliccare qualcosa che non può raggiungere, fai tu quel passaggio. Ti dice esattamente cosa fare.

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.

L'agente termina con un breve messaggio di stato e qualche prima attività suggerita. Durante la configurazione non crea progetti e non avvia ricerche a pagamento.

Configurazione manuale per agente

Salta questa sezione se il prompt ha già completato l'installazione. Ogni blocco qui sotto fa lo stesso lavoro a mano.

Claude Code

In una sessione di Claude Code, aggiungi il marketplace e installa il plugin:

/plugin marketplace add zadojo/seo-geo-mcp
/plugin install zadojo@zadojo

Esegui /reload-plugins se Claude Code ti chiede di attivare il plugin. Approva l'accesso a zaDojo, poi scrivi /zadojo:seo-coach per verificare che le skill siano caricate. La guida al plugin per Claude Code spiega ambiti, aggiornamenti e soluzioni ai problemi.

Claude Cowork

In Cowork i plugin si aggiungono dai menu, quindi un agente non può fare questa parte al posto tuo. Vai su Customize > Plugins > Add marketplace > Add from a repository, inserisci https://github.com/zadojo/seo-geo-mcp e installa zaDojo. Serve un piano Claude a pagamento. I passaggi per Cowork spiegano l'alternativa per il piano Free.

Codex nell'app desktop di ChatGPT

1. Apri Codex e avvia una nuova chat.
2. Incolla il prompt di configurazione di questa pagina.
3. Approva l'accesso a zaDojo quando compare.
4. Se Codex dice che gli strumenti non sono ancora caricati, avvia un'altra nuova chat.

Per installare a mano, segui i passaggi per Codex desktop. È OpenAI a decidere quali piani ChatGPT includono Codex, quindi controlla la pagina dei piani di OpenAI. Una connessione di Codex è separata da chatgpt.com: una normale chat di ChatGPT non la vede.

Codex CLI

Da un terminale:

codex plugin marketplace add zadojo/seo-geo-mcp
codex plugin add zadojo@zadojo

Se il plugin non compare, ricarica o riavvia Codex. Poi accedi:

codex mcp login zadojo

Chiedi a Codex di usare SEO Coach per verificare che tutto funzioni. La guida al plugin per Codex elenca i messaggi di errore che potresti vedere. Se hai installato da una directory di plugin desktop, gestisci il plugin da quella directory.

Hermes

Incolla il prompt di configurazione per collegare il server MCP. Le skill arrivano dall'hub delle skill di Hermes. Per aggiungere SEO Coach:

hermes skills install zadojo/seo-geo-mcp/plugins/seo-geo-mcp/skills/seo-coach

Esegui lo stesso comando con un altro nome di cartella per ogni skill di zaDojo in più che vuoi, per esempio seo-audit o keyword-research. Hermes registra la provenienza di ogni skill per poter controllare gli aggiornamenti in seguito. La sua documentazione è in Hermes skill management.

Grok Bot

Incolla il prompt di configurazione nel tuo Bot e svolgi i passaggi che ti restituisce. Skill e connettori pacchettizzati si trovano in Marketplace nella barra laterale. Le skill private sono in Your plugins > Manage plugins and skills > Private skills, e ogni Bot del tuo account può usarle. Il riferimento di xAI è Grok Bot skills.

Claude web e altri agenti

Collega il server con la guida alla configurazione MCP. Poi aggiungi le skill con il gestore di skill supportato dal tuo agente. In Claude, le skill personalizzate si gestiscono in Customize > Skills. Con un piano Claude a pagamento, il plugin di zaDojo aggiunge insieme connessione e skill.

Gli agenti compatibili con la CLI skills possono scegliere le skill di zaDojo da un elenco:

npx skills add https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills

Scegli il tuo agente attuale e l'ambito di installazione che preferisci. Non eseguirlo sopra il plugin, perché il plugin contiene già le skill. Le altre strade sono descritte nella configurazione manuale delle skill.

Verifica che funzioni

Apri una nuova chat e invia:

Usa zaDojo per verificare la mia connessione ed elencare i miei progetti.

Una configurazione funzionante chiama gli strumenti di zaDojo e restituisce il tuo account e l'elenco dei progetti. Anche un elenco vuoto va bene: significa solo che non hai ancora creato un progetto. Questa verifica legge soltanto dati e non consuma crediti.

Poi controlla le skill. In Claude Code, scrivi /zadojo: e cerca i nomi delle dodici skill. In Codex, scrivi $. Negli altri agenti, chiedi "Quali skill di zaDojo vedi?". Una connessione che funziona senza skill è configurata solo a metà.

Se entrambe le verifiche vanno a buon fine, chiedi al tuo agente di eseguire SEO Coach. Guarda a che punto è il tuo progetto e ti consiglia un prossimo passo.

Aggiornare le skill

Le skill migliorano nel tempo, e le copie dentro il tuo agente non si aggiornano da sole. Aggiornare la connessione MCP aggiorna l'elenco degli strumenti, non i file delle skill.

Chi usa ChatGPT deve seguire invece i passaggi di aggiornamento per ChatGPT. Una connessione personalizzata di ChatGPT non ha file di skill da aggiornare.

La strada più semplice è incollare questo prompt nell'agente in cui usi zaDojo. Scopre come sono state installate le skill, le aggiorna nello stesso posto e conserva il tuo accesso e le eventuali modifiche che hai fatto ai file delle skill.

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.

Seguono i passaggi manuali di aggiornamento per ogni metodo di installazione.

Aggiornare il plugin per Claude Code

/plugin marketplace update zadojo
/plugin update zadojo@zadojo
/reload-plugins

Per non doverlo fare a mano, apri /plugin, vai su Marketplaces, seleziona zadojo e scegli Enable auto-update. L'aggiornamento automatico è disattivato di default per i marketplace non gestiti da Anthropic. Quando Claude Code ti avvisa che c'è un aggiornamento in attesa, esegui /reload-plugins. Anthropic documenta l'impostazione in configure auto-updates.

Aggiornare il plugin per Codex CLI

codex plugin marketplace upgrade zadojo

Riavvia o ricarica Codex se le nuove versioni delle skill non compaiono. I comandi dei plugin di Codex sono cambiati tra una versione e l'altra, quindi se questo viene rifiutato esegui codex plugin --help per vedere cosa accetta la tua versione. OpenAI descrive i marketplace nella sua documentazione sui plugin.

Aggiornare le skill dall'hub di Hermes

Chiedi a Hermes quali skill hanno aggiornamenti, poi aggiorna per nome quelle di zaDojo:

hermes skills check
hermes skills update seo-coach

Ripeti la riga di aggiornamento per ogni skill di zaDojo installata. Se hai modificato una skill in locale, Hermes di default non la tocca. Rileggi prima le tue modifiche. Aggiungi --force solo se ti va bene perderle. I dettagli sono nel ciclo di aggiornamento di Hermes.

Aggiornare le skill installate con la skills CLI

npx skills list
npx skills update seo-coach seo-audit

Sostituisci i nomi con quelli delle skill che hai davvero installato. Usa lo stesso ambito dell'installazione: -g per le skill globali o -p per quelle di progetto. Salva una copia delle tue modifiche personali prima di aggiornare. Le nuove skill aggiunte dopo l'installazione non vengono prese da update, quindi esegui di nuovo il comando di installazione per selezionarle. La documentazione della skills CLI ha l'elenco completo delle opzioni.

Aggiornare Grok Bot o le skill copiate a mano

Per Grok Bot, incolla il prompt di aggiornamento, oppure apri Marketplace > Your plugins > Manage plugins and skills e aggiorna da lì la voce di zaDojo. xAI non pubblica un comando di aggiornamento separato per le skill, quindi usa i controlli che mostra la tua versione.

Se hai copiato le cartelle delle skill a mano, confrontale con le cartelle attuali delle skill. Sostituisci ogni cartella per intero, compresi i file accanto a SKILL.md, e riporta le tue modifiche. Le skill caricate da Customize > Skills di Claude si sostituiscono nello stesso punto.

Quando hai finito, ricarica le skill o apri una nuova sessione, poi chiedi all'agente di confermare che vede le skill di zaDojo aggiornate.

Risoluzione dei problemi

Per qualsiasi altro problema, scrivi a hello@zadojo.com indicando nome e versione dell'agente, il passaggio non riuscito e il testo esatto dell'errore. Non inviare mai password, API key o codici di accesso.

Cosa consuma crediti

Configurazione, accesso, verifica della connessione e aggiornamento delle skill non costano nulla. Anche SEO Coach è gratuito, a meno che tu non gli chieda di fare ricerche. I crediti si consumano solo quando il tuo agente recupera dati a pagamento, e 1.000 crediti valgono 1 €. Alcuni prezzi tipici:

• Una ricerca keyword: circa 0,07 €.
• Una panoramica di dominio o backlink con un anno di storico: circa 0,10 €.
• Prompt Research per una keyword: circa 0,25 €.

Le letture di Search Console e Google Analytics, il contesto del progetto, le keyword salvate, i report e i semplici audit del sito sono gratuiti. Il piano costa 10 € al mese e include 10 € di utilizzo ogni mese. Nella pagina dei prezzi trovi l'elenco completo e uno stimatore dei costi.