IM-MCP 에이전트 운영 및 데이터 수명 주기 관리 가이드
이 스킬은 에이전트가 Windows 및 macOS 환경에서 im-mcp 도구 세트(위챗 MCP 및 딩톡 MCP 포함)를 관리하는 방법을 안내하며, 사전 환경 점검, 오프라인 데이터베이스 초기화 및 복호화, 채팅 데이터 검색, 작업 완료 후 안전한 정리를 다룹니다.
1. 핵심 위치 및 실행 전략 (Core Principles & Execution Strategy)
1.1 실행 방식 우선 순위 원칙 및 실행 전략
에이전트가 배포를 안내하거나 지원할 때 다음 실행 전략을 따라야 합니다:
- 영구 설치 우선: Claude Desktop, Cursor 등 데스크톱 클라이언트 또는 영구 도구를 지원하는 환경에서는
uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"사용을 권장합니다. - 샌드박스/제한 환경 하향 조정: 현재 AI 클라이언트 환경(예: Pi 샌드박스 환경)이 전역 도구 설치를 차단하는 경우(
Blocked ... use uvx메시지), 해당 환경의 보안 정책을 따라uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]"방식으로 관련 명령을 즉시 실행합니다. - 국내 네트워크 미러 대안 (Gitee 소스): 사용자가 국내 네트워크 환경에 있거나 GitHub 접속이 제한/느린 경우, 위 Git 주소를 Gitee 미러 저장소로 직접 교체할 수 있습니다:
- 영구 설치:
uv tool install "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]" - 즉시 실행:
uvx --from "git+https://gitee.com/ws4m/im-mcp.git[all]" <command>
- 영구 설치:
- 프로토콜 테스트 코드 자체 작성 금지: 설치 및 초기화(
wechat-init및dingtalk-init) 완료 후, 에이전트가 자체적으로 스크립트나 코드를 작성하여 하위 JSON-RPC/stdio 프로토콜을 테스트하는 것을 엄격히 금지하며, 바로 사용자에게 전달하고 클라이언트 활성화 안내를 제공해야 합니다. - 호스트 환경 인식 및 전달 안내: 에이전트는 현재 실행 중인 클라이언트 환경(Pi, Claude Code/Desktop, Cursor, Cline 등)에 따라 스스로 판단하여 사용자에게 구체적인 스킬 및 MCP 활성화 단계를 안내하고(예:
/reload입력, 클라이언트 재시작 또는 사이드바에서 신뢰 활성화), 일상 대화에서 사용할 수 있는 1~2개의 예시를 직접 제시해야 합니다.
1.2 명령 매트릭스 및 권한 개요
# 방법 A: 전역 영구 격리 설치 CLI 도구 체인 (우선 권장)
uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"
명령 매트릭스는 다음과 같습니다:
| 명령 | 전역 설치 후 호출 방식 | 샌드박스/제한 환경 uvx 즉시 실행 방식 | 적용 시나리오 | 권한 요구 사항 | 주요 산출물 / 경로 |
|---|---|---|---|---|---|
wechat-init | wechat-init | uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-init | 위챗 DBKey 추출 및 오프라인 복호화하여 SQLite 데이터베이스로 저장 | Windows: 관리자 권한 필요(메모리 스캔); macOS: --passphrase 또는 설정 영구 저장 지원 | ~/.wechat_mcp/decrypted/, ~/.wechat_mcp/app.db |
dingtalk-init | dingtalk-init | uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-init | 딩톡 키 오프라인 추출, DB 복호화 및 WAL 트랜잭션 병합 | 일반 사용자 권한 | ~/.dingtalk_mcp/decrypted/dingtalk.db |
im-clean | im-clean | uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" im-clean | 내보낸 모든 평문 데이터, 키 및 캐시를 한 번에 안전하게 정리 | 일반/관리자 권한 | 위 두 항목의 복호화 라이브러리 및 전역 데이터 디렉토리 정리 |
wechat-mcp | wechat-mcp | uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-mcp | 위챗 FastMCP 표준 서버 엔트리 포인트 | 일반 사용자 권한 | stdio 인터페이스 |
dingtalk-mcp | dingtalk-mcp | uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-mcp | 딩톡 FastMCP 표준 서버 엔트리 포인트 | 일반 사용자 권한 | stdio 인터페이스 |
2. 에이전트 작업 워크플로우 (Lifecycle Workflows)
2.1 작업 시작 전: 자동 데이터베이스 초기화 (Pre-flight Initialization)
사용자가 "최근 위챗/딩톡 커뮤니케이션 분석", "주간 보고서 생성", "특정 그룹 채팅 파일 검색" 등을 요청할 때, MCP에서 "데이터베이스를 찾을 수 없음" 오류가 발생하거나 빈 결과를 반환하면 에이전트는 자체적으로 초기화를 수행해야 합니다:
딩톡 데이터베이스 초기화 (DingTalk)
딩톡은 순수 Python 기반 로컬 오프라인 복호화로 거의 100% 자동화되어 있으며 관리자 권한이 필요하지 않습니다:
# 에이전트가 초기화 실행
dingtalk-init
- 예상 출력: 활성 UID 감지,
🎉 딩톡 데이터 초기화 동기화 성공!출력. - 환경 사전 판단 (무분별한 스캔 금지): 데이터 디렉토리나 UID를 찾을 수 없다는 메시지가 표시되면, 에이전트가 호스트에서 무작위로 프로세스나 디스크를 깊이 재귀 검색하는 것을 금지합니다. 즉시 중단하고 사용자에게 상황을 설명한 후, 딩톡 클라이언트가 현재 기기에 로그인되어 있는지 확인하도록 요청하고 알려야 합니다.
위챗 데이터베이스 초기화 (WeChat)
위챗은 키가 필요하며 WCDB 데이터베이스의 복호화 및 검증을 수행해야 합니다:
- Windows:
# Windows: 관리자 권한으로 실행 wechat-initwechat-init이 오류를 보고합니다. - macOS:
# macOS: 64비트 passphrase 직접 전달 지원 wechat-init --passphrase <64비트_16진수_passphrase>~/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/*/db_storage)를 찾고, 시스템 네이티브CommonCrypto(CCCrypt)를 호출하여 키를 파생하고 복호화를 완료합니다. - 위챗 실행 전 사전 점검 (무분별한 스캔 금지):
- 중요 제약: 위챗 프로세스를 찾을 수 없거나 키 자료가 없으면 에이전트가 관련 없는 시스템 프로세스를 추측하여 스캔하거나 시스템 전체 디렉토리를 탐색하는 것을 금지합니다!
- 올바른 처리: 사용자에게 현재 환경 상태를 명확히 설명하고, 환경을 준비하거나 passphrase를 입력하도록 안내해야 합니다.
- 권한 판단: Windows에서
Access Denied오류 발생 시, 사용자에게 이유를 설명하고 관리자 권한으로 실행할 것을 제안합니다. - 성공 표시: 사용자 데이터 디렉토리
~/.wechat_mcp/decrypted/에 복호화된 데이터베이스가 생성되고,~/.wechat_mcp/app.db에 FTS5 인덱스 정리가 완료됩니다. 데이터 정리 및 인덱스만 다시 실행해야 하는 경우wechat-init --etl-only를 실행할 수 있습니다.
2.2 작업 실행 중: MCP 도구 호출 규칙
초기화 성공 후, 에이전트는 네이티브 SQL 쿼리를 직접 사용하지 않고 MCP 도구를 통해 검색하는 것을 우선해야 합니다:
위챗 (wechat) 권장 호출 순서:
list_wechat_sessions(limit=20): 먼저 최근 활성 세션/그룹 채팅 목록을 가져와 중요한session_id(예:xxx@chatroom또는 위챗 ID)를 확보합니다.search_wechat_messages(query="키워드", limit=50): 채팅 내용 전체 텍스트 검색(offset페이지 매김 지원).get_session_history(session_id="...", limit=100): 대상 세션의 컨텍스트 메시지 스트림을 가져옵니다.get_message_image(message_id=...): 채팅 이미지 요청 시 복호화. 검색 또는 기록 메시지에[이미지]가 포함된 경우 해당 메시지id로 이 도구를 호출합니다.- 기본 모드: 복호화된 이미지의 로컬 물리적 절대 경로 반환(
~/.wechat_mcp/images/에 캐시). 큰 이미지의 Base64가 에이전트 컨텍스트를 직접 폭파시키는 것을 방지합니다. - 멀티모달 이미지 보기 모드: 현재 에이전트가 시각적 이미지 분석이 필요하면
include_base64=True를 설정하여 모델이 이해할 수 있는 Base64 문자열을 추출합니다.
- 기본 모드: 복호화된 이미지의 로컬 물리적 절대 경로 반환(
search_shared_files(keyword="...", limit=20): 그룹 내 또는 개인 채팅에서 전송된 파일 경로를 찾습니다.
위챗 측에서 추가로 제공: get_messages_by_date / get_messages_by_range (날짜 또는 시간 범위별 데이터 가져오기), search_contacts (연락처 역조회), list_chatroom_members (그룹 멤버 목록), search_media_files (이미지/비디오 디스크 경로), list_favorites (즐겨찾기), list_emoticons (이모티콘), get_chat_activity_stats (활동 통계), get_persona_style (커뮤니케이션 스타일 증류), get_sync_status (인덱스 신선도). get_messages_by_date / get_messages_by_range는 search_wechat_messages와 마찬가지로 offset 페이지 매김을 지원합니다.
딩톡 (dingtalk) 권장 호출 순서:
list_dingtalk_conversations(limit=20): 최근 그룹 채팅 및 개인 채팅 목록 가져오기 (최신 실명 및 그룹 이름이 자동 매핑됨).search_dingtalk_messages(keyword="키워드", limit=50): 128개 분할 테이블에 걸쳐 집계된 텍스트 검색.get_dingtalk_messages(cid="...", limit=100): 특정 딩톡 그룹 또는 개인 채팅의 대화 세부 정보 보기.list_dingtalk_contacts(keyword="이름/병음"): 연락처 UID 및 실명 빠른 역조회.
2.3 버전 업그레이드 및 유지보수 (Project Upgrade & Version Maintenance)
사용자가 "im-mcp 업데이트", "위챗/딩톡 MCP 업그레이드", "최신 수정 사항 가져오기"를 요청하거나 새 기능/버그 수정 릴리스를 발견하면, 에이전트는 현재 설치 방식에 따라 원활한 업그레이드를 수행해야 합니다:
1. 전역 영구 설치 모드 업그레이드 (권장):
사용자가 이전에 uv tool install로 설치한 경우 uv tool update를 사용하거나 Git 저장소를 다시 지정하여 업그레이드합니다:
# 표준 전역 원클릭 업데이트
uv tool upgrade im-mcp
# 또는 최신 원격 저장소 버전으로 강제 재설치 (최신 Git HEAD 지원)
uv tool install --force "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"
# 국내 네트워크 환경 (Gitee 소스)
uv tool install --force "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]"
2. 즉시 실행 모드 (uvx):
샌드박스에서 uvx로 실행하는 경우 uvx는 기본적으로 이전 버전의 Wheel을 캐시할 수 있습니다. 업그레이드 또는 버전 캐시 강제 새로 고침을 수행합니다:
# uvx 임시 도구 캐시를 정리하여 최신 Git 코드를 가져오도록 보장
uv cache clean im-mcp
# 또는 다음 uvx 호출 시 --refresh 매개변수를 추가하여 최신 버전 강제 가져오기
uvx --refresh --from "git+https://github.com/stkoecn/im-mcp.git[all]" <command>
3. 업그레이드 후 원활한 재로드:
업그레이드 완료 후, 에이전트는 사용자에게 클라이언트를 새로 고치거나 다시 로드하여 최신 버전의 MCP 서비스 정의 및 도구 세트를 로드하도록 적극적으로 알려야 합니다:
- Pi / Pebrel:
/reload입력 안내. - Claude Desktop / Cursor / WorkBuddy: 클라이언트 재시작 또는 MCP 서버 재연결 안내.
- 이번 업그레이드가 하위 데이터베이스 정리 로직 변경과 관련된 경우,
wechat-init --etl-only를 2초 내에 실행하여 무손실로 최신 FTS 인덱스를 재구축할 수 있으며, 시간 소모적인 재추출 또는 재복호화가 필요하지 않습니다.
2.4 작업 종료 후: 데이터 개인 정보 보호 및 저장소 정리 (Post-flight Cleanup)
주간 보고서, 업무 시간 집계를 완료했거나 사용자가 명시적으로 "환경 정리", "내보낸 채팅 기록 삭제"를 요청한 경우, 에이전트는 적극적으로 im-clean을 호출해야 합니다:
정리 대상 파일 미리보기 (읽기 전용 보안 점검):
im-clean --dry-run
완전 정리 실행:
# -y 매개변수를 사용하여 내보낸 모든 평문 SQLite, 키 및 중간 캐시를 자동 감지하여 상주 프로세스 잠금 처리 포함하여 자동 정리
im-clean -y
# 잔여 핸들 잠금이 있는 경우 --force를 추가하여 MCP 서비스를 강제 종료하고 완전 삭제 수행
im-clean -y --force
특정 플랫폼 데이터만 정리:
# 위챗 데이터만 정리, 딩톡 유지
im-clean --scope wechat -y
# 딩톡 데이터만 정리, 위챗 유지
im-clean --scope dingtalk -y
2.5 완전 제거 및 클라이언트 정리 협업 (Full Uninstallation Guidance)
사용자가 명시적으로 "이 MCP를 완전히 제거", "채팅 도구 및 설정을 완전히 삭제"를 요청하면, 에이전트는 사용자가 다음 수준의 표준 순서 정리를 수행하도록 돕고, 사용자가 클라이언트 인터페이스에서 수동으로 수행해야 하는 단계를 적극적으로 알려야 합니다:
- 클라이언트 종료 또는 서비스 중지: 사용자에게 현재 AI 클라이언트를 먼저 종료하도록 알리거나,
im-clean -y --force가 자동으로 잔여 MCP 프로세스를 처리하도록 합니다. - 자동 데이터 정리: 에이전트가
im-clean -y --force를 실행하여~/.wechat_mcp및~/.dingtalk_mcp를 완전히 삭제합니다 (반환 코드가 0인지 확인, 0이 아니면 성공을 허위 보고하는 것을 엄격히 금지). - 자동 종속성 제거: 에이전트가
uv tool uninstall im-mcp또는uv cache clean을 실행하여 환경 및 캐시를 정리합니다. - 사용자에게 클라이언트 수동 정리 알림 출력:
- 에이전트는 현재 호스트 클라이언트에 따라 사용자에게 설정 파일을 수동으로 정리하도록 안내합니다 (각 환경의 일반 경로는 이 스킬 마지막의 [부록: 주요 에이전트 호스트 환경 참조 디렉토리]를 참조).
3. 일반적인 문제 처리 및 에이전트 행동 규칙 (Troubleshooting & Agent Rules)
-
핵심 금지: 오류 발생 시 즉시 중단, 코드 분석이나 무분별한 시도 금지:
- 설치, 초기화 또는 테스트 호출 과정에서 알 수 없는 오류, 환경 충돌 또는 실행 예외가 발생하면:
- 절대 금지: 에이전트가 소스 코드를 깊이 파헤치거나, 직접 패치를 작성하여 코드를 수정하거나, 반복적으로 추측하여 재시도하거나, 시스템 환경을 무분별하게 진단하는 것을 엄격히 금지합니다.
- 반드시 실행: 오류가 발생한 단계에서 즉시 중단하고, 핵심 오류 요약을 원본 그대로 표시하며, 사용자에게 명확히 질문해야 합니다:
"현재 단계에서 오류가 발생했습니다:
[오류 요약]. 문제를 직접 해결하시겠습니까, 아니면 작업을 중단하고 더 이상 사용하지 않으시겠습니까?" - 제어권을 사용자에게 넘기고 사용자가 확인한 후 계속하거나 종료합니다.
-
설치 및 초기화 후 즉시 사용자에게 전달, 프로토콜 테스트를 위한 코드 자체 작성 엄격히 금지:
- 에이전트가 도구 설치(예:
uv tool install), 설정 파일 쓰기 및init초기화를 완료하면 전체 배포 프로세스가 이미 종료된 것입니다. - 절대 금지: 에이전트가 자체적으로 Python/Node 테스트 스크립트를 작성하여 JSON-RPC 2.0 핸드셰이크, 파이프 통신 또는 프로토콜 내부 세부 정보를 탐지하는 것을 엄격히 금지합니다. 이는 토큰 소모와 통제 불가능한 예상치 못한 오류 위험만 증가시킬 뿐만 아니라, 사용자의 실시간 인식 및 제어권을 박탈합니다.
- 반드시 실행: 설치 및 초기화 완료 후 직접 전달하고 가장 간결하고 친숙한 사용 안내를 제공합니다:
- 현재 클라이언트에서 해당 MCP를 활성화/신뢰하도록 명확히 안내합니다 (예: Pi 사용자에게
/reload실행, Claude Desktop / Cursor 사용자에게 클라이언트 재시작). - 1~2개의 간단하고 직관적인 자연어 예시를 제시하여 사용자 경험을 안내합니다. 예:
"설치 및 초기화가 완료되었습니다! 클라이언트에서 이 MCP를 신뢰/활성화하신 후(예:
/reload실행), 저에게 다음과 같이 말씀해 주시면 사용을 시작할 수 있습니다: 👉 ‘최근 프로젝트 그룹에서 무슨 이야기를 했는지 알려줘’ 👉 ‘딩톡에서 청펑이 보낸 보고서 통계 결과를 찾아줘’ 👉 ‘지난주 특정 요구사항에 대한 커뮤니케이션 기록을 모아서 주간 보고서를 만들어 줘’”
- 현재 클라이언트에서 해당 MCP를 활성화/신뢰하도록 명확히 안내합니다 (예: Pi 사용자에게
- 에이전트가 도구 설치(예:
-
클라이언트 및 애플리케이션 권한 신뢰 (호스트 환경 자동 인식 및 활성화 안내):
- 에이전트는 현재 세션 특징을 통해 사용자가 사용 중인 클라이언트 호스트를 자동으로 인식해야 합니다.
- 모호하게 "클라이언트에서 활성화하세요"라고 출력하는 것을 금지하고, 현재 호스트에 따라 해당 클라이언트의 구체적인 적용 방식을 제시해야 합니다 (예: Pi는
/reload입력, 데스크톱 앱은 재시작; 구체적인 특징은 마지막 부록 참조).
-
위챗/딩톡 프로세스를 찾을 수 없을 때의 행동 금지 사항:
- 금지: 호스트에서 시간이 많이 소요되고 침입적인 전체 디스크 강제 스캔이나 다른 시스템 프로세스를 추측하는 행위.
- 반드시: 즉시 중단하고 사용자에게 클라이언트 로그인 상태를 확인하도록 친절하게 요청.
-
위챗 증분 메시지 동기화 문제: 위챗 클라이언트가 온라인 상태이면 새 메시지가 원래 암호화 라이브러리에 기록됩니다. 방금 생성된 새 메시지를 가져와야 하는 경우 에이전트는 사용자에게 "
wechat-init을 다시 실행"하여 로컬 복호화 라이브러리를 업데이트하도록 안내할 수 있습니다. -
딩톡 WAL 잠금 문제:
dingtalk-init에는 자동 복사 메커니즘이 내장되어 있어 딩톡이 실행 중이고 WAL 트랜잭션 상태에 있더라도 SQLite 라이브러리 잠금 충돌이 발생하지 않습니다. -
개인 정보 보안 원칙: 복호화된 SQLite 데이터베이스는 민감한 로컬 개인 정보이므로, 공용 컴퓨터 또는 멀티 테넌트 환경에서는 작업 종료 후 반드시
im-clean -y를 안내하거나 자동으로 실행해야 합니다. -
배포 피드백 보고서 및 커뮤니티 자동 개발 메커니즘 (Deployment Feedback & Auto-Development):
- 배포 및 초기화가 성공했든 실패했든 에이전트는 프로세스 종료 시 적극적으로 정리하여 사용자를 위해 구조화되고 간결한 《배포 및 운영 피드백 브리핑》을 생성하고, 사용자가 원클릭으로 복사하여 GitHub에 Issue를 제출할 수 있도록 안내해야 합니다.
- ⚠️ 핵심 강조 원칙 (반드시 명확히 표시, 모호함 금지):
- 보고서 제목과 첫 번째 상태 표시줄에는 매우 눈에 띄는 시각적 식별자(예:
【상태: 🟢 배포 성공 / SUCCESS】또는【상태: 🔴 배포 차단 / FAILED】)를 사용해야 합니다. - 모호하거나 중립적인 서술을 절대 금지하여, 질문자 및 진단 에이전트가 한눈에 성공 또는 실패를 알 수 있도록 합니다.
- 보고서 제목과 첫 번째 상태 표시줄에는 매우 눈에 띄는 시각적 식별자(예:
- 에이전트 자동화 운영 약속: 사용자에게 알립니다: "이 프로젝트는 GitHub Agent 자동화 협업 파이프라인에 연결되어 있습니다. 제출하신 Issue는 전담 에이전트가 자동으로 재현 진단, 코드 수정 및 병합 제출을 수행합니다!"
- 브리핑 생성 표준 템플릿:
- 성공 (SUCCESS) 시:
### 📋 im-mcp 배포 피드백 보고서 【상태: 🟢 배포 성공 / SUCCESS】 > **최종 결론**: ✅ 모든 종속성 설치 성공, 데이터 추출 및 인덱스 동기화 완료, 서비스가 즉시 호출 가능한 상태입니다! - **핵심 상태**: 🟢 SUCCESS - **환경 정보**: OS 버전(예: Win11 23H2), 클라이언트 호스트(예: WorkBuddy / Pi / Claude Desktop), Python 및 uv 버전 - **설치 모드**: `uv tool install` / `uvx` / 로컬 소스 - **초기화 지표**: 소요 시간(예: 위챗 12초 / 딩톡 3초), 연락처/세션/메시지 동기화 건수 - **사용 제안**: 콜드 스타트 경험, 증분 동기화 안내 또는 다음 기능 희망 사항 - **피드백 입구**: [GitHub Issues](https://github.com/stkoecn/im-mcp/issues)로 이동하여 경험을 공유해 주세요. 커뮤니티 에이전트가 자동으로 추적하여 개선합니다! - 실패 또는 장애 (FAILED) 시:
### ⚠️ im-mcp 배포 피드백 보고서 【상태: 🔴 배포 차단 / FAILED】 > **최종 결론**: ❌ 프로세스가 중간에 차단되어 중단되었습니다. 핵심 서비스를 정상적으로 시작할 수 없습니다. 아래 장애 위치를 참조하세요. - **핵심 상태**: 🔴 FAILED - **차단 단계**: 종속성 설치 / 위챗 키 추출 / 딩톡 복호화 / 데이터베이스 인덱스 구축 / 클라이언트 마운트 - **환경 특징**: OS 버전, 클라이언트 호스트, 위챗 버전(예: 4.x / 3.x), 딩톡 버전(예: 7.x V3) - **주요 오류 요약**: 핵심 오류 스택 또는 시스템 메시지 추출(예: Access Denied / 프로세스 미실행 / 파일 잠금 거부) - **시도한 조치**: 권한 상승 시도 여부, `--force` 또는 `--etl-only` 시도 여부 - **개선 제안**: 현재 프로세스에서 원활하지 않거나 도구의 자동 오류 허용이 필요한 부분 지적 - **원클릭 피드백**: 이 보고서를 복사하여 [GitHub Issues](https://github.com/stkoecn/im-mcp/issues)로 이동하여 제출해 주세요. 저장소 전담 에이전트가 자동으로 로그를 분석하고 수정을 시작합니다!
- 성공 (SUCCESS) 시:
4. 부록: 주요 에이전트 호스트 환경 참조 디렉토리 (참고용)
💡 안내: 이 디렉토리는 현재 주요 AI 클라이언트/에이전트 환경의 기본 동작 및 설정 특징을 수집한 것으로 참고용입니다. 각 플랫폼의 버전 업데이트 후 변경될 수 있으므로 해당 플랫폼의 최신 공식 문서를 기준으로 하십시오.
| 클라이언트 환경 | 일반 식별 특징 | 설정 / 활성화 방식 참고 | 제거 및 정리 방식 참고 |
|---|---|---|---|
| Pi / Pebrel | PI_* 환경 변수 또는 ~/.pi/ 디렉토리 존재 | ~/.pi/agent/mcp.json 편집, 세션에서 /reload 입력하여 다시 로드 적용 | mcp.json에서 항목 제거, ~/.agents/skills/im-mcp 삭제, /reload 입력 |
| Claude Desktop | 로컬 AppData에 Claude 설정 존재 | %APPDATA%\Claude\claude_desktop_config.json 편집, 클라이언트 앱 완전 재시작 | 설정 파일의 mcpServers에서 항목 제거 및 소프트웨어 재시작, 스킬 디렉토리 정리 |
| Cursor | VS Code 파생, Cursor 설정 존재 | Settings ➔ Features ➔ MCP Servers에서 추가, 인터페이스에서 즉시 마운트 | MCP 서버 목록에서 해당 항목의 Delete / Remove 클릭 |
| Cline / Roo Code | VS Code 확장 패널 | 확장 사이드바의 MCP 탭에서 설정 추가, "Enabled"로 전환하여 활성화 및 권한 부여 | 사이드바 MCP 목록에서 스위치 끄기 또는 휴지통 아이콘 클릭하여 제거 |
| Cherry Studio | 데스크톱 다중 모델 관리 도구 | 설정 ➔ MCP 서버에서 stdio 명령 추가, 저장 시 즉시 적용 | MCP 서버 목록에서 선택하고 "삭제" 클릭, 설정 저장 |
| WorkBuddy | ~/.workbuddy/ 디렉토리 또는 관련 설정 존재 | ~/.workbuddy/mcp.json 편집, 커넥터 관리 인터페이스에서 수동으로 "신뢰/활성화" 클릭 | mcp.json에서 설정 블록 제거 및 인터페이스에서 커넥터 제거 |