Server MCP di Semurai: collega Claude e ChatGPT

MCP (Model Context Protocol) è lo standard aperto con cui gli assistenti AI si collegano ad altre app. Aggiungi un indirizzo nel tuo assistente, approvi la connessione una volta e da quel momento chiedi lavoro SEO e sui contenuti direttamente nella chat che usi già. Una panoramica di cosa ti offre è nella pagina Server MCP di Semurai.

Cosa puoi fare

Scrivi con parole tue. L’assistente sceglie le azioni giuste in Semurai, lavora nel tuo spazio di lavoro e ti dice cosa ha fatto. Qualche esempio per ogni area:

Ricerca SEO

Ricerca delle parole chiave e parole chiave correlate, analisi della concorrenza e gap di parole chiave, chi si posiziona per una query, panoramica di un dominio, controllo delle posizioni in tempo reale e cluster tematici. Approfondisci in Ricerca delle parole chiave.

Trova parole chiave long tail sul caffè cold brew con bassa difficoltà.
Per quali parole chiave si posizionano i miei concorrenti e noi no?
Crea un cluster tematico sull’espresso fatto in casa.

Posizionamento e Search Console

Parole chiave monitorate e storico delle loro posizioni, nuove parole chiave da monitorare, report di Google Search Console (panoramica, query principali, pagine principali, andamento delle query e opportunità), audit delle pagine, audit completi del sito e report sulle prestazioni.

Come si sono mosse le nostre parole chiave monitorate questo mese?
Mostrami le query di Search Console con molte impressioni e un CTR basso.
Fai un audit SEO completo del nostro sito ed elenca le correzioni più importanti.

Contenuti

Cerca e leggi articoli e documenti, crea scalette, scrivi articoli SEO con segnaposto per le immagini, aggiorna i contenuti, crea documenti e bozze di email, pianifica contenuti e campagne, trova ricorrenze di marketing e ottieni suggerimenti di link interni.

Scrivi un articolo SEO su come scegliere un macinacaffè, basato sulla nostra ricerca delle parole chiave.
Pianifica un mese di contenuti per il blog del nostro negozio.
Suggerisci link interni per l’articolo sulle macchine per espresso.

Bozze di post social (testo), l’elenco dei tuoi post, il calendario editoriale e la programmazione di contenuti e post social.

Scrivi tre post LinkedIn che promuovano il nostro articolo più recente.
Cosa c’è in programma nel calendario editoriale la prossima settimana?
Programma il post LinkedIn sulla miscela autunnale per venerdì alle 9:00.

Pubblicazione

Pubblica articoli su WordPress, PrestaShop o sul blog Shoper. Su WordPress l’assistente può anche esaminare gli articoli e preparare, applicare o scartare modifiche SEO.

Pubblica l’articolo sui macinacaffè sul nostro blog Shoper.
Controlla la SEO dei nostri cinque articoli WordPress più recenti e prepara le correzioni.

E-commerce

Lavora con i tuoi negozi Shoper, WooCommerce e PrestaShop collegati: cerca prodotti e categorie, prepara proposte SEO per prodotti, categorie e testi alternativi delle immagini, applica le proposte che approvi e importa i prodotti Shoper. Approfondisci in Negozio.

Trova i prodotti senza meta description e prepara proposte SEO.
Scrivi i testi alternativi per le immagini della categoria Macinacaffè.
Applica al negozio le proposte approvate.

Media e attività

Cerca nella libreria media, aggiungi media da un URL, aggiorna i loro dettagli e organizza le cartelle. Elenca, crea e aggiorna attività e assegna un’attività a uno degli agenti Semurai.

Sposta le foto prodotto della settimana scorsa in una cartella Campagna di primavera.
Crea un’attività per aggiornare l’articolo sui prezzi e assegnala a Tenko.

Collega il tuo assistente

Tutti gli assistenti usano lo stesso indirizzo del server. Copialo e segui i passaggi per il tuo assistente. Lo stesso indirizzo e istruzioni brevi si trovano nell’app Semurai, in Impostazioni → Assistenti AI (MCP).

https://api.semur.ai/mcp

Claude (web e app desktop)

In Claude, apri Customize → Connectors.
Fai clic su + Add e scegli Add custom connector.
Inserisci un nome, ad esempio Semurai, incolla l’indirizzo del server e fai clic su Continue, poi su Add.
Fai clic su Connect e approva la connessione nella pagina di Semurai.

Nei piani Claude Team ed Enterprise, un Owner dell’organizzazione aggiunge il connettore una sola volta in Organization settings → Connectors → Add → Custom → Web. I membri poi fanno clic su Connect e accedono con il proprio account Semurai. Con il piano Free puoi aggiungere un connettore personalizzato. Cosa può fare Claude con Semurai, con prompt di esempio: Claude per la SEO.

ChatGPT

In ChatGPT sul web, apri Plugins e fai clic su +.
Scegli Add custom MCP server, inserisci un nome e incolla l’indirizzo del server.
Come autenticazione scegli OAuth, spunta I understand and want to continue e fai clic su Create.
Approva la connessione nella pagina di Semurai.

Azioni complete (scrittura) in ChatGPT: piani Business, Enterprise ed Edu. Con Pro, i server MCP personalizzati si collegano in sola lettura. I server MCP personalizzati si aggiungono in ChatGPT sul web. Casi d’uso e prompt da provare in ChatGPT per la SEO.

Claude Code

Esegui questo comando nel terminale:

claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp

L’opzione --scope user aggiunge Semurai a tutti i tuoi progetti. Poi accedi a Semurai con claude mcp login semurai oppure digita /mcp in Claude Code. Lavoro SEO dal terminale, con esempi: Claude Code per la SEO.

Codex

Esegui questo comando nel terminale:

codex mcp add semurai --url https://api.semur.ai/mcp

Poi accedi a Semurai con codex mcp login semurai. Puoi anche aggiungere il server in ~/.codex/config.toml:

config.toml

[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

L’estensione Codex per IDE e l’app desktop di Codex usano la stessa configurazione. Puoi aggiungere il server anche lì in Settings → MCP servers → Add server, con il tipo Streamable HTTP. Per saperne di più su Semurai in Codex: Codex MCP.

Cursor

Aggiungi il server a ~/.cursor/mcp.json per usarlo in tutti i progetti, oppure a .cursor/mcp.json in un singolo progetto:

mcp.json

{
  "mcpServers": {
    "semurai": {
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Accedi a Semurai quando Cursor te lo chiede. Cosa puoi chiedere in Cursor: Cursor MCP.

VS Code (GitHub Copilot)

In modalità agente, GitHub Copilot usa i server di .vscode/mcp.json nel tuo progetto:

.vscode/mcp.json

{
  "servers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Fai clic su Start sopra il server nel file e accedi a Semurai. Esempi per Copilot in modalità agente: VS Code MCP.

Altri assistenti

Ogni assistente che supporta server MCP remoti con accesso OAuth si collega allo stesso modo: aggiungi https://api.semur.ai/mcp come indirizzo del server.

Gemini CLI: aggiungi il server con questo comando, poi accedi con /mcp auth semurai in Gemini CLI.

gemini mcp add --transport http semurai https://api.semur.ai/mcp

Nel file settings.json di Gemini CLI, l’indirizzo va nella chiave httpUrl:

settings.json

{
  "mcpServers": {
    "semurai": {
      "httpUrl": "https://api.semur.ai/mcp"
    }
  }
}

Server completo con grafiche AI

L’indirizzo qui sopra è il server ufficiale, quello per le directory di app di Claude e ChatGPT e per il lavoro di tutti i giorni. Semurai ha anche un server completo: stesso accesso e stessi strumenti, in più le grafiche AI. Lo aggiungi tu come connettore personalizzato, con questo indirizzo:

https://api.semur.ai/mcp/full

Con il server completo, il tuo assistente può anche:

creare immagini per post social e articoli,
creare design in Canvas,
creare design in Creative Studio,
lavorare sui tuoi design di Creative Studio: scegliere la modalità, rispondere alle domande del designer, rivedere un design e tornare a una versione precedente o a una variante,
salvare grafiche social, caroselli e annunci di Creative Studio nella libreria media e aggiungerli ai post social,
proporre idee di design per il tuo brand,
scrivere descrizioni AI e testi alternativi per le immagini della tua libreria media.

Aggiungere il server completo

Claude: in Customize → Connectors, fai clic su + Add, scegli Add custom connector e incolla l’indirizzo del server completo.
ChatGPT: in Plugins, fai clic su +, scegli Add custom MCP server e incolla l’indirizzo del server completo.
Cursor e VS Code: usa lo stesso mcp.json di sopra, con l’indirizzo del server completo.

In Claude Code, esegui:

claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full

In Codex, esegui:

codex mcp add semurai-full --url https://api.semur.ai/mcp/full

Una connessione approvata per il server ufficiale funziona con il server ufficiale. Per usare il server completo, aggiungilo come connettore separato e approva la connessione nella pagina di Semurai. In Claude Code e Codex, accedi con claude mcp login semurai-full o codex mcp login semurai-full. Le grafiche create con il server completo vengono conteggiate nei limiti di utilizzo dello spazio di lavoro, come quelle create nell’app.

Prima connessione e spazi di lavoro

Alla prima connessione l’assistente apre una pagina di Semurai. Accedi, se non l’hai già fatto, e poi:

Controlla il nome dell’app e l’indirizzo a cui torna il browser. Entrambi sono indicati nella pagina.
Scegli lo Spazio di lavoro predefinito.
Fai clic su Consenti. Il browser ti riporta all’assistente, pronto a lavorare.

L’assistente lavora nello spazio di lavoro predefinito. Se glielo chiedi, elenca gli altri tuoi spazi di lavoro, lavora in uno qualsiasi di essi e cambia quello predefinito, per esempio: Quali spazi di lavoro ho? Passa allo spazio di lavoro del negozio.

I lavori più lunghi vengono eseguiti in background: la stesura di un articolo, un audit completo del sito, un piano dei contenuti, post social o un cluster tematico. L’assistente segue l’avanzamento e ti porta il risultato quando è pronto. Le bozze compaiono nell’app Semurai: nella Libreria, nel calendario editoriale e tra i tuoi post social.

Gestire e scollegare

Nell’app Semurai apri Impostazioni → Assistenti AI (MCP). Lì trovi:

i due indirizzi del server (ufficiale e completo) con i pulsanti per copiarli e istruzioni brevi per ogni assistente,
le app collegate, con la data di collegamento e l’ultimo utilizzo di ciascuna,
lo spazio di lavoro predefinito di ogni app, che puoi cambiare in qualsiasi momento,
Scollega, che chiude subito l’accesso dell’app.

Per usare di nuovo un assistente scollegato, collegalo di nuovo dall’assistente.

Sicurezza e limiti di utilizzo

Confermi tu ciò che esce da Semurai. Pubblicare o programmare fuori da Semurai (WordPress, il blog PrestaShop o Shoper, i social network) e applicare modifiche a un negozio o a un sito WordPress sono azioni separate, e l’assistente ti chiede di confermarle una per una.
Le modifiche al negozio partono come proposte. Le modifiche SEO a prodotti, categorie e immagini nascono prima come proposte, e nel negozio arrivano solo quelle che approvi.
Vale il tuo ruolo. L’assistente lavora con il tuo ruolo in ogni spazio di lavoro. Con il ruolo Visualizzatore può solo leggere le informazioni di base dello spazio di lavoro.
Gli stessi limiti di utilizzo. Le azioni di un assistente contano negli stessi limiti di utilizzo del tuo lavoro nell’app.

Risoluzione dei problemi

Il link di connessione è scaduto: la pagina di approvazione è valida per 10 minuti. Avvia di nuovo la connessione dall’assistente.
L’assistente dice di aver perso l’accesso: collegalo di nuovo. In Impostazioni → Assistenti AI (MCP) puoi verificare se l’app è stata scollegata.
Il limite di utilizzo è esaurito: attendi che si rinnovi e poi chiedi di nuovo.
Uno strumento dice che un’integrazione non è collegata: collega Google Search Console, WordPress o il tuo negozio in Impostazioni → Integrazioni e poi chiedi di nuovo. Vedi Collega il tuo sito o negozio online.

Prossimi passi

IntegrazioniCollega Search Console, WordPress e il tuo negozio.
LibreriaRivedi le bozze create dal tuo assistente.
Calendario editorialeArticoli e post programmati in un unico posto.
Agenti AIScopri gli agenti Semurai e il lavoro di cui si occupano.
Server MCP di SemuraiCosa può fare ogni assistente con Semurai, con prompt di esempio.