Server MCP di zaDojo: Claude, Cursor, Codex

zaDojo gestisce un server MCP remoto a cui può collegarsi qualsiasi client che supporti MCP remoto. MCP (Model Context Protocol) è lo standard con cui le app di AI chiamano strumenti esterni. Tramite MCP il tuo agente può cercare keyword, leggere i risultati di Google in tempo reale, consultare posizionamenti e backlink di qualsiasi dominio, eseguire audit del sito, monitorare posizionamenti e risposte AI e leggere i tuoi dati di Search Console e Google Analytics.

L'indirizzo del server:

https://app.zadojo.com/mcp

La prima volta che un client si collega, apre l'accesso a zaDojo nel browser e ti chiede di approvare. Da quel momento il client può usare gli strumenti sui progetti che vedi. Per job di CI e server senza browser, usa una API key.

Chi usa Claude Code e Codex ottiene di più dal plugin, che aggiunge questa connessione e le dodici skill di zaDojo con una sola installazione. Segui i passaggi di questa pagina quando vuoi solo la connessione MCP, o quando il tuo client non ha un plugin. La guida alla configurazione dell'agente ha un prompt che sceglie per te la strada giusta.

Cosa ti serve

Un account zaDojo. Registrati per ricevere 0,10 € di crediti di prova senza carta.
Un client che supporti server MCP remoti via HTTP: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex nell'app desktop di ChatGPT, ChatGPT con una connessione personalizzata, VS Code con Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed o simili.
Un browser per l'accesso, oppure una API key per l'uso senza interfaccia.

La pagina Agent setup nell'app mostra lo stesso indirizzo con un pulsante per copiarlo. Vuoi provare i dati di zaDojo prima di registrarti? Gli strumenti SEO gratuiti non richiedono un account.

Collega il tuo client

Claude Code

Per la maggior parte delle persone il plugin per Claude Code è la scelta migliore. Per la sola connessione, esegui questo comando in un terminale:

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

--scope user rende zaDojo disponibile in tutti i progetti sul tuo computer. Usa --scope local per limitarlo al repository corrente. Claude Code poi ti chiede di accedere a zaDojo. Se la richiesta non compare, esegui /mcp, seleziona zaDojo e completa l'accesso da lì.

Claude Desktop

Con un piano Claude a pagamento, il plugin di zaDojo aggiunge insieme connessione e skill. Con il piano Free, o per la sola connessione, aggiungi un connettore personalizzato:

Apri Customize > Connectors.
Clicca Add o + e scegli Add custom connector.
Incolla https://app.zadojo.com/mcp.
Accedi a zaDojo e approva l'accesso.

I connettori personalizzati funzionano con Claude Free, Pro, Max, Team ed Enterprise. Il piano Free consente un solo connettore personalizzato.

Cursor

Apri Customize e vai ai server MCP, oppure modifica direttamente ~/.cursor/mcp.json.
Aggiungi la voce di zaDojo:

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

Salva il file e approva l'accesso a zaDojo quando Cursor te lo chiede.

La guida a Cursor contiene un link di installazione con un clic e l'installazione delle skill.

Codex CLI

Il plugin per Codex aggiunge insieme connessione e skill. Per la sola connessione:

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

Approva l'accesso a zaDojo quando si apre. Se non si apre, esegui codex mcp login zadojo.

Codex nell'app desktop di ChatGPT

Il plugin per Codex include anche le skill. Per la sola connessione:

Apri Codex, poi vai su Settings > MCP servers > Add server.
Inserisci il nome zadojo, scegli Streamable HTTP e incolla https://app.zadojo.com/mcp.
Salva, poi clicca Restart quando Codex te lo chiede.
Clicca Authenticate accanto a zaDojo e approva l'accesso.
Apri una nuova chat di Codex ed esegui la verifica della connessione.

Questa connessione vale solo per Codex. ChatGPT sul web ne richiede una propria. Il riferimento di OpenAI è la documentazione MCP di Codex.

ChatGPT

Aggiungi zaDojo come connessione MCP personalizzata con OAuth. Funziona su ChatGPT Free e sui piani a pagamento, anche se gli amministratori di un workspace possono bloccare le connessioni personalizzate. La guida a ChatGPT ti accompagna schermata per schermata.

VS Code, Windsurf e Gemini CLI

Ognuno ha la sua pagina con la configurazione esatta, la API key e l'installazione delle skill:

Altri client MCP

Qualsiasi client in grado di raggiungere un server MCP remoto tramite streamable HTTP e che supporti l'accesso OAuth può usare l'indirizzo qui sopra. Se il client non supporta OAuth, invia una API key in un header come descritto più avanti.

Client	Dove aggiungerlo	Configurazione
Zed	Settings > AI > MCP Servers > Add Remote Server	`"context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
Cline	MCP Servers > Remote Servers, oppure `cline mcp add zadojo https://app.zadojo.com/mcp --transport http`	`"type": "streamableHttp", "url": "https://app.zadojo.com/mcp"`
opencode	`opencode.json`	`"mcp": { "zadojo": { "type": "remote", "url": "https://app.zadojo.com/mcp" } }`
Goose	`goose configure` > Add Extension > Remote Extension (Streamable HTTP)	`type: streamable_http`, `uri: https://app.zadojo.com/mcp`
Kiro	`~/.kiro/settings/mcp.json`	`"mcpServers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
Warp	Settings > Agents > MCP servers > Add > Streamable HTTP or SSE Server (URL)	`{ "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
JetBrains Junie	`~/.junie/mcp/mcp.json`, poi `/mcp` > Authorize	`"zadojo": { "url": "https://app.zadojo.com/mcp" }`

Tutti questi client aprono l'accesso a zaDojo nel browser la prima volta che si collegano.

Collegarsi con una API key

Una API key sostituisce l'accesso dal browser. Usala per pipeline di CI, server remoti, agenti come Hermes in cui il flusso di accesso non funziona, o qualsiasi client senza supporto OAuth.

Una chiave è personale. Tutto ciò che un agente fa con essa viene eseguito con il tuo account nel tuo workspace, quindi conservala come un segreto e non farne mai il commit in un repository.

Per crearne una, apri Settings nell'app zaDojo, trova API keys e clicca Create API key. Copia subito la chiave, perché zaDojo la mostra una sola volta. Le chiavi iniziano con zadojo_.

Claude Code:

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

Cursor: aggiungi un blocco headers alla voce di zaDojo in mcp.json:

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

Codex CLI: tieni la chiave in una variabile d'ambiente e indica a Codex di usarla:

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

Qualsiasi altro client: invia Authorization: Bearer zadojo_YOUR_KEY oppure x-api-key: zadojo_YOUR_KEY con ogni richiesta.

Per revocare una chiave, apri la stessa sezione API keys ed eliminala.

Verifica la connessione

Apri una nuova chat o sessione e invia:

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

L'agente dovrebbe chiamare whoami e list_projects. Ricevi il tuo account, il saldo crediti residuo e i tuoi progetti, oppure un elenco vuoto se non ne hai ancora. Entrambi gli strumenti sono gratuiti. Se l'agente spiega MCP invece di chiamare uno strumento, il server non è caricato in questa sessione: ricarica il client o apri una nuova chat.

Strumenti disponibili

Il server ha più di 80 strumenti. La tabella li raggruppa per tipo di lavoro. I nomi degli strumenti sono quelli che vede il tuo agente.

Area	Strumenti principali	Crediti
Account e progetti	`whoami`, `list_projects`, `create_project`, `get_project_context`, `update_project_context`	Gratuiti
Ricerca keyword	`research_keywords` (idee da 1 a 5 keyword di partenza), `get_keyword_metrics` (volume, difficoltà, intento, CPC e trend per un massimo di 700 keyword), `search_serp_locations`	A pagamento, tranne la ricerca delle località
Risultati Google	`get_serp_results` (risultati organici in tempo reale per 1-10 keyword), `find_serp_competitors`	A pagamento
Ricerca sui domini	`get_domain_overview`, `get_ranked_keywords`, `get_domain_keyword_suggestions`	A pagamento
Backlink	`get_backlinks_overview`, `get_backlinks_profile`	A pagamento
Keyword salvate	`list_saved_keywords`, `save_keywords`, `remove_saved_keywords`	Gratuiti
Rank tracking	`create_rank_tracker`, `add_rank_tracking_keywords`, `estimate_rank_tracker_cost`, `run_rank_tracker`, `get_rank_tracker`, `pin_rank_tracking_keywords`, `remove_rank_tracking_keywords`	Controlli a pagamento, configurazione e letture gratuite
Audit del sito	`run_site_audit`, `get_audit_status`, `get_audit_issues`, `get_audit_pages`, `list_site_audits`, `delete_site_audit`	Gratuito senza Lighthouse o rendering JavaScript
Local SEO	`search_local_businesses`, `get_local_serp_results` (Maps o Local Finder), `get_local_rank_grid`, `get_business_profile`, `get_business_reviews`, `get_business_updates`, `get_google_business_questions`, `list_business_categories`	A pagamento, tranne la ricerca delle categorie
Google Search Console	`get_search_console_performance`, `get_search_console_insights` (pagine con CTR basso, query cannibalizzate, aumenti e cali di clic), `get_search_console_hourly` (ultime 48 ore), `get_search_console_sitemaps`, `inspect_urls` (fino a 10 URL per chiamata)	Gratuiti
Google Analytics	`get_google_analytics_organic_overview`, `get_google_analytics_organic_landing_pages`, `get_google_analytics_page_performance`, `get_google_analytics_traffic_acquisition`, `get_google_analytics_key_events`, `get_google_analytics_ecommerce_performance`, `get_google_analytics_site_search`, `get_google_analytics_audience_breakdown`, `get_google_analytics_measurement_health`, `get_google_analytics_traffic_overview`, `get_google_analytics_breakdown`, `get_google_analytics_realtime_users`, `get_search_opportunities`	Gratuiti
Visibilità AI	`research_ai_visibility_prompts`, `explore_prompt`, `generate_ai_visibility_prompts`, `save_ai_visibility_tracker`, `estimate_ai_visibility_cost`, `set_ai_visibility_schedule`, `run_ai_visibility_check`	A pagamento
Risultati visibilità AI	`get_ai_visibility_tracker`, `get_ai_visibility_run`, `get_ai_visibility_results`, `get_ai_visibility_answer`, `get_ai_visibility_sources`, `get_ai_visibility_trend`, `export_ai_visibility_data`	Gratuiti
Report	`save_report`, `list_reports`, `get_report`, `delete_report`, `set_report_sharing`, `list_report_templates`, `save_report_template`, `delete_report_template`	Gratuiti

Alcuni comportamenti utili da conoscere:

Il contesto del progetto è la memoria condivisa di un progetto: panoramica dell'attività, obiettivo attuale, posizionamento, preferenze di scrittura, concorrenti, pagine chiave e un registro delle ricerche. Gli agenti lo leggono prima di iniziare, e l'app e gli altri agenti vedono le stesse voci.
I report salvati da un agente compaiono nel progetto e tutto il team può leggerli, stamparli o esportarli. I nuovi report sono privati. Un link pubblico viene creato solo quando chiedi all'agente di chiamare set_report_sharing con public: true, e public: false lo revoca. get_report restituisce report.shareUrl quando esiste un link pubblico, oppure null quando non esiste.
Gli strumenti di Search Console e Google Analytics leggono la proprietà già collegata al progetto. L'accesso è in sola lettura.
Prima arrivano le stime per tutto ciò che è ricorrente. Rank tracking e monitoraggio AI hanno entrambi strumenti di stima, così l'agente può mostrarti il costo prima di programmare i controlli.

Cosa consuma crediti

I crediti vengono scalati dal tuo saldo zaDojo. 1.000 crediti valgono 1 €, e il piano da 10 € al mese include 10 € di utilizzo. Prezzi tipici:

Azione	Costo tipico
Ricerca keyword	circa 0,07 €
Panoramica di dominio o backlink con 12 mesi di storico	circa 0,10 €
Controllo locale su Maps o Local Finder	circa 0,006 €
Un controllo di un prompt AI su un motore	circa 0,002 €
Prompt Research per una keyword	circa 0,25 €
Monitoraggio settimanale di 100 keyword su un dispositivo	da 1 a 2 € circa al mese

Gratuiti: verifiche dell'account, contesto del progetto, keyword salvate, report, Search Console, Google Analytics, semplici audit del sito e lettura dei risultati di rank tracking, audit o visibilità AI che hai già raccolto. Agli agenti collegati a zaDojo viene chiesto di domandarti conferma prima di una serie di chiamate pianificata oltre i 2.000 crediti (circa 2 €). Quando il saldo arriva a zero, gli strumenti a pagamento si fermano finché non ricarichi. Lo stimatore è nella pagina dei prezzi.

Dopo la connessione

La connessione dà dati al tuo agente. Le skill gli dicono cosa farne, passo per passo. Se hai usato MCP senza un plugin, ora installa le skill.

Dai all'agente un compito preciso invece di chiedergli di "fare SEO":

SEO Project Setup: salva obiettivo, posizionamento, concorrenti e pagine chiave così ogni attività successiva parte da lì.
SEO Coach: ricevi un prossimo passo consigliato se sei alle prime armi con la SEO.
SEO Audit: trova le poche modifiche con più probabilità di far crescere il traffico.
Keyword Research e Keyword Clustering: trova le keyword su cui vale la pena puntare e raggruppale in pagine.
Competitive Landscape e Competitor Analysis: mappa un mercato o studia a fondo un concorrente.
Link Prospecting: trova siti che potrebbero linkare una pagina e prepara le bozze di outreach.
AI Prompt Research e AI Visibility Audit: scopri cosa dicono gli strumenti di AI sul tuo mercato e perché vengono citati i concorrenti.

La guida alla visibilità AI spiega motori, copertura e costi del monitoraggio delle risposte AI.

Risoluzione dei problemi

Il client non riesce a collegarsi. Controlla che l'indirizzo sia esattamente https://app.zadojo.com/mcp, con https:// e senza spazi finali.

Codex segnala Authorization server response missing required issuer: expected https://app.zadojo.com. Le versioni di Codex dalla 0.143 alla 0.146 perdono l'issuer durante OAuth. Aggiorna Codex CLI o l'app desktop di Codex alla 0.147.0 o successiva, oppure usa una API key.

L'accesso non riesce o continua a scadere. Rimuovi il server zaDojo dal client, aggiungilo di nuovo e ripeti l'accesso.

L'agente non trova un progetto. Chiedigli di chiamare prima list_projects e di riusare l'ID del progetto restituito nelle chiamate successive. Se non hai progetti, chiedigli di crearne uno per il tuo dominio con create_project, che è gratuito.

Uno strumento a pagamento dice che hai finito i crediti. Con il piano a pagamento, acquista una ricarica dalla sezione billing dell'app o aspetta il rinnovo mensile dei crediti. In prova, abbonati per continuare a usare gli strumenti a pagamento.

Ancora bloccato? Scrivi a hello@zadojo.com indicando nome e versione del client e l'errore esatto. Non includere mai API key.