> ## Documentation Index
> Fetch the complete documentation index at: https://link.datarelay.run/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 도구 참조

> 20개 도구의 인자·권한·작업 결과 처리.

# Native MCP 도구 20개

DataRelay Link가 제공하는 MCP 도구의 이름·필수 인자·권한을 정리했습니다. 클라이언트가 붙이는 namespace는 다를 수 있습니다. 아래 항목은 CLI 명령이 아니라 AI가 호출하는 MCP 도구입니다.

| 도구 | 필수 인자 | DRLink 권한 | 용도 |
| - | - | - | - |
| **get\_server** | 없음 | host-info | Server 자체 조회 |
| **list\_hosts** | 없음 | host-info | 접근 가능한 Managed Host 목록 |
| **get\_host** | endpoint | host-info | Managed Host 조회 |
| **get\_system\_info** | endpoint | host-info | 시스템 정보 |
| **list\_processes** | endpoint | process-read | 프로세스 조회 |
| **read\_file** | endpoint, path | file-read | 허용 파일 읽기 |
| **write\_file** | endpoint, path, content | file-write | 허용 파일 쓰기 |
| **delete\_file** | endpoint, path | file-write | 일반 파일 삭제 |
| **upload\_file** | endpoint, path, content | file-upload | 파일 업로드 |
| **download\_file** | endpoint, path | file-download | 파일 다운로드 |
| **exec** | endpoint, command | command-exec | 대상 명령 실행 |
| **server\_read\_file** | path | file-read | Server 파일 읽기 |
| **server\_write\_file** | path, content | file-write | Server 파일 쓰기 |
| **server\_delete\_file** | path | file-write | Server 파일 삭제 |
| **server\_run** | cwd, argv | command-exec | 전체 제어 모드 argv 실행 |
| **server\_exec** | cwd, command | command-exec | 셸 명령 실행 |
| **server\_git** | cwd, argv | command-exec | Git 조회·수정·commit/push |
| **server\_job\_poll** | job\_id | command-exec | 작업 상태·출력 조회 |
| **server\_job\_input** | job\_id | command-exec | 표준 입력·EOF 전달 |
| **server\_job\_stop** | job\_id | command-exec | 본인 작업 중지 |

## 대상과 실행 계정

Managed Host endpoint는 **list\_hosts/get\_host가 반환한 식별자**를 사용하세요. server\_\*와 get\_server는 Server 자체이며 endpoint 인자를 받지 않습니다. 일반 도구의 endpoint=server:self도 명시적으로 부여한 Server 관리 권한을 따릅니다.

Server 자체의 셸·Git·서비스·패키지 작업은 설정된 OS 계정 권한과 AI Access를 따릅니다. **cwd는 시작 위치 검증이지 셸의 파일시스템 샌드박스가 아닙니다.**

## 인자와 결과

| 도구 | 선택 인자 / 동작 |
| - | - |
| server\_exec / server\_run / server\_git | timeout\_seconds: 1–86400, 기본 3600; wait\_ms: 0–5000, 기본 1000 |
| server\_job\_poll | stdout\_cursor / stderr\_cursor: 바이트 offset, 기본 0; wait\_ms: 0–5000 |
| server\_job\_input | data: UTF-8 문자열, 기본 빈 값; eof: boolean, 기본 false |

argv는 문자열 배열이며 server\_git의 첫 값은 git입니다. path와 cwd는 절대경로입니다. 실행 결과의 **job\_id, state, exit\_status, stdout, stderr, execution\_user**를 확인하세요. running은 성공 완료가 아닙니다. poll은 각 스트림의 **next\_cursor**로 이어 읽고, 정확한 바이트가 필요하면 **data\_b64**를 사용합니다. 출력은 스트림당 최대 1 MiB 보존/페이지당 64 KiB이며 cursor eviction을 확인해야 합니다. stdin도 64 KiB 한도이며 **accepted\_bytes**로 수락 범위를 확인하세요. 완료 작업은 최대 10분 또는 제한된 기록 정리 때까지만 조회됩니다. 재시작 후 보존을 보장하는 영구 작업 큐가 아닙니다.

poll/input/stop도 현재 command-exec 권한과 동일 identity/job ownership을 다시 확인합니다. 다른 identity의 job\_id를 안다고 제어할 수 없습니다. file-read/write/upload/download는 별도 권한과 Rule의 paths, 실제 OS 권한을 충족해야 합니다.

[실행 가능한 Server 제어 실습](https://link.datarelay.run/ko/use-cases/ai-server-control.md) · [클라이언트 연결](https://link.datarelay.run/ko/guides/mcp-clients.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.