Collegare RoyLead a Claude e Perplexity (MCP)
Gestisci RoyLead conversando con la tua AI — domini, landing, pixel, lead, campagne e creativi. Collega Claude.ai, Claude Code o Perplexity.
Aggiornata il 17 luglio 2026
RoyLead è collegabile a Claude e a Perplexity tramite MCP (Model Context Protocol): da una chat puoi chiedere all'AI di gestire il tuo account — creare domini e collegare landing page, leggere i tuoi lead, controllare il ROI delle campagne, generare creativi con l'AI e molto altro. L'assistente esegue le azioni usando i tuoi permessi, esattamente come li avresti tu dalla dashboard.
Il server MCP è lo stesso per tutti i client, cambia solo il modo in cui lo colleghi:
- Claude.ai (browser, app desktop, telefono) → login sicuro, nessuna chiave da incollare (Opzione A)
- Claude Code / Claude Desktop (sul computer) → API Key (Opzione B)
- Perplexity → API Key (Opzione C)
💡 Se colleghi più di un assistente con API Key (es. Claude Code e Perplexity), crea una chiave diversa per ognuno, con un nome riconoscibile. Costano zero e ti permettono di revocare un solo collegamento senza toccare gli altri — e dalla colonna "ultimo uso" capisci subito chi sta usando cosa.
Cosa puoi fare una volta collegato
- Domini: creare un dominio, ottenere il record TXT, verificare il DNS, gestire le impostazioni.
- Landing page: crearle, collegarle a un dominio e a un'offerta.
- Lead: leggere i tuoi lead (chi è owner/admin del team vede quelli di tutto il team, gli operatori solo i propri).
- Campagne ads: leggere account, ad set, ROI e insight di Meta.
- Creativi AI: generare immagini, sfogliare la galleria e i preset.
- Feed: leggere post e commenti della community.
- Profilo e team: leggere e aggiornare le impostazioni (nome, lingua, notifiche, impostazioni del team se sei owner/admin).
💡 Le azioni delicate restano fuori dalla chat per sicurezza: cambio password/email, 2FA, fatturazione/pagamenti, eliminazione team e rimozione membri si fanno solo dalla dashboard.
Opzione A — Claude.ai (browser, app, telefono)
Su Claude.ai il collegamento avviene con un login sicuro: nessuna chiave da incollare.
Passo 1 — Apri i Connettori
Su claude.ai vai su Impostazioni → Connettori e scegli Aggiungi connettore personalizzato dal menu Aggiungi in alto a destra.
Passo 2 — Incolla l'indirizzo di RoyLead
Come URL del server MCP inserisci:
https://api.roylead.com/api/v1/mcp
Il nome è libero (es. "RoyLead"), le impostazioni avanzate (OAuth Client ID / Secret) restano vuote. Conferma per aggiungere il connettore.
Passo 3 — Autorizza l'accesso
Claude aprirà la pagina di RoyLead: accedi con il tuo account (se non l'hai già fatto) e vedrai una schermata di consenso che ti dice quale applicazione chiede l'accesso e dove verrà reindirizzata. Controlla che l'indirizzo sia quello di Claude, poi premi Autorizza.
Fatto: il connettore risulta collegato e puoi iniziare a chiedere a Claude di operare su RoyLead.
💡 Puoi revocare l'accesso quando vuoi disconnettendo il connettore da Claude.ai. Ogni sessione autorizzata è indipendente.
Opzione B — Claude Code / Claude Desktop (sul computer)
Qui il collegamento usa una API Key dedicata, con ambito "MCP".
Passo 1 — Crea la chiave in RoyLead
Vai su Impostazioni → API e crea una nuova chiave con ambito MCP.
Dai un nome riconoscibile (es. "Claude Code portatile") e copia la chiave (rl_...). Potrai comunque rivederla in seguito con l'icona a forma di occhio.
💡 Usa una chiave con ambito MCP, non quella del plugin WordPress: sono separate apposta, così se una viene compromessa l'altra resta al sicuro.
Passo 2a — Claude Code (terminale)
In un terminale, esegui (sostituisci la chiave con la tua):
claude mcp add roylead --scope user --transport http https://api.roylead.com/api/v1/mcp --header "x-api-key: rl_LA_TUA_CHIAVE"
--scope user rende il collegamento disponibile in qualsiasi cartella. Poi riavvia Claude Code (i server MCP si caricano all'avvio) e verifica con:
claude mcp list
Deve comparire roylead come connesso.
Passo 2b — Claude Desktop
In alternativa, nella configurazione MCP di Claude Desktop aggiungi:
{
"mcpServers": {
"roylead": {
"type": "http",
"url": "https://api.roylead.com/api/v1/mcp",
"headers": { "x-api-key": "rl_LA_TUA_CHIAVE" }
}
}
}
Salva e riavvia Claude Desktop.
💡 Se un giorno vuoi togliere l'accesso, revoca la chiave da Impostazioni → API: il collegamento smette di funzionare all'istante, senza toccare le altre chiavi.
Opzione C — Perplexity
Anche Perplexity si collega con una API Key, dal suo pannello connettori.
Passo 1 — Crea la chiave in RoyLead
Vai su Impostazioni → API e crea una nuova chiave con ambito MCP, dedicata a Perplexity (es. nome "Perplexity").
Copia la chiave (rl_...).
💡 Se hai già una chiave per Claude Code, non riutilizzarla: creane una nuova. Così puoi revocare Perplexity senza scollegare Claude (e viceversa).
Passo 2 — Aggiungi il connettore su Perplexity
Su Perplexity vai su Impostazioni → Connettori e scegli Connettore personalizzato (tipo Remoto). Compila così:
- Nome: RoyLead (a piacere)
- URL del server MCP:
https://api.roylead.com/api/v1/mcp - Autenticazione: API Key → incolla la tua chiave
rl_... - Trasporto: HTTP (Streamable HTTP)
Conferma e attiva il connettore: da quel momento Perplexity opera su RoyLead con i tuoi permessi.
💡 Per scollegare Perplexity, revoca la sua chiave da Impostazioni → API: smette di funzionare all'istante.
Prova che funzioni
Apri una nuova chat con il tuo assistente e prova a chiedere:
- "Che domini ho su RoyLead?"
- "Leggimi la guida per collegare un dominio."
- "Quanti lead ho ricevuto questa settimana?"
Se risponde con i tuoi dati, il collegamento è attivo.
Risoluzione problemi
| Cosa vedi | Causa | Soluzione |
|---|---|---|
| Il connettore va in errore su Claude.ai / Perplexity | Indirizzo sbagliato | Usa esattamente https://api.roylead.com/api/v1/mcp (con api., non app.) |
claude mcp list mostra "failed" | URL o chiave errati | Controlla l'URL e che la chiave abbia ambito MCP |
| "Unexpected content type: text/html" | Hai usato app.roylead.com | L'MCP è su api.roylead.com, non sul sito |
| Perplexity non si autentica | Chiave sbagliata | Incolla la chiave rl_... completa nel campo API Key e verifica che abbia ambito MCP |
| L'assistente non vede i tool nuovi | Sessione non riavviata | Chiudi e riapri il client (Claude Code/Desktop) o ricarica la pagina |
| Un'azione viene rifiutata | Permesso mancante | Alcune azioni sono riservate a owner/admin del team, o restano solo in dashboard |
Hai bisogno di aiuto?
Se dopo aver verificato URL e chiave il collegamento non parte, contatta il supporto indicando da dove ti stai collegando (Claude.ai, Claude Code, Claude Desktop o Perplexity).
Pronto a metterlo in pratica?
Crea il tuo account RoyLead e parti in pochi minuti.