Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Conectando um assistente de IA

Conecte o assistente de IA do seu laptop, como o Claude Code, o Claude Desktop, o Cursor ou o Codex, ao seu painel rdev. Ele passa a poder responder perguntas como "algum dos meus servidores está com problemas?", "por que a última tarefa falhou?" ou "qual agente está esperando por mim?", e agir sobre um deploy ou uma sessão de agente quando você pedir.

Este é o servidor MCP do próprio painel, em https://rdev.cloud/mcp. Ele é separado do acesso MCP que os seus agentes têm no próprio servidor (veja Agentes de IA): aquele gerencia sites, bancos de dados e serviços dentro do ambiente, este mostra a sua conta em todos os seus servidores.

O que o assistente pode fazer

Ferramenta O que faz
list_servers Seus servidores com status online, versão do rdev, projetos, uso de CPU, memória e disco, e alertas (offline, reinício necessário, atualizações de segurança, disco quase cheio, serviços com falha)
server_details Os serviços de um servidor, versões de PHP e Node.js, processos, tarefas agendadas com o último código de saída e o local do armazenamento de backup
agent_sessions As sessões de agentes mais recentes e o estado delas: trabalhando, aguardando você, concluída ou parada por um erro
recent_tasks As tarefas mais recentes que o painel enviou aos seus servidores e como terminaram; pode listar somente as que falharam
deploy_requests Deploys da equipe aguardando aprovação, nas equipes que você possui ou administra
approve_deploy, reject_deploy Decidir sobre um deploy em espera, com as mesmas regras da página Equipes: somente proprietários e administradores, em até uma hora após a solicitação
stop_agent_session Parar uma sessão de agente em execução, como faz a página Sessões de agentes

O assistente vê apenas os servidores que você pode alterar no painel: os seus e, em um plano Team, o ambiente principal se você for proprietário ou administrador da equipe. Ele nunca recebe chaves de licença, valores de env, senhas de criptografia ou tokens. O assistente pergunta a você antes de aprovar, rejeitar ou parar qualquer coisa, como em qualquer ferramenta MCP que altera algo.

Crie um token

  1. Abra Configurações > Aplicativos conectados no painel.
  2. Em Conectar um assistente de IA, dê ao token um nome que você reconheça depois, por exemplo "Claude Code no meu MacBook", e escolha Criar token.
  3. Copie o comando ou a configuração exibidos abaixo dele. O token é exibido apenas uma vez; se você o perder, crie um novo.

Cada token aparece em Aplicativos conectados com a hora em que foi usado pela última vez. Desconectar o revoga na hora. Use um token por assistente e por laptop, para poder revogar um sem mexer nos outros.

Trate o token como uma senha: qualquer pessoa que o tenha pode ver os seus servidores e aprovar deploys. Mantenha-o fora dos arquivos de projeto que são commitados em um repositório.

Claude Code

Execute o comando do painel em um terminal no seu laptop:

claude mcp add --transport http --scope user rdev https://rdev.cloud/mcp --header "Authorization: Bearer <token>"

--scope user deixa o servidor disponível em todos os projetos. Verifique a conexão com claude mcp list ou /mcp dentro do Claude Code.

Cursor e outros clientes MCP

A maioria dos clientes lê o mesmo JSON. No Cursor, adicione-o ao ~/.cursor/mcp.json (todos os projetos) ou ao .cursor/mcp.json em um projeto:

{
  "mcpServers": {
    "rdev": {
      "type": "http",
      "url": "https://rdev.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

O servidor fala o transporte Streamable HTTP do MCP e autentica com o cabeçalho Authorization: Bearer, então qualquer cliente que suporte servidores remotos com cabeçalhos personalizados funciona.

Codex

Coloque o token em uma variável de ambiente, por exemplo export RDEV_MCP_TOKEN=<token> no perfil do seu shell, e adicione isto ao ~/.codex/config.toml:

[mcp_servers.rdev]
url = "https://rdev.cloud/mcp"
bearer_token_env_var = "RDEV_MCP_TOKEN"

Claude Desktop

Os conectores personalizados do Claude Desktop fazem login com OAuth, que o painel ainda não oferece. Conecte-o pela ponte mcp-remote (ela precisa do Node.js no seu laptop). Em Settings > Developer > Edit Config, adicione:

{
  "mcpServers": {
    "rdev": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://rdev.cloud/mcp", "--header", "Authorization: Bearer ${RDEV_MCP_TOKEN}"],
      "env": { "RDEV_MCP_TOKEN": "<token>" }
    }
  }
}

Depois reinicie o Claude Desktop.

Limites

Um assistente pode fazer até 120 requisições por minuto; uma pergunta geralmente usa algumas. Um token revogado ou digitado errado recebe 401 Unauthorized; crie um novo token e atualize a configuração do cliente.