MCP — AI 에이전트 붙이기

Claude 같은 에이전트가 이 편집기를 직접 조작합니다.

로그인하면 photovim.com 에서도 붙습니다. 아래에서 연결 코드를 받아 자기 컴퓨터에서 한 줄만 실행하면 됩니다. 코드는 몇 분만 살고, 그 코드로 본인 탭에만 붙습니다.

무엇이 다른가

에이전트가 만든 것이 한 장짜리 그림이 아니라 편집할 수 있는 문서로 남습니다.

글자는 문자 레이어, 배경은 배경 레이어로 들어옵니다. 문구만 바꾸거나 색만 고치는 일이 그 자리에서 됩니다.
에이전트가 한 일도 되돌리기 한 칸입니다. 마음에 안 들면 Ctrl+Z 로 돌아갑니다.
새 창이 아니라 지금 보고 있는 탭에서 돕니다. 같은 문서, 같은 되돌리기입니다.

연결 코드 받기

편집기 탭을 열어 둔 채 코드를 받고, 아래 줄을 자기 컴퓨터 터미널에 붙여 넣으세요. 코드는 몇 분 뒤 만료됩니다.

로그인하고 코드 받기

설치 없이 붙기 (원격)

캔바·피그마처럼 주소 하나로 붙습니다. Node 도 필요 없습니다. Claude Code 는 아래 한 줄이면 되고, 코드를 받으면 자리가 채워집니다.

claude mcp add --transport http photovim https://photovim.com/mcp --header "Authorization: Bearer 연결 코드"

다른 클라이언트는 주소 https://photovim.com/mcp 에 Authorization: Bearer 코드 머리글을 붙이거나, 머리글을 못 붙이면 https://photovim.com/mcp/코드 로 붙습니다. 원격에서는 open_file 이 없고(남의 컴퓨터 경로), export 는 png/jpg/webp 만 그림으로 돌려줍니다.

설치해서 붙기 (npx)

아래를 클라이언트의 MCP 설정 파일에 넣으세요. Node 22 이상이 있으면 됩니다 — 설치할 것은 없습니다. 위에서 코드를 받으면 코드 자리가 채워집니다.

{
  "mcpServers": {
    "photovim": {
      "command": "npx",
      "args": ["-y", "@photovim/mcp", "--url", "wss://photovim.com/cable", "--code", "연결 코드"]
    }
  }
}

클라이언트별

Claude Code: 작업 폴더의 .mcp.json 에 넣거나 claude mcp add photovim -- npx -y @photovim/mcp --url … --code … 로 더합니다.
Claude Desktop · Cursor: 설정 파일(claude_desktop_config.json)의 mcpServers 아래에 그대로 넣고 Claude Desktop 을 다시 켭니다.
Codex: 같은 설정을 ~/.codex/config.toml 의 [mcp_servers.photovim] 에 command·args 로 적습니다.

붙었는지 보는 법

편집기 메뉴줄 도움말 오른쪽의 「MCP」 를 보세요. 단추 안의 점이 지금 상태입니다.

초록 — 붙었습니다. 에이전트가 부리면 누가 부렸는지 이름도 나옵니다.
노랑 — 붙는 중이거나 줄이 끊겨 다시 붙는 중입니다.
빨강 — 방에 못 들어갔습니다. 열쇠나 서버를 보세요.

지금 되는 것

문서 열기·저장, 선택, 레이어 만들기·배치·변형·조정, 글자 넣기·고치기, 붓으로 한 획씩 그리기, 배경 제거, 피사체 선택, AI 생성, 되돌리기 등 34가지입니다.

도구	하는 일	갈래
붙기
`list_tabs`	열려 있는 편집기 탭 명단	읽기
`attach`	편집기 탭에 붙는다 — 이후 도구가 그 탭(같은 문서·같은 되돌리기)에서 돈다	고르기
`get_capabilities`	이 편집기가 지금 할 수 있는 것 — 형식·조정 이름·모델	읽기
문서
`open_file`	이미지·PSD·.photovim·TIFF 를 새 탭으로 연다	바꿈 (되돌리기에 남음)
`new_document`	빈 문서를 만든다	바꿈 (되돌리기에 남음)
`list_documents`	열려 있는 문서(탭) 목록	읽기
`select_document`	문서(탭)를 고른다	고르기
`export`	문서를 파일로 저장한다 (.png .jpg .webp .psd .photovim)	읽기
보기
`get_state`	문서 상태 — 크기·변경 번호·레이어 트리·선택·되돌리기 깊이	읽기
`list_layers`	레이어 목록과 상태 (get_state 와 같다)	읽기
`screenshot`	지금 합성 결과를 PNG 로	읽기
선택
`rect_select`	사각형 선택 영역 (문서 좌표)	고르기
`select_subject`	피사체를 브라우저 안 모델로 찾아 선택 (사진이 밖으로 안 나간다)	고르기
`deselect`	선택 해제	고르기
`selection_to_mask`	선택 영역을 활성 레이어의 마스크로	바꿈 (되돌리기에 남음)
레이어
`select_layer`	레이어 하나를 활성으로 (id 또는 index)	고르기
`add_layer`	빈 레이어를 맨 위에 더한다	바꿈 (되돌리기에 남음)
`set_layer_props`	레이어 이름·보임·불투명도·혼합 모드	바꿈 (되돌리기에 남음)
`move_layer`	레이어를 옮긴다 (상대 dx/dy 또는 절대 x/y)	바꿈 (되돌리기에 남음)
`reorder_layer`	레이어 차례를 바꾼다	바꿈 (되돌리기에 남음)
`transform_layer`	레이어를 키우거나 돌린다 (글자·스마트 오브젝트는 값으로 남는다)	바꿈 (되돌리기에 남음)
그림·조정
`fill_selection`	선택 영역(없으면 레이어 전체)을 색으로 채운다 — 글자·모양·스마트 오브젝트는 rasterize: true 를 줘야 굳히고 칠한다	바꿈 (되돌리기에 남음)
`paint_strokes`	붓으로 한 획씩 그린다 (점·색·크기·불투명도·경도) — 그리는 모습이 편집기에 보인다	바꿈 (되돌리기에 남음)
`apply_adjustment`	조정을 활성 레이어에 건다 (밝기·레벨·곡선·색조 등) — 글자·모양 레이어는 rasterize: true 를 줘야 굳히고 건다, 스마트 오브젝트는 고급 필터로 쌓인다	바꿈 (되돌리기에 남음)
`remove_background`	배경을 브라우저 안 모델로 지운다	바꿈 (되돌리기에 남음)
`resize_image`	이미지 크기를 바꾼다 (모든 레이어 함께)	바꿈 (되돌리기에 남음)
`crop`	문서를 사각형으로 잘라낸다	바꿈 (되돌리기에 남음)
글자
`add_text`	글자 레이어를 만든다	바꿈 (되돌리기에 남음)
`edit_text`	글자 레이어의 내용·자리·서식을 고친다	바꿈 (되돌리기에 남음)
AI 생성
`list_ai_models`	AI 생성에 쓸 수 있는 모델과 한 번에 드는 크레딧, 남은 크레딧	읽기
`generate_image`	AI 로 고치기(선택 영역·그림 전체)·글로 새 그림 만들기·지우기 — 결과는 새 레이어. 크레딧 모델이면 크레딧이 빠진다	바꿈 (되돌리기에 남음)
`ai_job_status`	오래 걸리는 생성을 이어서 기다리고 결과(새 레이어·쓴 크레딧)를 받는다	읽기
묶음·되돌리기
`batch`	여러 명령을 한 묶음으로 — 되돌리기 한 칸. onError=rollback 이면 실패 시 전부 되돌린다	바꿈 (되돌리기에 남음)
`undo`	마지막 작업을 되돌린다	바꿈 (되돌리기에 남음)

한도

한도는 사람마다 겁니다. 명령 하나가 1회이고, batch 는 안의 단계 수만큼 셉니다. 읽기·쓰기를 가르지 않습니다. 넘으면 그 명령은 바로 「한도에 걸렸다」 는 답을 받습니다.

	지금 (모두)
분당	300회
하루	20,000회
동시에 붙는 에이전트	10개

아직 안 되는 것: 「배너 만들어 줘」 한 마디로 끝나는 결과물 단위 작업은 계획입니다. 지금은 위 34가지를 하나씩 시키는 데까지입니다.

편집기로 돌아가기