Collega l'assistente AI sul tuo laptop, come Claude Code, Claude Desktop, Cursor o Codex, al tuo pannello rdev. Potrà così rispondere a domande come "qualcuno dei miei server ha problemi?", "perché è fallita l'ultima attività?" o "quale agente mi sta aspettando?", e agire su un deploy o su una sessione di un agente quando glielo chiedi.
È il server MCP del pannello stesso su https://rdev.cloud/mcp. È separato dall'accesso MCP che i tuoi agenti hanno sul server stesso (vedi Agenti AI): quello gestisce siti, database e servizi all'interno dell'ambiente, questo mostra il tuo account su tutti i tuoi server.
Cosa può fare l'assistente
| Strumento | Cosa fa |
|---|---|
list_servers |
I tuoi server con stato online, versione di rdev, progetti, uso di CPU, memoria e disco, e avvisi (offline, riavvio necessario, aggiornamenti di sicurezza, disco quasi pieno, servizi non riusciti) |
server_details |
I servizi di un server, le versioni di PHP e Node.js, i processi, le attività pianificate con il loro ultimo codice di uscita, e la posizione dell'archiviazione dei backup |
agent_sessions |
Le ultime sessioni degli agenti e il loro stato: al lavoro, in attesa di te, terminata o fermata da un errore |
recent_tasks |
Le ultime attività che il pannello ha inviato ai tuoi server e come sono finite; può elencare solo quelle fallite |
deploy_requests |
I deploy del team in attesa di approvazione, nei team che possiedi o amministri |
approve_deploy, reject_deploy |
Decidi su un deploy in attesa, con le stesse regole della pagina Team: solo proprietari e amministratori, entro un'ora dalla richiesta |
stop_agent_session |
Ferma una sessione di un agente in esecuzione, come fa la pagina Sessioni degli agenti |
L'assistente vede solo i server che puoi modificare nel pannello: i tuoi, e in un piano Team l'ambiente principale se possiedi o amministri il team. Non riceve mai chiavi di licenza, valori env, password di cifratura o token. L'assistente ti chiede conferma prima di approvare, rifiutare o fermare qualcosa, come per qualsiasi strumento MCP che modifica qualcosa.
Crea un token
- Apri Impostazioni > App collegate nel pannello.
- In Collega un assistente AI, dai al token un nome che riconoscerai in seguito, ad esempio "Claude Code sul mio MacBook", e scegli Crea token.
- Copia il comando o la configurazione mostrati sotto. Il token viene mostrato una sola volta; se lo perdi, creane uno nuovo.
Ogni token è elencato in App collegate con l'ora dell'ultimo utilizzo. Scollega lo revoca subito. Usa un token per ogni assistente e laptop, così puoi revocarne uno senza toccare gli altri.
Tratta il token come una password: chiunque lo abbia può vedere i tuoi server e approvare i deploy. Tienilo fuori dai file di progetto di cui viene fatto il commit in un repository.
Claude Code
Esegui il comando del pannello in un terminale sul tuo laptop:
claude mcp add --transport http --scope user rdev https://rdev.cloud/mcp --header "Authorization: Bearer <token>"
--scope user rende il server disponibile in ogni progetto. Verifica la connessione con claude mcp list o /mcp dentro Claude Code.
Cursor e altri client MCP
La maggior parte dei client legge lo stesso JSON. In Cursor, aggiungilo a ~/.cursor/mcp.json (tutti i progetti) o a .cursor/mcp.json in un progetto:
{
"mcpServers": {
"rdev": {
"type": "http",
"url": "https://rdev.cloud/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
Il server parla il trasporto Streamable HTTP di MCP e si autentica con l'header Authorization: Bearer, quindi funziona qualsiasi client che supporti server remoti con header personalizzati.
Codex
Metti il token in una variabile d'ambiente, ad esempio export RDEV_MCP_TOKEN=<token> nel profilo della tua shell, e aggiungi questo a ~/.codex/config.toml:
[mcp_servers.rdev]
url = "https://rdev.cloud/mcp"
bearer_token_env_var = "RDEV_MCP_TOKEN"
Claude Desktop
I connettori personalizzati di Claude Desktop accedono con OAuth, che il pannello non offre ancora. Collegalo invece tramite il bridge mcp-remote (richiede Node.js sul tuo laptop). In Settings > Developer > Edit Config, aggiungi:
{
"mcpServers": {
"rdev": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://rdev.cloud/mcp", "--header", "Authorization: Bearer ${RDEV_MCP_TOKEN}"],
"env": { "RDEV_MCP_TOKEN": "<token>" }
}
}
}
Poi riavvia Claude Desktop.
Limiti
Un assistente può fare fino a 120 richieste al minuto; una domanda di solito ne richiede poche. Un token revocato o digitato male riceve 401 Unauthorized; crea un nuovo token e aggiorna la configurazione del client.