에이전트에서 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 키)

커넥터 로그인이 없는 도구(Codex CLI 등)는 키를 씁니다. 마이페이지 › 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 — 최근 결과물과 보유 크레딧.

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.

5. 요금·보안

① 요금은 웹과 같습니다. 1 크레딧 ≈ $0.007. 접수 실패·큐 실패는 자동 환불됩니다. 생성 전에 quote 로 확인할 수 있습니다.

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

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

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

⑤ 문의: 고객지원.