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
- Abra Configurações > Aplicativos conectados no painel.
- 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.
- 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.