에이전트에서 ARIFE 쓰기 (MCP)

1. 연결하기 (커넥터)

① 에이전트의 커넥터 설정에 서버 주소 https://arifeart.kr/api/mcp 를 넣습니다. 키를 복사할 필요가 없습니다 — 연결하면 ARIFE 로그인 창이 뜨고, 승인하면 바로 붙습니다.

② Claude 앱·웹: 설정 › 커넥터 › 「커스텀 커넥터 추가」에서 이름(예: ARIFE)과 위 주소를 넣습니다.

③ Claude Code: claude mcp add --transport http arife https://arifeart.kr/api/mcp 실행 후 /mcp 로 로그인합니다.

④ Cursor: 설정 › MCP 에서 같은 주소를 넣고 뜨는 로그인 창에서 승인합니다.

⑤ 연결된 에이전트는 마이페이지 › MCP 연결 에서 보고, 언제든 끊을 수 있습니다.

2. 자동화에서 붙이기 (API 키)

Claude · Codex · Cursor 는 위의 1번 커넥터로 붙이시면 됩니다 — 주소만 넣으면 로그인·승인으로 끝나고, 키를 따로 보관할 일이 없어 더 안전합니다. 이 아래는 사람이 로그인 창을 누를 수 없는 것 — 서버에서 도는 스크립트·크론·자동화 — 에만 쓰는 길입니다.

마이페이지 › MCP 연결 의 「고급 · 자동화에서 붙이기」를 펼치고 「새 키 만들기」를 누르면 키(arife_sk_…)가 그 순간 한 번만 보입니다. 복사해 두세요. 키는 5개까지, 언제든 폐기할 수 있고 폐기하면 그 키로 붙은 에이전트는 바로 끊깁니다.

서버 주소는 https://arifeart.kr/api/mcp, 전송 방식은 MCP Streamable HTTP, 인증은 Authorization: Bearer 키 입니다.

Codex CLI — ~/.codex/config.toml

[mcp_servers.arife]
url = "https://arifeart.kr/api/mcp"
http_headers = { Authorization = "Bearer arife_sk_여기에_키" }

Claude Code (키 방식)

claude mcp add --transport http arife https://arifeart.kr/api/mcp --header "Authorization: Bearer arife_sk_여기에_키"

Cursor · 기타 — mcp.json

{ "mcpServers": { "arife": { "url": "https://arifeart.kr/api/mcp", "headers": { "Authorization": "Bearer arife_sk_여기에_키" } } } }

연결이 되면 에이전트가 list_models 부터 부릅니다. 한국어로 "시댄스 2.5로 노을 해변 5초 만들어 줘" 처럼 말하면 됩니다.

3. 도구 목록

① list_models — 쓸 수 있는 영상·이미지 모델과 요금(크레딧/초, 장당), 허용 해상도·길이.

② quote — 영상 예상 크레딧(차감 없음).

③ generate_video — 글→영상, 이미지→영상(image_url), 영상→영상(video_url: Seedance 2.5 재작화 · Omni 수정 · 렌더→실사 · VACE). 참조 그림(image_urls)과 참조 영상·소리(reference_video_urls · reference_audio_urls)도 받습니다. 기본은 완성까지 기다렸다가 다운로드 주소를 돌려줍니다.

④ video_status — 오래 걸리는 작업을 이어서 확인. 완성되면 내 작품에 넣고 주소를 줍니다.

⑤ generate_image · image_status — 이미지도 같은 방식입니다(참조 그림 4장까지).

⑥ enhance_prompt — 프롬프트 다듬기(무료). 웹의 「프롬프트 다듬기」와 같은 모델·규칙입니다.

⑦ upload — 로컬 파일을 참조로 쓰려면 먼저 올립니다(주소 또는 base64, 25MB).

⑧ library · balance — 최근 결과물과 보유 크레딧.

⑨ dub_video — 영상 번역 · 더빙. 같은 목소리로 다른 나라 말로 바꿉니다(3분 이하 · 언어 3개까지). 입 모양 맞추기(기본 · 고급)를 고르면 더빙이 끝난 뒤 자동으로 이어집니다.

⑩ ad_versions — 광고 영상 한 편 → 인물 · 빛 · 언어 버전을 한 번에(최대 6개).

⑪ conti_video — 콘티 그림 2~10장을 순서대로 이어 한 편의 영상으로(5~20초 · 소리 포함).

⑫ relight_video — 사람 · 동작은 그대로 두고 빛만 바꿉니다(한낮 · 골든아워 · 노을 · 블루아워 · 달빛 · 촛불 · 네온 · 스튜디오).

⑬ search_market · market_item — 마켓 작품 찾기 · 자세히(무료). request_production — 그 작품의 판매자나 ARIFE 운영팀에 제작 의뢰를 보냅니다. 내가 내용을 확인한 뒤에만 보내지고, 내 연락처는 판매자에게 공개되지 않습니다. 구매 · 결제는 사이트에서 직접 합니다.

⑨~⑫ 묶음 도구는 estimate_only 로 먼저 예상 크레딧을 받아 볼 수 있습니다(차감 없음).

4. 예시 대화

"ARIFE에서 쓸 수 있는 영상 모델 보여줘" → 에이전트가 list_models 를 부릅니다.

"이 그림(./char.png)을 캐릭터로 해서 Hailuo 3로 비 오는 골목 8초, 2K로 만들어 줘" → upload → generate_video(image_urls, model: hailuo3, duration 8, resolution 2K).

"블렌더 렌더 ./clay.mp4 를 Seedance 2.5로 실사처럼 다시 그려 줘" → upload → generate_video(video_url, model: seedance25).

"방금 만든 거 내 작품에서 보여줘" → library.

"이 광고(./ad.mp4)를 영어 · 일본어로 더빙하고 입 모양까지 맞춰 줘" → upload → dub_video(target_langs: en, ja, lip: basic).

"이 광고를 모델 사진 2장으로 인물만 바꾼 버전이랑 노을 빛 버전도 만들어 줘" → upload → ad_versions(person_image_urls, lights: sunset).

"콘티 4장(./c1~c4.png)으로 세로 10초 영상 만들어 줘" → upload ×4 → conti_video(image_urls, duration 10, aspect_ratio 9:16).

"마켓에서 화장품 광고 스타일 찾아서 그 판매자한테 우리 제품으로 견적 물어봐 줘" → search_market → market_item → (내용 확인) → request_production.

5. 요금·보안

① 요금은 웹과 같습니다(묶음 도구 포함) — 내 계정의 크레딧에서 차감됩니다. 접수 실패·큐 실패는 자동 환불됩니다. 생성 전에 quote 로 확인할 수 있습니다.

② 프롬프트 다듬기는 무료이며 시간당 횟수 제한이 있습니다. 「아이디어 확장(idea)」만 1 크레딧입니다.

③ 키는 비밀번호처럼 다루세요. 저장소·채팅에 올리지 마세요. 키 원문은 저희도 보관하지 않습니다(해시만 저장).

④ 결과 주소는 7일 동안 유효합니다. 파일은 내 작품에 남아 있으니 언제든 다시 받을 수 있습니다.

⑤ 문의: 고객지원.