AgentDock logo
AI 에이전트에게 운영하는 모든 장치에 대한 안전하고 통제된 접근 권한을 제공하세요.
브라우저에서 ChatGPT를 열고 하나의 대화창에서 여러 컴퓨터와 서버를 관리할 수 있습니다. 코드를 작성하고, 구성을 변경하고, 명령어를 실행하며, 작업이 속해야 할 실제 환경에 배포할 수 있으며, 전용 Codex 코딩 쿼터를 소모하지 않습니다.
AgentDock은 AI 에이전트를 위한 독립적인 도구 런타임입니다.
로컬 컴퓨터, 원격 서버, 컨테이너 전반에 걸쳐 파일, 명령어, Git, Skill, MCP, 브라우저 자동화 및 작업 실행을 통합적이고 안전하며 통제된 방식으로 제공합니다. 여러 AgentDock 인스턴스를 연결하여 장치 간의 작업을 조정하고 단일 대화에서 다중 기기 워크플로우를 완료할 수 있습니다.
AgentDock은 채팅 인터페이스를 제공하거나 모델 추론(model inference)을 수행하지 않습니다. 오직 하나의 책임에 초점을 맞춥니다:
AI 에이전트가 명시적인 권한 경계 내에서 실제 환경을 작동시키고, 구조화되고 추적 가능하며 검증 가능한 결과를 반환하도록 하는 것입니다.
ChatGPT / Claude / Codex
│
│ MCP (여러 인스턴스 지원)
...
- SSH 세션을 반복적으로 전환할 필요 없이 ChatGPT에서 여러 컴퓨터와 서버를 직접 관리합니다.
- 전용 코딩 에이전트 쿼터에 의존하지 않고 실제 로컬 또는 원격 환경에서 코드 작성, 프로젝트 수정, 테스트 실행 및 Git 작업을 수행합니다.
- VPS 호스트, Docker 서비스, 리버스 프록시 및 배포 구성을 관리합니다.
- 로그, 프로세스, 포트 및 실제 런타임 상태를 검사합니다.
- 인증된 웹 페이지와 macOS 데스크톱 애플리케이션을 작동시킵니다.
- 여러 AgentDock 인스턴스를 연결하여 하나의 대화에서 장치 간 작업을 조정합니다.
- Skill과 동적 MCP 서버를 통해 기능을 확장합니다.
- 장기 실행 작업 상태를 유지하고 중단 후에도 계속 진행할 수 있습니다.
- macOS, Linux, Windows 및 컨테이너 전반에 걸쳐 동일한 도구 모델을 사용합니다.
- 그리고 더 많은 기능들이 있습니다.
일반 사용자는 공식 패키지를 통해 자신의 운영체제에서 AgentDock을 설치할 수 있습니다. 소스 코드나 Go 언어 지식이 필요하지 않습니다.
전체 지침은 Install AgentDock을 참조하세요.
| 플랫폼 | 문서화 |
|---|
| Docker | Docker 설치 |
| ... | |
| 로컬 전용: 클라이언트와 AgentDock이 동일한 컴퓨터에서 실행됩니다. 임시 공개 주소: ChatGPT, 휴대폰 또는 다른 원격 장치가 접근해야 하고 도메인이 준비되지 않은 경우입니다. 터널이 재시작되면 주소가 변경될 수 있습니다. 고정 도메인: 장기 사용을 위한 안정적인 주소입니다. Cloudflare에서 관리하는 도메인과 Tunnel Token이 필요합니다. | |
설치 후, 제어판 또는 터미널에서 MCP URL 및 Bearer Token 또는 OAuth 로그인 세부 정보를 얻은 다음, 이를 클라이언트의 MCP, Tools 또는 Connectors 설정에 추가해야 합니다. 공개 접근 시에는 인증을 활성화 상태로 유지해야 합니다. 자격 증명(credentials)을 스크린샷, 이슈 또는 공개 대화에 포함하지 마십시오.
AgentDock은 MCP Streamable HTTP를 통해 도구를 노출합니다. 정확한 클라이언트 구문은 다르지만, 일반적인 구성은 다음과 같습니다:
{
"mcpServers": {
"agentdock": {
...
- UTF-8 텍스트 읽기 및 검색, 디렉터리 순회 및 구조화된 편집 적용
- 원자적 파일 쓰기(Atomic file writes), 경로 경계 및 개인 디렉터리 보호
- 타임아웃 및 출력 제한이 있는 명령어 실행
- 별도의 stdout, stderr 및 종료 상태
- 장시간 실행되는 명령어 세션, PTY, 관찰(observation), 입력 및 종료
- 출력 자르기(Output truncation) 및 민감 값 마스킹(sensitive-value redaction)
- macOS, Linux, Windows 및 WSL 지원
공식 및 커뮤니티 Skill 소스는 uvwt/agentdock-skills에 있습니다. 이 저장소는 부트스트랩/보안 Skill과 내장된 agentdock-user-guide를 포함하여 AgentDock 런타임과 함께 제공되어야 하는 핵심 Skill만 유지합니다.
공식 사용자 가이드:
- Digest 기반의 No-op 및 원자적 교체를 통해 현재 관리되는 Skill 콘텐츠 설치, 업데이트 및 제거
- 호스트가 발행하는
skill_ref를 통해 관리되는 공유 및 작업 공간 Skill 소스를 분리 유지
출처(provenance) - 패키지 콘텐츠로부터 관리되는 Skill 환경 변수와 영구 데이터를 격리
- 동적 MCP 서버 등록, 활성화, 비활성화, 새로고침 및 제거
- 스트리밍 가능한 HTTP 및 stdio 전송
- 도구 검색, 스키마 검사 및 제어된 호출 수행
- MCP 서버 간 구성 격리
AgentDock은 선택적으로 네이티브 ACP 클라이언트 역할을 할 수 있으며 로컬 코딩 에이전트 어댑터를 호스팅합니다.
-
데스크톱 제어판은 Codex, Claude, Grok에 대한 프리셋을 제공하며, 호스트 구성은 ACP 활성화 여부와 어떤 어댑터가 선택되었는지 제어합니다.
-
세션을 생성하고 관리하는 acp_session, 프롬프트를 실행하고 관찰하는 acp_prompt, 에이전트 권한 요청에 응답하는 acp_interaction을 사용합니다. - 선택적 ACP 작업은 연결된 어댑터가 해당 기능을 광고할 때만 사용할 수 있습니다.
-
ACP 작업 디렉토리는 AgentDock 파일 시스템 허용 목록보다는 호스트 프로세스 또는 컨테이너 보안 경계를 따릅니다.
-
브라우저 세션 시작, 종료 및 정리
-
탐색, 클릭, 입력, 선택 및 대기
-
페이지 텍스트, 상호 작용 요소, 오류 및 네트워크 응답 검사
-
로그인 상태 유지, 전용 브라우저 프로필 사용 및 스크린샷 캡처
-
시스템 Chrome 및 macOS 데스크톱 자동화 사용
-
작업 상태 유지
-
명시적인 목표, 단계 및 완료 조건 정의
-
스테이지별 체크포인트 기록
-
차단 요소 추적 및 중단 후 재개
-
최종 검토 및 증거 기반 완료 확인 수행
-
워크플로우 템플릿 재사용
AgentDock은 NexusDock과 다중 장치 집계 진입점(multi-device aggregation entrypoint)으로 선택적으로 페어링될 수 있습니다:
- 장기 프로젝트 메모리
- 실행 매뉴얼 및 경험 기록
- 워크플로우 템플릿
- 개인 노트
- 다중 장치 상태 조정
- 소스 노드가 온라인일 때 NexusDock에 의해 프록시되는 임시 서명된 아티팩트 다운로드
| 경로 | 목적 |
|---|
~/AgentDock | 상대 파일 작업을 위한 기본 작업 디렉토리 |
~/.agentdock | AgentDock 상태, 구성, 세션 및 확장 데이터 |
Docker, 네이티브 설치 및 로컬 개발을 위한 기본 MCP URL:
http://127.0.0.1:8765/mcp
포트는 설정 가능합니다. 클라이언트는 실제 배포에서 정의된 주소를 사용해야 합니다.
공개 배포의 경우, Bearer Token 또는 OAuth 인증을 활성화하고 HTTPS를 사용하십시오. 인증되지 않은 MCP 서비스를 공용 인터넷에 절대 노출하지 마십시오.
코드 제출 전에 전체 검사를 실행하십시오:
make check
GitHub Actions는 테스트, 정적 검사, 빌드 및 릴리스 유효성 검사를 지속적으로 실행합니다.
사용자 문서는 uvwt/agentdock-docs에서 별도로 관리됩니다.
. 사용자에게 보이는 동작, 구성, 설치 또는 도구 스키마의 변경 사항은 동일한 변경 세트에서 일치하는 문서를 업데이트해야 합니다.
장치 페어링(device pairing), 크로스 노드 도구 라우팅(cross-node tool routing), Recall 또는 Workflow 통합과 관련된 변경 사항은 uvwt/nexusdock에서도 조정된 변경이 필요할 수 있습니다.
. 공유 프로토콜은 uvwt/agentdock-protocol에서 관리됩니다.
. 공유 인터페이스나 데이터 구조를 변경할 때는, 먼저 프로토콜 정의를 업데이트하고, 그 다음 두 구현체와 해당 프로토콜 의존성 버전을 맞추고, 호환성을 확인하며, 해당 문서를 업데이트하고, 관련 크로스 리포지토리 변경 사항을 PR에 연결하십시오.
버그 및 기능 요청은 GitHub Issues를 통해 제출하십시오.
AgentDock이 도움이 되었다면, Star ⭐를 눌러 지원해 주시면 감사하겠습니다.
| Alipay | |
Apache License 2.0. LICENSE 참조.