Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Collegare un assistente AI

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

  1. Apri Impostazioni > App collegate nel pannello.
  2. 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.
  3. 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.