딥시크 하네스 엠시피 접속, 원격 실행

마지막 업데이트: 2026년 8월 18일. 딥시크 하네스 공식 저장소와 엠시피 관련 패키지 경로, 사용자 안내서, 엠시피 전송 문서를 기준으로 확인했습니다.

공식 저장소의 현재 안내에는 딥시크 하네스가 개발자 미리 보기 상태이며 호환성을 깨는 변경이 있을 수 있다고 적혀 있습니다. 따라서 첫 연결은 단일 읽기 전용 엠시피 서버로 시작하고, 도구 발견과 권한 흐름이 확인된 뒤에만 쓰기 도구를 추가해야 합니다. 지속 실행이나 팀 공유가 목적이라면 개인 컴퓨터의 임시 터미널이 아니라 재현 가능한 독립 환경에 딥시크 하네스와 엠시피 프로세스를 고정해야 합니다. (공식 저장소의 현재 상태)

이 글은 기존 엠시피 서버를 딥시크 하네스에 연결하려는 에이전트 개발자, 도구 권한과 비밀값을 관리하는 플랫폼 엔지니어, 클라우드 맥에서 엠시피 도구를 계속 실행하려는 운영 담당자를 위한 절차서입니다. 단순 설치법보다 실패 지점과 되돌리기 경로에 초점을 둡니다.

접속 전 도구 경계

엠시피 도구는 먼저 세 등급으로 나누는 편이 안전합니다.

도구 등급	예시	첫 검증 허용 여부	필요한 통제
읽기 전용	코드 검색, 문서 조회, 데이터베이스 조회	허용	대상 범위, 시간 제한, 로그
제한된 쓰기	테스트 행 추가, 임시 파일 생성	조건부	허용 대상, 승인, 되돌리기
명령 실행	셸 실행, 배포, 외부 시스템 변경	보류	격리 환경, 사람 승인, 결과 검증

엠시피는 서버가 제공하는 도구의 이름과 입력 구조를 클라이언트가 발견하는 방식으로 동작합니다. 공식 사양의 도구 문서도 도구 목록, 입력 형식, 호출 결과를 별도로 다루므로, “서버 프로세스가 실행됐다”와 “딥시크 하네스가 도구를 등록했다”는 서로 다른 성공 조건입니다. ([엠시피 도구 사양](https://modelcontextprotocol.io/specification/2025-06-18/server/tools))

딥시크 하네스가 지원하는 엠시피 서버 연결 방식은 무엇입니까?

현재 확인해야 할 핵심은 설정 파일의 이름보다 공식 저장소의 packages/mcp 경로와 사용자 안내서에 표시된 등록 진입점입니다. 로컬 프로세스는 표준 입출력 방식이 기본 후보이고, 원격 서버는 스트리밍 방식의 HTTP 연결 여부를 당일 문서에서 다시 확인해야 합니다. 엠시피 사양은 로컬 배포에 표준 입출력, 원격 배포에 스트리밍 HTTP를 공식 전송 방식으로 설명하지만, 이것이 딥시크 하네스의 모든 버전에서 동일하게 노출된다는 뜻은 아닙니다. (엠시피 전송 사양)

다음 조건이면 읽기 전용 서버부터 선택합니다.

코드나 데이터 조회만 필요하면 로컬 표준 입출력 연결을 먼저 선택합니다.
여러 사용자가 같은 서버를 써야 하고 공식 문서에 원격 연결이 명시되어 있으면 스트리밍 HTTP를 검토합니다.
설정 키나 명령이 현재 저장소와 설치 안내서에서 일치하지 않으면 엠시피를 제거한 기본 딥시크 하네스로 되돌립니다.
서버가 쓰기나 명령 실행을 포함하면 연결 성공만으로 운영 승인하지 않습니다.

단일 서버 첫 연결

처음에는 서버 하나만 등록합니다. 코드 검색 서버, 데이터베이스 서버, 브라우저 서버를 동시에 붙이면 프로세스 오류와 등록 오류를 분리하기 어렵습니다.

준비 조건은 다음과 같습니다.

딥시크 하네스의 현재 커밋이나 설치 버전을 기록합니다.
엠시피 서버의 실행 파일, 시작 디렉터리, 필요한 런타임을 고정합니다.
비밀값 없이 시작할 수 있는 읽기 전용 작업을 하나 정합니다.
성공 증거를 “도구 목록 확인, 조회 호출 성공, 결과 파일 생성”으로 정의합니다.
실패 시 엠시피 설정을 제거하고 기본 작업이 다시 실행되는지 확인합니다.

확인 단계	성공 신호	실패 시 회복
프로세스 시작	종료하지 않고 대기하며 오류가 없음	실행 파일과 시작 디렉터리 확인
전송 연결	초기화 응답이 돌아옴	표준 입출력과 HTTP 설정을 분리
도구 등록	예상한 도구 이름이 목록에 표시됨	서버 자체 목록과 하네스 목록 비교
읽기 호출	구조화된 결과가 반환됨	입력 형식과 제한 시간 확인
기본 작업	엠시피 없이도 하네스가 실행됨	이전 설정으로 즉시 되돌림

딥시크 하네스 공식 사용자 안내서는 실행 디렉터리가 기본 파일 위치에 영향을 주며, 작업 공간을 별도로 선택해야 세션을 사용할 수 있다고 설명합니다. 따라서 서버가 실행되더라도 작업 공간이나 시작 위치가 다르면 코드 검색 결과가 비어 있을 수 있습니다. ([공식 사용자 안내서](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md))

**주의:** 예시 설정에 실제 비밀값을 넣지 마십시오. 환경 변수 이름만 기록하고, 값은 비밀 저장소나 실행 환경에서 주입해야 합니다.

도구 발견과 결과 검증

연결 뒤에는 부작용이 없는 조회 작업을 실행합니다. 예를 들어 특정 폴더의 파일 목록, 고정된 코드 문자열 검색, 테스트 데이터베이스의 한정된 조회처럼 결과를 다시 확인할 수 있는 작업이 적합합니다.

검증 순서는 다음과 같습니다.

하네스가 본 도구 이름과 엠시피 서버가 제공한 이름을 비교합니다.
필수 입력, 선택 입력, 열거형 값, 기본값을 확인합니다.
제한 시간을 짧게 설정하고 시간 초과가 오류로 구분되는지 봅니다.
결과가 문장으로만 오지 않고 후속 에이전트 작업에 사용할 구조를 유지하는지 확인합니다.
로그에서 비밀값과 내부 주소를 지운 뒤 요청, 응답, 결과 파일을 함께 보관합니다.

문제가 발생하면 세 종류로 나눕니다.

서버 오류: 서버 로그에 입력 거부, 내부 예외, 외부 데이터베이스 오류가 남습니다.
전송 중단: 초기화는 됐지만 호출 중 연결 종료, 읽기 중단, 시간 초과가 발생합니다.
도구 등록 오류: 서버는 도구를 제공하지만 딥시크 하네스의 목록에 나타나지 않거나 이름이 다르게 보입니다.

**엠시피 도구를 붙였는데 딥시크 하네스에 나타나지 않는 이유는 무엇입니까?**

가장 흔한 원인은 서버가 시작되지 않은 것이 아니라 등록 과정의 기준이 서로 다른 경우입니다. 시작 디렉터리, 실행 경로, 설정 파일의 위치, 도구 목록 요청의 시점, 입력 형식 오류를 차례로 확인해야 합니다. 먼저 서버 단독 실행에서 도구 목록이 나오는지 확인하고, 그다음 하네스 로그의 등록 결과를 비교하십시오. 여러 서버를 한 번에 추가했다면 모두 제거한 뒤 단일 서버만 다시 등록하는 것이 빠릅니다.

비밀값과 쓰기 권한 분리

환경 변수, 비밀값 참조, 설정 파일은 역할을 나눠야 합니다.

설정 파일에는 서버 이름, 실행 명령, 허용 도구, 작업 디렉터리만 둡니다.
환경 변수에는 실행 시 필요한 비밀값을 주입합니다.
비밀 저장소에는 실제 키와 교체 이력을 보관합니다.
로그에는 키, 세션 토큰, 내부 주소가 출력되지 않도록 필터를 둡니다.

쓰기 도구는 대상과 행동을 좁혀야 합니다. 데이터베이스라면 특정 스키마와 테스트 행만 허용하고, 파일 작업이라면 하나의 임시 디렉터리로 제한합니다. 외부 입력이 작업을 시작하는 구조라면 사람 승인 단계를 두고, 실행 뒤에는 변경된 파일이나 데이터 행을 별도 조회로 검증해야 합니다.

다음 조건 분기로 운영 결정을 고정하면 됩니다.

읽기 전용이고 결과를 재현할 수 있으면 로컬 단일 서버 검증을 진행합니다.
쓰기이지만 테스트 대상과 되돌리기 절차가 있으면 격리된 원격 환경에서 제한적으로 진행합니다.
외부 입력이 명령 실행을 직접 유발하면 사람 승인 없이는 연결하지 않습니다.
비밀값이 설정 파일이나 로그에 남으면 기능 테스트를 중단하고 비밀값을 교체합니다.
실패 시 엠시피 없이 기본 작업이 되살아나지 않으면 원격 이전을 미룹니다.

원격 맥 프로세스 운영

원격 맥으로 옮길 때는 “누가 시작하고, 누가 감시하고, 누가 다시 시작하는가”를 문서로 고정해야 합니다. 딥시크 하네스, 엠시피 서버, 브라우저나 데이터베이스 같은 의존 프로세스를 하나의 임시 터미널에서 함께 실행하면 원격 연결이 끊긴 뒤 전체 상태를 잃기 쉽습니다.

원격 이전 절차는 다음과 같습니다.

프로젝트와 엠시피 서버를 별도 작업 디렉터리에 둡니다.
딥시크 하네스와 서버의 실행 사용자를 분리하거나 최소 권한으로 지정합니다.
환경 변수와 비밀값 참조가 로그인 셸에 의존하지 않는지 확인합니다.
프로세스 감시 도구로 종료, 재시작, 오류 로그를 확인합니다.
원격 접속을 끊은 뒤에도 세 프로세스가 예상 상태인지 확인합니다.
서버를 강제로 종료하고 재시작한 뒤 같은 읽기 작업을 다시 실행합니다.
결과 파일, 로그, 버전, 시작 디렉터리를 인수인계 자료에 남깁니다.

원격 맥을 준비할 때는 [맥 미니 렌탈 환경 선택 안내](https://macgpu.com/ko/m4-jumun.html)에서 작업 방식과 접속 조건을 먼저 확인한 뒤, 하네스와 엠시피 서버의 프로세스 책임을 별도로 문서화하는 편이 좋습니다. 원격 환경의 목적은 단순히 더 오래 켜 두는 것이 아니라, 접속이 끊겨도 같은 작업 디렉터리와 비밀값 참조로 다시 복구되는지 확인하는 데 있습니다.

원격 맥에서 엠시피 서버의 비밀값은 어떻게 관리합니까?

비밀값을 원격 맥의 명령 기록이나 저장소에 넣지 말고, 실행 서비스가 읽는 환경이나 비밀 저장소 참조로 전달해야 합니다. 키 교체 시에는 기존 프로세스가 새 값을 읽는지, 재시작이 필요한지, 실패하면 어떤 상태로 남는지를 함께 시험해야 합니다. 외부 네트워크에서 접근해야 한다면 엠시피 포트나 웹 화면을 기본 공개하지 말고, 사설 네트워크와 접근 목록, 암호화된 터널 등 필요한 통제만 사용하십시오.

여러 엠시피 서버를 같은 실행 환경에 두어도 됩니까?

서버들이 같은 런타임과 권한을 공유하고, 장애와 비밀값의 영향 범위를 감당할 수 있을 때만 같은 환경을 고려합니다. 데이터베이스 쓰기, 브라우저 자동화, 명령 실행처럼 위험도가 다른 도구는 프로세스와 권한을 나누는 편이 안전합니다. 팀 공용 환경에서는 서버별 로그와 재시작 정책을 분리해야 어느 서버가 실패했는지 추적할 수 있습니다.

종단 간 인수와 회복

최종 인수 작업은 도구 목록만 확인해서는 부족합니다. 다음 기준으로 한 가지 기준 작업을 실행하십시오.

딥시크 하네스가 세션을 시작합니다.
엠시피 서버의 도구 목록을 읽습니다.
읽기 전용 도구를 호출합니다.
결과를 에이전트가 해석합니다.
필요한 경우 쓰기 작업을 승인 대기 상태로 둡니다.
승인 뒤 변경 결과를 다시 조회합니다.
결과 파일과 로그를 저장합니다.
엠시피 설정을 제거하고 기본 작업을 재실행합니다.

판정은 세 단계로 나눕니다.

통과: 도구 발견, 읽기 호출, 결과 해석, 기본 설정 회복이 모두 확인됩니다.
제한 통과: 읽기는 되지만 쓰기 승인, 재시작, 원격 단절 중 하나가 아직 검증되지 않았습니다.
불통과: 도구가 나타나지 않거나, 오류 원인을 분리할 수 없거나, 엠시피 제거 뒤 기본 실행이 회복되지 않습니다.

개발자 미리 보기 상태에서는 버전 업데이트가 설정 키와 등록 방식에 영향을 줄 수 있으므로, 업그레이드 때마다 같은 기준 작업을 재실행해야 합니다. 공식 저장소의 패키지 구조에는 엠시피 관련 모듈과 자격 증명, 상호 작용 승인 모듈이 별도 영역으로 나뉘어 있으므로, 설치 버전만 올리고 권한 흐름을 생략해서는 안 됩니다. ([공식 패키지 구조](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages))

현재 개인 맥에서 임시 터미널로 돌리는 방식은 빠른 실험에는 유리하지만, 접속 종료 때 프로세스가 사라지고, 시작 디렉터리가 달라지며, 비밀값이 셸 환경에 남는 문제가 있습니다. 반면 MACGPU의 클라우드 맥은 테스트용 독립 환경을 빠르게 만들고, 원격 실행과 재시작 책임을 분리해 검증하기에 적합합니다. 다만 장기 고정 부하나 물리 장치 접근이 필요한 경우에는 직접 소유한 맥이 더 알맞고, 모든 엠시피 서버의 호환성을 MACGPU가 보장한다고 전제해서도 안 됩니다. 먼저 클라우드 맥 환경 선택 안내를 확인한 뒤, 단일 읽기 전용 서버의 기준 작업을 준비하는 순서가 안전합니다.

로컬 연결이 끝났다면 바로 여러 서버를 공개하지 말고, MACGPU의 격리된 원격 맥에서 단절 후 상태 유지, 프로세스 재시작, 비밀값 주입, 기준 작업 회복까지 확인하십시오. 이 검증을 통과한 뒤에만 쓰기 도구와 팀 공유를 확장하는 편이 실제 운영에서 더 짧은 장애 경로를 만듭니다.