Claude Code에 제약 없는 이미지 및 비디오 API를 단일 MCP 서버로 제공하는 방법

대부분의 이미지 및 비디오 모델은 자체 계정, SDK 및 결제 페이지 뒤에서 운영되며, 대부분 호스팅되는 API는 그 위에 자체적인 검열(moderation) 계층을 추가합니다. 코딩 에이전트가 작업 중에 제품 사진, 짧은 클립 또는 음성 녹음을 만들도록 하려면, 각 제공업체를 수동으로 연결하는 것은 금방 지루해지며, 요청이 원치 않는 필터에 의해 거부되는 것은 훨씬 더 빨리 지루해집니다.

본 게시물에서는 Claude Code(또는 Cursor, Codex, VS Code 및 기타 MCP 클라이언트)가 200개 이상의 생성 모델을 탐색하고, 요청 가격을 산정하며, 실행할 수 있는 단일 도구를 갖도록 하는 방법을 보여줍니다. 이 과정에서 에이전트는 비용이 발생하기 전에 사용자에게 질문하는 것을 멈춥니다. 이는 제약 없는 AI API인 SpicyAPI의 공식 MCP 서버를 사용합니다: 이 플랫폼은 자체 콘텐츠 필터를 추가하지 않기 때문에, 생성할 수 있는 것은 오직 선택한 모델에만 의존하며, 카탈로그에는 어떤 모델이 검열되지 않았는지 표시되어 있습니다.

준비물

• Node.js 22.13 이상 (node --version).
• SpicyAPI API 키. API keys 페이지에서 생성합니다. 키는 sk-spicy-로 시작하며 한 번만 표시됩니다. Advanced 설정에서 해당 키에 일일 제한을 설정하거나 특정 모델로 제한할 수 있는데, 이는 에이전트가 사용할 키에는 좋은 생각입니다.
• 유료 실행을 위한 계정 잔액. 모델 탐색, 가격 견적 및 결과 읽기는 무료입니다.

서버를 Claude Code에 추가하기

명령어를 실행할 터미널에서 키를 내보낸 다음, 서버를 등록합니다:

export SPICY_API_KEY="sk-spicy-..."

claude mcp add spicyapi \
...

--package 플래그가 중요합니다: 패키지는 두 개의 바이너리를 배포하므로, 단순히 npx @spicyapi/mcp로는 어떤 것을 실행해야 하는지 알 수 없습니다.

claude mcp list 또는 세션 내의 /mcp로 확인하세요. 모든 프로젝트에서 사용하려면 --scope user를 추가하고, 저장소에 .mcp.json 파일로 키가 기록되는 --scope project는 피하십시오.

또는 Cursor에 추가하기

Cursor는 ~/.cursor/mcp.json을 읽습니다 (Windsurf 및 Gemini CLI는 자체 파일에서 동일한 형태를 사용합니다):

{
  "mcpServers": {
    "spicyapi": {
...

이 내용은 프로젝트 파일에 커밋되지 않는 사용자 레벨 파일에 보관하세요.

첫 세 가지 프롬프트 (모두 무료)

1. "SpicyAPI 서비스 상태 확인." 이 도구는 키가 필요 없으므로 서버가 시작됨을 증명합니다.
2. "제 SpicyAPI 잔액은 얼마인가요?" 키가 서버에 도달함을 증명합니다.
3. "어떤 SpicyAPI 도구들이 있나요?" spicyapi_로 접두사가 붙은 15개의 도구를 볼 수 있어야 합니다.

그다음 실제 요청하기

제가 호출할 수 있는 이미지 모델 목록을 나열하고, 저렴한 것을 골라 시네마틱한 야경 초상화를 생성한 다음, 완료되면 결과 링크를 주세요.

백그라운드에서 에이전트는:

1. 실시간 카탈로그와 선택된 모델의 입력 스키마를 읽습니다;
2. 정확한 USD 견적을 받습니다;
3. 멈추고 추정치와 최대 청구 금액에 대해 사용자에게 확인을 요청합니다;
4. 작업을 생성하고, 기다린 후 결과 링크를 반환합니다.

잘 작동하는 몇 가지 추가 예시:

• "이미지를 비디오로 변환하는 모델을 찾고, 각 모델에서 5초 클립 비용을 비교해 주세요." (카탈로그 및 견적 포함, 무료)
• "~/Desktop/product.jpg 파일을 느린 푸시인 효과가 들어간 5초 비디오로 만들어 주세요." (파일 업로드 후 확인된 작업 생성)
• "지난 3일 동안 실패한 제 작업을 보여주고, 그 이유를 알려주세요."

에이전트가 스스로 비용을 지불할 수 없는 이유

유료 도구는 MCP **엘리시테이션(elicitation)**을 사용합니다. 확인 과정은 모델에 의해 생성되는 것이 아니라 사용자 클라이언트에서 렌더링되어 사용자로부터 답변을 받아야 합니다. 이 답변은 정확한 요청에 바인딩되므로, 질문 후에 모델이나 입력이 변경되면 아무것도 생성되지 않습니다. 거절한다는 것은 작업도 없고, 보류도 없고, 청구도 없다는 의미입니다. 견적은 5분 동안 유효하며, 엘리시테이션을 지원하지 않는 클라이언트는 유료 작업을 만들 수 없습니다. 읽기 전용 도구는 여전히 작동합니다.

로컬 파일 및 결과

로컬 파일 및 결과

spicyapi_upload_file은 절대 경로를 받아 파일을 업로드하고, 에이전트가 모델에 전달할 수 있는 spicy:// URI를 반환합니다. 기본적으로 이 함수는 사용자의 홈 디렉토리 내에서만 읽기 때문에, 웹 페이지나 이메일을 통해 주입된 경로로부터 사용자 보호 기능을 제공합니다. 결과물은 바로 사용할 수 있는 링크 형태로 돌아오며, 생성된 파일은 약 14일 동안 보관되므로 필요한 것은 모두 다운로드하여 보관하세요.

링크

• 웹사이트 및 모델 카탈로그: spicyapi.ai
• 전체 MCP 가이드: docs.spicyapi.ai/docs/mcp
• 소스 코드: github.com/spicyapi-ai/spicy-mcp
• 에이전트가 권장되는 워크플로우를 알기를 원한다면, 에이전트 스킬을 추가할 수 있습니다: npx skills add spicyapi-ai/spicy-skill