서버의 모든 에이전트는 AI 에이전트가 도구를 사용하는 표준 방식인 MCP(Model Context Protocol)를 통해 rdev에 연결된 상태로 제공됩니다. 그래서 에이전트는 코드만 작성하지 않습니다. 터미널이나 패널을 열어 달라고 요청하지 않고도 코드에 필요한 것을 설정하고, 실행되는지 확인하고, 문제가 생긴 부분을 고칩니다.
왜 중요한가요
- 에이전트가 작업을 끝까지 마칩니다. 큐 작업을 작성하면 큐 워커를 추가하고, 기능에 Redis나 데이터베이스가 필요하면 설치하고 연결하며, composer가 PHP 확장을 요구하면 설치합니다. 손으로 해야 할 단계 목록이 아니라 동작하는 기능을 받게 됩니다.
- 추측이 아니라 사실에 근거해 디버깅합니다. 에이전트는 Laravel 로그의 끝부분, 마지막 오류, 워커의 출력, 앱이 보낸 메일을 읽은 뒤 원인을 고칩니다.
- 위험한 변경은 되돌릴 수 있습니다. 에이전트는 큰 변경 전에 체크포인트를 만들고 이를 복원할 수 있습니다.
- 모든 에이전트가 같은 도구를 받습니다. Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI, Cursor CLI, Antigravity CLI 모두 같은 MCP 도구와 같은 규칙을 받으므로, 아무것도 다시 설정하지 않고 에이전트를 바꿀 수 있습니다.
- 아무것도 서버 밖으로 나가지 않습니다. MCP 서버는 사용자의 환경 안에서 실행되며 에이전트와 직접 통신합니다. 코드, 로그, 데이터는 rdev.cloud로 전송되지 않습니다.
- 제어권은 사용자에게 있습니다. Claude Code는 다른 MCP 도구와 마찬가지로 도구를 처음 사용하기 전에 사용자에게 묻습니다. 라이선스가 만료되면 프로젝트나 사이트를 추가하거나 새 버전을 설치하는 도구는 거부되며, 나머지는 모두 계속 동작합니다.
에이전트가 할 수 있는 일
| 영역 | 도구 | 하는 일 |
|---|---|---|
| 프로젝트 | rdev_project_add, rdev_project_service |
프로젝트를 추가하고(빈 프로젝트, Git 저장소 또는 레시피에서) MySQL, PostgreSQL, Redis, Meilisearch, S3 스토리지 같은 서비스를 .env가 채워진 상태로 연결합니다 |
| 사이트 | create_site, link_site, list_sites, set_site_secure, add_domain, add_proxy |
.dev.test 사이트를 만들고 연결하며, HTTPS를 켜고, 도메인과 개발 서버용 프록시를 추가합니다 |
| PHP | list_php, install_php, set_site_php, set_default_php, install_php_extension, set_php_setting |
PHP 버전을 설치하고, 사이트별로 버전을 고르고, mongodb 같은 확장을 추가하고, php.ini 설정을 바꿉니다 |
| 다른 언어 | rdev_node_*, rdev_lang_*, rdev_system_install |
Node.js, Python, Ruby, Go, .NET, Java, Flutter 버전을 설치하고, 프로젝트별로 버전을 고르고, 라이브러리에 필요한 시스템 패키지를 설치합니다 |
| 데이터베이스와 서비스 | create_database, list_databases, list_services |
데이터베이스를 만들고 어떤 서비스가 실행 중인지 확인합니다 |
| 프로세스와 예약 | rdev_jobs, rdev_process, rdev_cron, rdev_job_logs |
큐 워커, Horizon, Reverb, 예약 작업을 추가, 변경, 재시작, 제거하고 그 출력을 읽습니다 |
| 로그와 메일 | rdev_app_log, list_mails, get_mail, list_dumps |
앱 로그의 끝부분이나 마지막 오류, 앱이 보낸 메일, dump() 출력을 읽습니다 |
| 오류 | rdev_errors |
로컬 오류 추적에서 프로젝트의 미해결 오류를 읽습니다 |
| 체크포인트 | rdev_checkpoint |
프로젝트의 체크포인트를 나열하고, 만들고, 복원합니다 |
| 미리보기 | rdev_preview |
요청하면 사이트를 비밀번호로 보호된 임시 미리보기로 공유합니다 |
| 상태 | rdev_backup_status, rdev_license_status, diagnose, status |
야간 백업, 라이선스, 환경을 확인합니다 |
rdev_app_log는 프로젝트 애플리케이션 로그의 끝부분을 반환하며, last_error를 쓰면 마지막 오류와 스택 트레이스만 반환합니다. Laravel에서는 바로 동작합니다(storage/logs의 최신 파일). Symfony의 var/log/dev.log, WordPress의 wp-content/debug.log(wp-config.php에서 WP_DEBUG와 WP_DEBUG_LOG를 켜세요. 파일이 없으면 도구가 방법을 알려 줍니다), Rails의 log/development.log도 읽습니다. rdev가 개발 서버를 실행하는 프로젝트(Node.js, Python, Ruby, Go, .NET, Java 등)에서는 개발 서버의 출력을 읽으며, last_error는 Python 트레이스백, JavaScript, Java, .NET, Ruby 스택 트레이스와 Go panic을 인식합니다. 명령줄에서도 같은 기능을 쓸 수 있습니다: rdev project logs <name> --app 또는 --last-error. tailnet의 브라우저에서 https://rdev-logs.dev.test가 모든 프로젝트에 대해 같은 내용을 보여 주며 새 줄이 오면 새로 고칩니다.
프로세스 및 예약 작업과 체크포인트는 각각의 페이지에서 설명합니다.
예시
평소 말로 요청하면 에이전트가 도구를 고릅니다.
- "큐를 통해 환영 이메일을 보내는 뉴스레터 가입 기능을 추가해 줘." 에이전트는 코드를 작성하고, 큐 워커를 추가하고, 테스트 가입을 보낸 뒤 캡처된 이메일을 읽습니다.
- "결제 페이지가 500을 반환해, 고쳐 줘." 에이전트는 로그의 마지막 오류를 읽고, 고친 다음 페이지를 다시 확인합니다.
- "PostgreSQL과 Redis를 쓰는 shop이라는 새 Laravel 프로젝트를 시작해 줘." 에이전트는 프로젝트, 서비스, 사이트를 추가합니다.
- "이걸 고객에게 보여 줘." 에이전트는 미리보기 링크를 만들고 주소와 비밀번호를 알려 줍니다.
설정
필요 없습니다. 설치 프로그램과 rdev agents install은 설정하는 모든 에이전트에 rdev의 MCP 서버(rdev mcp)를 등록합니다. 직접 설치한 에이전트도 사용할 수 있습니다. 해당 에이전트 설정에서 rdev mcp를 로컬(stdio) MCP 서버로 추가하고 AGENTS.md를 가리키도록 하세요.
패널의 MCP 서버
노트북의 AI 어시스턴트를 위한 두 번째 별도 MCP 서버가 https://rdev.cloud/mcp에 있습니다. 이 서버는 하나의 환경 안에서 작업하는 대신 모든 서버에 걸친 계정 현황(상태, 에이전트 세션, 실패한 작업, 승인 대기 중인 배포)을 보여 줍니다. AI 어시스턴트 연결을 참고하세요.