AI 통합 (MCP)

VMark에는 Claude와 같은 AI 어시스턴트가 에디터와 직접 상호작용할 수 있게 해주는 내장 MCP (Model Context Protocol) 서버가 포함되어 있습니다.

MCP란?

Model Context Protocol은 AI 어시스턴트가 외부 도구 및 애플리케이션과 상호작용할 수 있게 해주는 개방형 표준입니다. VMark의 MCP 서버는 에디터 기능을 AI 어시스턴트가 다음과 같은 작업에 사용할 수 있는 도구로 노출합니다:

문서 내용 읽기 및 쓰기
서식 적용 및 구조 생성
문서 탐색 및 관리
특수 콘텐츠 삽입 (수학, 다이어그램, 위키 링크)

빠른 설정

VMark는 원클릭 설치로 AI 어시스턴트 연결을 쉽게 만들어 줍니다.

1. MCP 서버 활성화

설정 → 통합 을 열고 MCP 서버를 활성화합니다:

MCP 서버 사용 - AI 연결을 허용하려면 켭니다
시작 시 자동 실행 - VMark 열 때 자동 시작
새 위치로 저장 및 지니 결과 자동 승인 - 기본적으로 꺼져 있습니다. AI가 묻지 않고 문서를 새 경로에 저장할 수 있게 하고, 지니가 결과를 제안 대신 바로 적용할 수 있게 합니다. 일반적인 AI 쓰기는 이 설정의 제한을 받지 않습니다 — 그 안전망은 편집 체크포인트 기록입니다 (편집 작동 방식 참조)

2. 설정 설치

AI 어시스턴트에 맞는 설치 를 클릭합니다:

지원되는 AI 어시스턴트:

Claude Desktop - Anthropic의 데스크톱 앱
Claude Code - 개발자용 CLI
Codex CLI - OpenAI의 코딩 어시스턴트
Antigravity CLI - Google의 agy, Gemini CLI의 후속 도구
Grok CLI - xAI의 코딩 에이전트
opencode - 특정 제공자에 묶이지 않는 오픈 소스 터미널 에이전트

설치는 클라이언트별 자격 증명을 기록합니다. 설치는 VMark MCP 서버의 경로와 함께, 클라이언트 자체 설정 파일의 env.VMARK_MCP_TOKEN (opencode는 environment.VMARK_MCP_TOKEN) 아래에 비밀 토큰을 넣습니다. 클라이언트마다 고유한 토큰을 받으며, 토큰은 다른 어디에도 저장되지 않습니다. 이 토큰은 클라이언트가 보고하는 이름을 믿는 대신, 어떤 클라이언트가 연결하는지 VMark에 알려 줍니다. 현재 토큰이 필요한 것은 위임된 작업 — 사용자를 대신해 coherence_resolve로 정합성 질문에 답하는 것 — 뿐이며, 다른 모든 도구는 토큰 없이도 동작합니다. 설치와 복구 는 아직 유효한 토큰을 그대로 유지합니다. 새 토큰을 발급하려면 제거한 뒤 다시 설치하세요. 어느 쪽이든 그 후에는 AI 클라이언트를 재시작하세요. 토큰은 비밀번호처럼 다루세요: 설정 파일을 이슈나 채팅에 붙여 넣지 마세요.

Gemini CLI는 지원이 중단되었습니다

Google은 Gemini CLI를 Antigravity로 대체했습니다. 이전 VMark 설치가 ~/.gemini/settings.json에 vmark 항목을 남겨 두었다면, 통합 패널에 해당 항목의 지원 중단 행이 제거 버튼과 함께 표시됩니다. 새로 설치할 때는 대신 Antigravity를 대상으로 합니다.

기타 MCP 호환 클라이언트

Cursor, Windsurf 등 기타 MCP 호환 클라이언트도 VMark의 MCP 서버에 연결할 수 있습니다. MCP 서버 바이너리 경로를 지정하여 수동으로 구성하세요 (아래 수동 설정 참조).

CC-Switch

CC-Switch로 AI CLI를 관리한다면, 설치 화면에 CC-Switch 행도 표시됩니다. CC-Switch에 추가 는 VMark의 MCP 서버 — 그 바이너리 경로 — 를 CC-Switch에 넘기는 ccswitch://v1/import 링크를 엽니다. 그러면 CC-Switch가 그곳에서 관리하는 CLI에 vmark 항목을 기록합니다. 링크를 직접 붙여 넣고 싶다면 복사 버튼으로 링크 자체를 가져올 수 있습니다. 이 행은 VMark가 자체 MCP 바이너리를 확인할 때까지 비활성화됩니다.

상태 아이콘

각 제공자에 상태 표시기가 표시됩니다:

아이콘	상태	의미
✓ 초록	유효	설정이 올바르고 작동 중
⚠ 황색	경로 불일치	VMark가 이동됨 — 복구 클릭
✗ 빨강	바이너리 없음	MCP 바이너리를 찾을 수 없음 — VMark 재설치
🗎 빨강	설정 읽기 불가	VMark가 설정 파일을 읽거나 파싱할 수 없어, VMark 항목이 있는지 알 수 없음. 메시지에 파일과 이유가 표시됩니다. 파일을 수정하거나 옮긴 다음 다시 확인 을 클릭하세요 — 파싱될 때까지 설치와 복구는 보류됩니다. VMark가 읽을 수 없는 파일에 쓰면 내용이 손상될 위험이 있기 때문입니다
○ 회색	미설정	설치되지 않음 — 설치 클릭

VMark를 이동했나요?

VMark.app을 다른 위치로 이동하면 상태가 황색 "경로 불일치"로 표시됩니다. 복구 버튼을 클릭하기만 하면 새 경로로 설정이 업데이트됩니다.

3. AI 어시스턴트 재시작

설치 또는 복구 후, AI 어시스턴트를 완전히 재시작 하세요 (종료 후 다시 열기). 새 설정을 로드합니다. VMark는 각 설정 변경 후 알림을 표시합니다.

4. 사용해 보기

AI 어시스턴트에서 다음과 같은 명령을 시도해 보세요:

"VMark 문서에 무엇이 있나요?"
"양자 컴퓨팅 요약을 VMark에 작성해 주세요"
"문서에 목차를 추가해 주세요"

실제 사용 예시

Claude에게 질문하고 답변을 VMark 문서에 직접 작성하도록 합니다:

Claude Desktop이 document → set_content를 호출하여 VMark에 씁니다

콘텐츠가 VMark에 즉시 나타나며 완전히 서식이 적용됩니다

수동 설정

수동으로 설정하려면 다음 설정 파일 위치를 참조하세요:

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)를 편집합니다:

json

{
  "mcpServers": {
    "vmark": {
      "command": "/Applications/VMark.app/Contents/MacOS/vmark-mcp-server"
    }
  }
}

Claude Code

~/.claude.json 또는 프로젝트의 .mcp.json을 편집합니다:

json

{
  "mcpServers": {
    "vmark": {
      "command": "/Applications/VMark.app/Contents/MacOS/vmark-mcp-server"
    }
  }
}

Codex CLI

~/.codex/config.toml을 편집합니다:

toml

[mcp_servers.vmark]
command = "/Applications/VMark.app/Contents/MacOS/vmark-mcp-server"

Antigravity CLI

~/.gemini/config/mcp_config.json을 편집합니다:

json

{
  "mcpServers": {
    "vmark": {
      "command": "/Applications/VMark.app/Contents/MacOS/vmark-mcp-server"
    }
  }
}

Grok CLI

~/.grok/config.toml을 편집합니다:

toml

[mcp_servers.vmark]
command = "/Applications/VMark.app/Contents/MacOS/vmark-mcp-server"

opencode

~/.config/opencode/opencode.json을 편집합니다. opencode의 스키마는 mcpServers 스키마와 다릅니다: 키는 mcp이고, command는 프로그램과 그 인수를 담은 하나의 배열입니다:

json

{
  "mcp": {
    "vmark": {
      "type": "local",
      "command": ["/Applications/VMark.app/Contents/MacOS/vmark-mcp-server"],
      "enabled": true
    }
  }
}

직접 작성한 설정이 opencode.jsonc에 있다면 그대로 두세요 — opencode는 두 파일을 병합하므로, opencode.json의 VMark 항목은 추가로 더해집니다. VMark가 일반 JSON 파일에 쓰는 이유는 .jsonc 파일의 주석을 보존한 채로 다시 쓸 수 없기 때문입니다.

opencode.jsonc에 이미 있는 vmark 항목이 우선합니다

opencode는 config.json, opencode.json, opencode.jsonc 순서로 병합하며, 마지막에 읽은 파일이 우선합니다. 따라서 이전에 opencode.jsonc에 vmark 항목을 직접 추가했다면, 그 항목이 VMark가 관리하는 항목을 재정의합니다 — VMark는 제공자를 유효하다고 보고하지만 opencode는 계속 예전 항목 (과 그 오래된 바이너리 경로) 을 사용합니다. 직접 작성한 mcp.vmark 블록을 opencode.jsonc에서 삭제하고 통합 패널이 관리하도록 하세요.

바이너리 경로 찾기

macOS에서 MCP 서버 바이너리는 VMark.app 내부에 있습니다:

VMark.app/Contents/MacOS/vmark-mcp-server

Windows:

C:\Program Files\VMark\vmark-mcp-server.exe

Linux:

/usr/bin/vmark-mcp-server (또는 설치 위치)

포트는 자동으로 검색됩니다 — args는 필요하지 않습니다.

CLI 플래그 (고급)

MCP 서버 바이너리는 진단 및 레거시 설정을 위한 몇 가지 플래그를 지원합니다:

플래그	설명
`--version` (또는 `-v`)	버전을 출력하고 종료합니다 (실행 중인 VMark 와 일치해야 합니다).
`--health-check`	바이너리의 자가 테스트를 실행하고 종료합니다: 내장된 모의 브리지를 대상으로 MCP 서버를 시작하고, 버전과 도구 개수를 JSON으로 출력하며, 도구 개수가 이 빌드의 예상과 다르면 0이 아닌 코드로 종료합니다. 실행 중인 VMark에는 연결하지 않습니다 — 바이너리가 실행되는지 확인할 때 사용하고, 실제 브리지 상태는 설정 → 통합 에서 확인하세요.
`--port <번호>`	수동 포트 재정의. 자동 검색 핸드셰이크를 건너뛰고 지정된 포트에 연결합니다. 브리지 포트가 외부에서 고정된 레거시 설정에서만 유용합니다. 자동 검색 방식을 권장합니다.

예시:

bash

vmark-mcp-server --health-check
vmark-mcp-server --version
vmark-mcp-server --port 9223   # 레거시 / 수동

그 밖의 인수(철자가 틀린 플래그, --port=9223, 불필요한 단어 등)는 거부됩니다. 프로그램은 사용법 오류를 출력하고 자동 검색으로 넘어가지 않고 종료 코드 64로 종료합니다.

작동 방식

text

AI 어시스턴트 <--stdio--> MCP 서버 <--WebSocket--> VMark 에디터

VMark가 WebSocket 브리지를 시작 합니다 — 실행 시 사용 가능한 포트에서
MCP 서버 가 VMark의 앱 데이터 디렉터리에서 포트와 인증 토큰을 읽습니다
MCP 서버 가 WebSocket 브리지를 통해 연결 및 인증합니다
AI 어시스턴트 는 stdio를 통해 MCP 서버와 통신합니다
명령이 브리지를 통해 VMark 에디터로 전달됩니다

사용 가능한 기능

연결되면 AI 어시스턴트는 열 가지 도구를 사용할 수 있습니다:

도구	다루는 범위
`session`	창, 탭, 활성 문서, 브라우저 탭 (읽기 전용)
`workspace`	새로 만들기, 열기, 저장, 다른 이름으로 저장, 닫기, 탭 전환, 창 포커스, 워크스페이스 열기
`document`	문서 전체를 Markdown으로 읽고 쓰기, CJK 서식 변환
`selection`	선택한 텍스트 읽기 및 바꾸기
`comments`	문서의 검토 댓글 나열, 답글 달기, 처리됨으로 표시 (어시스턴트는 해결할 수 없음)
`workflow`	GitHub Actions YAML용 CST 안전 패치와 유효성 검사
`browser` / `browser_read`	macOS의 내장 브라우저 자동화 — 변경 작업과 읽기 전용 작업의 두 부분
`coherence` / `coherence_resolve`	정합성 계층 읽기, 사용자가 부여한 위임 범위에서 오래된 연결 해결

서식은 별도의 도구가 아닙니다: 어시스턴트가 Markdown을 작성하므로, 제목, 표, 수식, 다이어그램은 어시스턴트가 작성하는 그대로입니다.

전체 문서는 MCP 도구 참조를 참조하세요.

MCP 상태 확인

VMark는 MCP 서버 상태를 확인하는 여러 방법을 제공합니다:

상태 표시줄 표시기

상태 표시줄 오른쪽에 MCP 표시기가 표시됩니다. 주의가 필요한 상황이면 위성 아이콘 옆에 짧은 상태 단어가 나타나고, 정상 연결일 때는 초록 아이콘만 표시됩니다. 마우스를 올리면 현재 연결된 AI 클라이언트가 이름과 버전과 함께 나열됩니다:

색상	단어	상태
초록	—	연결됨 및 실행 중
회색	`off`	연결 끊김 또는 중지됨
깜빡임 (애니메이션)	`…`	시작 중
빨강	`error`	서버 실패 — 마우스를 올려 이유 확인

시작은 보통 1-2초 내에 완료됩니다.

표시기를 클릭하면 설정 → 통합 이 열립니다.

설정 패널

설정 → 통합 이 또 하나의 상태 확인 화면입니다 — 별도의 상태 대화상자는 없습니다. 브리지가 실행 중이면 수신 대기 중인 주소 (localhost:<port>, 복사 버튼 포함) 와 연결된 AI 클라이언트 수가 표시되며, 몇 초마다 갱신됩니다. 연결 테스트 버튼 (브리지가 중지된 동안에는 사이드카 확인 으로 표시됨) 은 사이드카 자체의 --health-check를 실행하고 사이드카 버전, 도구 개수, 마지막 확인 시간을 보고합니다 — 설치된 바이너리가 동작하는지를 확인할 뿐, 클라이언트가 연결되어 있는지를 확인하지는 않습니다.

문제 해결

"연결 거부" 또는 "활성 에디터 없음"

VMark가 실행 중이고 문서가 열려 있는지 확인합니다
설정 → 통합에서 MCP 서버가 활성화되어 있는지 확인합니다
MCP 브리지가 "실행 중" 상태인지 확인합니다
연결이 끊어진 경우 VMark를 재시작합니다

VMark 이동 후 경로 불일치

VMark.app을 다른 위치로 이동한 경우 (예: 다운로드에서 응용 프로그램으로), 설정이 이전 경로를 가리킵니다:

설정 → 통합 을 엽니다
영향을 받는 제공자 옆의 황색 ⚠ 경고 아이콘을 찾습니다
복구 를 클릭하여 경로를 업데이트합니다
AI 어시스턴트를 재시작합니다

AI 어시스턴트에 도구가 표시되지 않음

설정 설치 후 AI 어시스턴트를 재시작합니다
설정이 설치되었는지 확인합니다 (설정에서 초록 체크 표시 확인)
AI 어시스턴트의 로그에서 MCP 연결 오류를 확인합니다

"활성 에디터 없음"으로 명령 실패

VMark에서 문서 탭이 활성 상태인지 확인합니다
에디터 영역을 클릭하여 포커스를 줍니다
일부 명령은 먼저 텍스트를 선택해야 합니다

편집 작동 방식

간소화된 MCP 인터페이스는 읽기-쓰기 흐름을 따릅니다: AI 어시스턴트는 document.read를 호출해 현재 내용과 리비전 토큰을 받고, 이를 바탕으로 판단한 다음, 새 전체 내용으로 document.write를 호출합니다. 리비전 토큰은 모르는 사이에 덮어쓰는 것을 막아 줍니다: AI가 생각하는 동안 VMark에서 입력했다면, 쓰기는 STALE을 반환하고 AI는 다시 읽습니다.

GitHub Actions 워크플로우 YAML 파일에는 AI가 대신 workflow.apply_patch를 사용합니다 — VMark의 CST 인식 변경기는 원시 텍스트 재작성으로는 잃어버릴 주석, 앵커, 키 순서를 보존합니다.

document.write, selection.set, workflow.apply_patch에는 미리보기 단계가 없습니다 — 리비전 검사를 통과하는 즉시 변경 사항이 에디터에 반영됩니다. 안전망은 아래의 편집 체크포인트 기록입니다. 반영되기 전에 검토하고 싶다면 문서를 git으로 관리하고 diff를 검토하세요. 유일한 승인 게이트는 새 위치로 저장 및 지니 결과 자동 승인 입니다: 이 설정이 꺼져 있으면 (기본값) AI는 문서를 새 경로에 저장할 수 없습니다 — workspace.save_as는 APPROVAL_REQUIRED를 반환하고 VMark는 파일 이름을 알려 주는 토스트를 표시합니다. 설정이 켜져 있어도 save_as는 이미 존재하는 다른 파일을 덮어쓰지 않습니다.

편집 체크포인트

AI가 문서를 수정하는 모든 작업 — document.write, document.transform, selection.set, workflow.apply_patch — 은 무엇이든 바꾸기 전에 VMark의 편집 기록에 기록됩니다. 상태 표시줄의 기록 버튼은 포커스된 문서의 패널을 엽니다. 배지는 문서의 AI 버전 수를 보여 주며, 변경 사항이 기록되지 않을 때는 버튼이 경고 색으로 바뀝니다. 패널은 버전이 기록될 때마다 모든 창에서 실시간으로 갱신됩니다.

패널에는 문서의 버전이 최신순으로 나열됩니다. 각 행에는 시각, 변경 종류, 도구, 그리고 누가 했는지 — AI 클라이언트의 제공자(예: claude 또는 codex), 연결, 세션 레이블 — 가 표시됩니다. 토큰이 없는 클라이언트는 식별되지 않은 클라이언트, 알 수 없는 토큰은 인식되지 않은 자격 증명, 여러 클라이언트가 공유하는 토큰은 여러 공급자가 공유하는 자격 증명 으로 표시되며, 클라이언트가 어떤 이름을 쓰든 제공자로 표시되지 않습니다. 이 버전 복원 은 그 버전의 텍스트로 되돌리고, 이 변경 이전 상태로 복원 은 그 이전의 텍스트로 되돌립니다. 복원하면 문서의 리비전이 올라가므로, 이전 리비전을 가진 AI 클라이언트는 다음 쓰기에서 복원을 덮어쓰는 대신 STALE 을 받습니다. 복원 자체도 기록됩니다. 대체되는 텍스트가 먼저 보관되며, 복원 도중 편집된 문서는 건드리지 않습니다. 복원 기록이 디스크에 저장되었는지 VMark가 확인하지 못하면 결과 옆에 경고를 표시합니다.

버전 목록 위의 AI 변경 사항 검토 에는 아직 검토하지 않은 AI 변경 사항이 클라이언트와 세션별로 묶여 표시됩니다. 변경 사항이 모두 검토된 버전은 개수로만 요약됩니다. 각 변경 사항에는 유지 와 되돌리기 가 있고, 그 뒤에는 유지 취소 나 되돌리기 취소 를 쓸 수 있습니다. 그 사이에 편집한 텍스트를 덮어쓰게 될 되돌리기는 적용되지 않으며, 변경 사항은 충돌로 표시됩니다. 직접 해결한 뒤 처리됨으로 표시 로 기록합니다. 위치를 더 이상 확인할 수 없는 변경 사항은 이유를 보여 주며 자동 되돌리기를 제공하지 않습니다. 검토 완료 정리 는 확인을 거친 뒤 검토된 변경 사항을 모두 영구히 정리하며, 이는 취소할 수 없습니다. 한 문서는 검토되지 않은 AI 변경 사항을 최대 500개까지 가질 수 있습니다. 한도에 이르면 배너가 알려 주고, 검토하고 정리할 때까지 AI 편집은 REVIEW_BACKLOG_FULL 로 거부됩니다. 바로 앞과 다른 버전에서 시작한 저장 — 문서가 두 창에서 편집된 경우 — 은 그렇게 표시되며, 병합을 취소할 수 있도록 두 복원이 모두 제공됩니다. 두 변경 사항 모두 보기를 누르면 그 저장의 차이 두 개가 열립니다. 이 저장이 시작된 버전과 비교는 이 저장이 시작된 버전과의 차이, 이전 버전과 비교는 기록에서 바로 앞 버전과의 차이입니다.

그다음 댓글에는 문서의 댓글 스레드가 있습니다. 선택 영역에 댓글 달기는 편집기에서 선택한 텍스트(커서만 있으면 커서가 있는 단락)를 인용해 댓글을 추가합니다. 저장하지 않은 텍스트가 먼저 기록되므로 댓글이 이전 버전을 가리키는 일은 없습니다. 각 스레드에는 상태(열림, 처리됨, 해결됨, 다시 열림), 작성자, 인용한 텍스트와 답글이 표시됩니다. 댓글은 일반 텍스트로 표시되며, 댓글 속 HTML은 표시될 뿐 실행되지 않습니다. 인용한 텍스트가 이제 여러 번 나타나면 스레드가 그 횟수를, 사라졌으면 그 사실을 알려 줍니다. 어떤 상태에서든 답글을 달 수 있고, 열림 또는 다시 열림 스레드는 처리됨으로 표시하거나 해결할 수 있으며, 해결된 스레드는 다시 열기 또는 삭제할 수 있습니다. 삭제는 먼저 확인을 받으며 되돌릴 수 없습니다. 댓글이나 답글을 보내는 동안에는 패널을 닫았다가 다시 열어도 편집하거나 취소할 수 없습니다. 거부된 것은 남아 있으므로 고쳐서 다시 보낼 수 있습니다. 스레드를 해결하거나 다시 열거나 삭제할 수 있는 사람은 사용자뿐입니다. 원래 리비전이 기록에서 지워진 뒤 다시 연 스레드에는 생성 시점의 리비전이 더 이상 보관되지 않음이 표시되며 현재 텍스트와 대조됩니다.

패널 상단은 변경 사항이 기록되지 않을 때 이를 알려 줍니다. 기록을 시작하지 못했거나 읽기 전용인 경우, 기록이 밀려 있는 경우(대기 중이며 아직 디스크에 없음), 이 문서의 마지막 저장이 거부되었거나 기록이 제때 응답하지 않은 경우, 열린 페이지가 너무 많은 창에서 AI 편집이 거부된 경우, 또는 일부 AI 변경을 더 이상 자동으로 되돌릴 수 없는 경우입니다. 변경된 범위를 확인할 수 없어 문서 전체 변경으로 기록된 AI 편집의 수도 표시합니다. 더 이상 자동으로 되돌릴 수 없는 변경은 위치가 마지막으로 확인된 버전 아래에 차단됨: 이유(출처) 로 표시되고, 그 버전은 강조됩니다. 해당 버전이 없으면 패널은 위치를 알 수 없다고 표시합니다. 적용되었지만 기록되지 않은 쓰기는 기록되지 않은 쓰기 아래에 각각 복원과 삭제 작업과 함께 표시됩니다.

한 클라이언트의 여러 세션을 구분하려면 클라이언트의 MCP 설정에서 VMARK_MCP_TOKEN 옆에 VMARK_SESSION_LABEL 을 설정하세요.

json

"env": { "VMARK_MCP_TOKEN": "…", "VMARK_SESSION_LABEL": "docs refactor" }

레이블은 최대 128 UTF-8 바이트이며 제어 문자를 포함할 수 없습니다. 규칙을 어긴 레이블은 경고와 함께 버려지고 클라이언트는 레이블 없이 연결합니다. 레이블은 클라이언트 설정이 정하므로 표시용일 뿐이며 아무것도 결정하지 않습니다.

기록은 VMark 앱 데이터 디렉터리의 agent-journal 폴더에 저장되므로 재시작 후에도 남습니다. 이 폴더에는 기록된 각 편집 직전의 전체 텍스트가 담겨 있으며 소유자만 접근할 수 있습니다(macOS와 Linux에서 0700). 이전 버전 VMark의 체크포인트(첫 실행 시 가져온 뒤 이름을 바꿔 보관하는 mcp-checkpoints.jsonl)는 이전 체크포인트 아래에 모든 문서와 창을 아우르는 하나의 목록으로 표시됩니다. 하나를 복원하면 그 파일이 열리며, 제목 없는 것이나 파일을 더 이상 열 수 없는 것은 새 문서로 복원됩니다. 이 섹션은 보관 중인 체크포인트 텍스트의 양을 보여 주고, 모든 것 — 각 파일과 각 창 — 을 한 번에 지우며 텍스트를 디스크에서 삭제합니다.

보안 참고 사항

MCP 서버는 로컬 연결만 허용합니다 (localhost)
외부 서버로 데이터가 전송되지 않습니다
AI 파일 작업은 열린 워크스페이스 루트와 열린 문서의 폴더로 제한됩니다 — 개인 정보 보호 참조
모든 처리가 사용자 머신에서 이루어집니다
WebSocket 브리지는 로컬에서만 접근 가능합니다
설치된 각 클라이언트는 자체 VMARK_MCP_TOKEN을 가집니다. 토큰이 없거나, 알 수 없는 토큰이거나, 다른 클라이언트와 공유하는 토큰을 가진 클라이언트도 연결은 되지만, 위임된 작업은 거부되며 설정 → 통합 에서 해당 클라이언트를 설치하고 재시작하라는 메시지가 표시됩니다

다음 단계

사용 가능한 모든 MCP 도구 탐색하기
키보드 단축키 알아보기
다른 기능 확인하기

AI 통합 (MCP) ​

MCP란? ​

빠른 설정 ​

1. MCP 서버 활성화 ​

2. 설정 설치 ​

CC-Switch ​

상태 아이콘 ​

3. AI 어시스턴트 재시작 ​

4. 사용해 보기 ​

실제 사용 예시 ​

수동 설정 ​

Claude Desktop ​

Claude Code ​

Codex CLI ​

Antigravity CLI ​

Grok CLI ​

opencode ​

CLI 플래그 (고급) ​

작동 방식 ​

사용 가능한 기능 ​

MCP 상태 확인 ​

상태 표시줄 표시기 ​

설정 패널 ​

문제 해결 ​

"연결 거부" 또는 "활성 에디터 없음" ​

VMark 이동 후 경로 불일치 ​

AI 어시스턴트에 도구가 표시되지 않음 ​

"활성 에디터 없음"으로 명령 실패 ​

편집 작동 방식 ​

편집 체크포인트 ​

보안 참고 사항 ​

다음 단계 ​

AI 통합 (MCP)

MCP란?

빠른 설정

1. MCP 서버 활성화

2. 설정 설치

CC-Switch

상태 아이콘

3. AI 어시스턴트 재시작

4. 사용해 보기

실제 사용 예시

수동 설정

Claude Desktop

Claude Code

Codex CLI

Antigravity CLI

Grok CLI

opencode

CLI 플래그 (고급)

작동 방식

사용 가능한 기능

MCP 상태 확인

상태 표시줄 표시기

설정 패널

문제 해결

"연결 거부" 또는 "활성 에디터 없음"

VMark 이동 후 경로 불일치

AI 어시스턴트에 도구가 표시되지 않음

"활성 에디터 없음"으로 명령 실패

편집 작동 방식

편집 체크포인트

보안 참고 사항

다음 단계