도우미 연결
Claude Code 또는 Codex를 연결하면 평소 대화에서 IceFold 작품을 만들고 편집할 수 있습니다. 결과는 직접 열어 검토하고 편집할 수 있는 같은 캔버스에 표시됩니다. IceFold에서 바로 시작하려면 빠른 시작의 내장 창작 도우미를 사용하세요.
1. 클라이언트 연결
IceFold 계정과 설치된 클라이언트가 필요합니다. 이 안내는 Codex CLI와 Claude Code용이며 Claude 웹이나 데스크톱 앱용이 아닙니다. IceFold Skill, SDK, runner를 추가로 설치할 필요는 없습니다.
원격 MCP 서버는 Streamable HTTP를 사용합니다.
https://api.icefold.com/v1/mcp
Codex CLI
터미널에서 실행하세요.
codex mcp add icefold --url https://api.icefold.com/v1/mcp
codex mcp login icefold --scopes session:read,session:edit,session:run,session:create,session:delete
브라우저에서 IceFold 로그인과 접근 승인을 마친 뒤 Codex로 돌아오세요.
Claude Code
Claude Code를 사용하는 프로젝트 디렉터리에서 실행하세요.
claude mcp add --transport http icefold https://api.icefold.com/v1/mcp
해당 프로젝트에서 Claude Code를 열고 /mcp를 입력한 다음 IceFold를 선택해 브라우저에서 인증하세요. 여러 프로젝트에서 사용하려면 명령에 --scope user를 추가하세요.
2. 접근 범위와 비용 확인
승인 화면에서 접근 가능한 캔버스와 허용할 작업을 확인하세요. 새 연결은 기본적으로 현재와 향후의 모든 캔버스에 30일 동안 접근합니다. 접근·사용량·기간 설정을 펼치면 특정 캔버스만 선택하거나 기간을 줄일 수 있습니다. 영구 삭제는 별도로 허용해야 하며 콘텐츠 제작에는 필요하지 않습니다.
IceFold 생성에는 IceFold 크레딧이 사용되며 도우미 구독과 별개입니다. 연결 허용이 무제한 지출을 뜻하지는 않습니다. 생성 전에 제작 계획과 필요한 비용 승인을 확인하세요. 기존 승인은 허용된 범위 안에서 계속 적용됩니다.
3. 첫 요청 보내기
IceFold에 제품 소개 워크플로를 만들어 주세요. 제품 설명과 광고 대본을 위한 편집 가능한 단계를 준비하되 아직 콘텐츠를 생성하지 마세요. 캔버스 링크를 주세요.
받은 링크를 열어 단계가 만들어졌는지 확인하세요. 워크플로 준비는 미디어 생성 완료를 뜻하지 않습니다. 자료를 추가하고 계획을 검토한 뒤 준비되면 계속해 달라고 요청하세요. 결과 링크와 편집할 캔버스 링크를 받을 수 있습니다.
내장 도우미, 외부 클라이언트, 직접 편집 모두 같은 워크플로 규칙을 따릅니다. 검토 설정과 고정된 출력도 유지됩니다. 브라우저에서 다른 캔버스를 열어도 외부 도우미의 작업 대상은 바뀌지 않습니다. 작업을 바꿀 때 작품 이름이나 캔버스 링크를 알려 주세요.
연결 관리와 문제 해결
- 읽기만 가능: 다시 연결하고 대상 캔버스의 편집·생성·캔버스 만들기를 허용하세요.
- 만료 또는 연결 끊김: 위 클라이언트 단계로 다시 인증하세요.
- 자료 누락: 원본 파일 업로드를 요청하세요. 클라이언트가 전송할 수 없다면 IceFold에서 업로드하고 캔버스 링크를 전달하세요.
- 접근 중단: 계정 설정의 에이전트 연결 패널에서 연결을 취소하세요. 캔버스 빈 공간의 컨텍스트 메뉴에서도 해당 캔버스의 연결을 관리할 수 있습니다.
클라이언트 설정: Codex MCP 문서, Claude Code MCP 문서.