Guida

Collegare Claude Code e Cursor a WordPress

Claude Code e Cursor si collegano ad AlphaBridge con un token. Il plugin lo crea e mostra un comando pronto per Claude Code e una configurazione per Cursor.

Prima di iniziare

Cosa ti serve.

  • Un sito WordPress con AlphaBridge. WordPress 6.5 e PHP 8.0 o versioni successive. Per iniziare basta il plugin gratuito.
  • Un account amministratore. Crei la connessione in Impostazioni → AlphaBridge MCP.
  • Claude Code o Cursor. Claude Code si collega direttamente all'endpoint. Cursor esegue la configurazione pronta, che richiede Node.js 18 o versioni successive.
Passo dopo passo

In 6 passaggi.

Installa AlphaBridge

Aggiungi il plugin dalla bacheca di WordPress, come qualsiasi plugin, e attivalo.

Scegli il tuo client

Apri Impostazioni → AlphaBridge MCP. Sotto “Collega il tuo assistente IA”, scegli “Cursor”, oppure “Altro” per Claude Code.

Crea la connessione

Fai clic su “Crea connessione”. Sotto “Etichetta, utente, accesso, scadenza (facoltativo)” puoi darle un nome, limitarne l'accesso e impostare una scadenza. Senza modifiche ottiene l'accesso completo per te e nessuna scadenza.

Copia subito comando o configurazione

Ora il plugin mostra il Bearer token, il “Comando per Claude Code” e la “Configurazione per Cursor”. Le versioni meno recenti mostrano un'unica configurazione per entrambi. Copia subito ciò che serve al tuo client: il token viene mostrato per intero una sola volta.

Aggiungilo al tuo client

Claude Code: nella cartella del tuo progetto, esegui il “Comando per Claude Code” del plugin. Contiene già endpoint e token. Se il plugin non mostra ancora questo comando, esegui il comando claude mcp add qui sotto con il tuo endpoint e il tuo token. Cursor: incolla la configurazione in ~/.cursor/mcp.json per tutti i progetti, salva e ricarica i server. Se il file elenca già dei server, aggiungi solo la voce alphabridge dentro mcpServers.

Verifica e chiedi

In Claude Code, /mcp mostra lo stato del server. Poi fai una prima domanda, ad esempio quali pagine sono ancora in bozza. Le modifiche aspettano che un amministratore attivi l'accesso in scrittura.

Configurazione

Un comando per Claude Code, una configurazione per Cursor

Il plugin li mostra entrambi, con endpoint e token già inseriti.

Per Claude Code, il plugin mostra questo comando con il tuo endpoint e il tuo token. Se il tuo plugin non lo mostra ancora, inserisci tu l'Endpoint URL e il Bearer token.

claude mcp add --transport http alphabridge https://your-site.tld/wp-json/alphabridge/v1/mcp --header "Authorization: Bearer YOUR-TOKEN"

Claude Code parla poi direttamente con il tuo endpoint via HTTP, senza Node.js.

Per Cursor, il plugin mostra una configurazione pronta. Ha questo aspetto.

{
  "mcpServers": {
    "alphabridge": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-site.tld/wp-json/alphabridge/v1/mcp", "--header", "Authorization:${AUTH}"],
      "env": { "AUTH": "Bearer YOUR-TOKEN" }
    }
  }
}

In Cursor, npx avvia l'helper mcp-remote, che invia ogni richiesta al tuo endpoint con il tuo token nell'header Authorization.

Lascia Authorization:${AUTH} com'è. Il token si trova nella riga env, dopo la parola Bearer.

Per un secondo sito, crea una connessione anche lì. Aggiungila con un altro nome, ad esempio alphabridge-shop.

Token

Custodisci il token

  • Il token viene mostrato per intero una sola volta. Il sito ne conserva solo un hash.
  • L'hai perso? Rigenera la connessione sotto “Le tue connessioni”. Il vecchio token smette subito di funzionare.
  • Scegli il livello di accesso “sola lettura” o “solo contenuti” quando un client non deve poter fare tutto.
  • Imposta una scadenza in giorni per gli accessi che devono terminare.
  • Claude Code conserva un server aggiunto con claude mcp add in ~/.claude.json, per questo progetto e solo per te.
  • Ogni richiesta viene eseguita con i permessi dell'utente WordPress per cui agisce la connessione.
  • L'accesso in scrittura vale per ogni connessione sul sito, compresa questa. Da quel momento le modifiche hanno effetto immediato e possono essere distruttive. L'attivazione è a rischio del titolare.
Prompt

Cosa chiedere in Claude Code o Cursor

Gli strumenti gratuiti coprono i contenuti. Pro e Agency aggiungono codice e deploy.

  • Elenca le pagine del mio sito con stato e ultima modifica.
  • Leggi la struttura della home page ed elencane titoli e pulsanti.
  • Quali plugin e temi hanno aggiornamenti in attesa?
  • Crea una bozza di articolo dagli appunti in notes.md.
  • Mostrami style.css del tema attivo.
  • Pubblica la cartella build sul sito via SFTP.

I primi tre si limitano a leggere. Il quarto richiede l'accesso in scrittura. Il quinto richiede Pro e l'accesso in scrittura. L'ultimo richiede Agency, Site Deploy configurato e l'accesso in scrittura.

Altri client

Altri client MCP e script

Qualsiasi client MCP che parli Streamable HTTP e possa inviare un header può usare direttamente l'endpoint. Invia il token con ogni richiesta come Authorization: Bearer ….

Se un client elimina l'header Authorization, invia invece il token come X-Api-Key.

Claude sul web, in Desktop e su iOS si collega senza token. Approvi invece sul tuo sito, come mostra la pagina del connettore.

FAQ

Domande e risposte.

Claude Code e Cursor hanno bisogno di un token?

Sì. Il plugin ne crea uno per loro nella sua pagina delle impostazioni, insieme al comando per Claude Code e alla configurazione per Cursor. Claude sul web e ChatGPT approvano invece sul tuo sito.

Quale livello di accesso dovrei scegliere?

Con “sola lettura”, il client vede ciò che l'account può vedere e non modifica nulla. Con “solo contenuti”, modifica anche articoli, pagine, media, termini e commenti. Il livello “completo” aggiunge impostazioni e amministrazione. Qualunque livello tu scelga, è l'interruttore per l'accesso in scrittura del sito a decidere se viene scritto qualcosa.

Ho perso il token. E ora?

Rigenera la connessione sotto “Le tue connessioni” nella pagina delle impostazioni di AlphaBridge MCP. Ricevi un nuovo token con un nuovo comando e una nuova configurazione. Il vecchio token smette subito di funzionare.

Claude Code mostra ancora il vecchio elenco di strumenti. Cosa aiuta?

I client possono mantenere l'elenco di strumenti che hanno caricato. In Claude Code, esegui /mcp e ricollega il server.

Mi serve Pro per Claude Code?

No. Il plugin gratuito dà a Claude Code 40 strumenti. Pro porta 135 strumenti su un sito, file dei temi e dei plugin compresi. Agency porta tutti i 143 strumenti e Site Deploy via SFTP su un massimo di 10 siti.

Pro sul tuo sito WordPress. Con un modo per tornare indietro.

Pro porta 135 strumenti sul tuo sito e un modo per tornare indietro per pagine e file. La prova non richiede carta di credito.