문서의 모든 페이지를 검색하려면 두 글자 이상 입력하세요.

↑ ↓ 이동 ↵ 열기 esc 닫기

rdev 사용하기

AI 어시스턴트 연결

Claude Code, Claude Desktop, Cursor, Codex 같은 노트북의 AI 어시스턴트를 rdev 패널에 연결하세요. 그러면 "내 서버 중에 문제가 있는 서버가 있나요?", "마지막 작업은 왜 실패했나요?", "어떤 에이전트가 나를 기다리고 있나요?" 같은 질문에 답할 수 있고, 요청하면 배포나 에이전트 세션에 대한 조치도 취할 수 있습니다.

이것은 https://rdev.cloud/mcp에 있는 패널 자체의 MCP 서버입니다. 서버에서 에이전트가 갖는 MCP 접근(AI 에이전트 참고)과는 별개입니다. 그쪽은 환경 안의 사이트, 데이터베이스, 서비스를 관리하고, 이쪽은 모든 서버에 걸친 계정 정보를 보여줍니다.

어시스턴트가 할 수 있는 일

도구 기능
list_servers 온라인 상태, rdev 버전, 프로젝트, CPU, 메모리, 디스크 사용량, 알림(오프라인, 재시작 필요, 보안 업데이트, 디스크 부족, 실패한 서비스)이 포함된 서버 목록
server_details 한 서버의 서비스, PHP 및 Node.js 버전, 프로세스, 마지막 종료 코드가 포함된 예약 작업, 백업 스토리지 위치
agent_sessions 최근 에이전트 세션과 상태: 작업 중, 사용자 응답 대기 중, 완료 또는 오류로 중단됨
recent_tasks 패널이 서버로 보낸 최근 작업과 결과. 실패한 작업만 나열할 수도 있습니다
deploy_requests 소유하거나 관리하는 팀에서 승인을 기다리는 팀 배포
approve_deploy, reject_deploy 대기 중인 배포를 승인 또는 거부합니다. 팀 페이지와 같은 규칙이 적용됩니다: 소유자와 관리자만 가능하며 요청 후 1시간 이내여야 합니다
stop_agent_session 에이전트 세션 페이지와 마찬가지로 실행 중인 에이전트 세션을 중지합니다

어시스턴트는 패널에서 변경할 수 있는 서버만 볼 수 있습니다. 사용자 본인의 서버와, Team 요금제에서 팀을 소유하거나 관리하는 경우 메인 환경입니다. 라이선스 키, 환경 변수 값, 암호화 비밀번호, 토큰은 절대 제공되지 않습니다. 어시스턴트는 무언가를 변경하는 다른 MCP 도구와 마찬가지로 승인, 거부, 중지 전에 사용자에게 확인합니다.

토큰 만들기

  1. 패널에서 설정 > 연결된 앱을 여세요.
  2. AI 어시스턴트 연결에서 나중에 알아볼 수 있는 이름(예: "내 MacBook의 Claude Code")을 토큰에 지정하고 토큰 만들기를 선택하세요.
  3. 그 아래에 표시된 명령어나 설정을 복사하세요. 토큰은 한 번만 표시됩니다. 잃어버리면 새로 만드세요.

각 토큰은 마지막 사용 시각과 함께 연결된 앱에 나열됩니다. 연결 해제는 즉시 토큰을 폐기합니다. 다른 토큰에 영향을 주지 않고 하나만 폐기할 수 있도록 어시스턴트와 노트북마다 토큰을 하나씩 사용하세요.

토큰은 비밀번호처럼 다루세요. 토큰을 가진 사람은 누구나 서버를 보고 배포를 승인할 수 있습니다. 저장소에 커밋되는 프로젝트 파일에는 넣지 마세요.

Claude Code

노트북의 터미널에서 패널에 표시된 명령어를 실행하세요.

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

--scope user는 모든 프로젝트에서 서버를 사용할 수 있게 합니다. claude mcp list 또는 Claude Code 안의 /mcp로 연결을 확인하세요.

Cursor 및 기타 MCP 클라이언트

대부분의 클라이언트는 같은 JSON을 읽습니다. Cursor에서는 ~/.cursor/mcp.json(모든 프로젝트) 또는 프로젝트의 .cursor/mcp.json에 추가하세요.

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

서버는 MCP의 Streamable HTTP 전송을 사용하며 Authorization: Bearer 헤더로 인증하므로, 사용자 지정 헤더가 있는 원격 서버를 지원하는 모든 클라이언트에서 동작합니다.

Codex

토큰을 환경 변수에 넣고(예: 셸 프로필에 export RDEV_MCP_TOKEN=<token>), ~/.codex/config.toml에 다음을 추가하세요.

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

Claude Desktop

Claude Desktop의 사용자 지정 커넥터는 OAuth로 로그인하는데, 패널은 아직 이를 제공하지 않습니다. 대신 mcp-remote 브리지를 통해 연결하세요(노트북에 Node.js가 필요합니다). Settings > Developer > Edit Config에서 다음을 추가하세요.

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

그런 다음 Claude Desktop을 재시작하세요.

제한

어시스턴트는 분당 최대 120건의 요청을 보낼 수 있으며, 질문 하나에는 보통 몇 건이 사용됩니다. 폐기되었거나 잘못 입력한 토큰은 401 Unauthorized를 받습니다. 새 토큰을 만들고 클라이언트 설정을 업데이트하세요.