하나의 MCP 서버.
130개 이상의 AI 모델.
Claude Code, Cursor, VS Code, Windsurf 등 MCP 호환 호스트를 RunAPI에 연결하세요 — 편집기를 벗어나지 않고 이미지, 비디오, 음악을 생성하고 LLM을 호출할 수 있습니다.
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
export RUNAPI_API_KEY="runapi_xxx"
claude
codex plugin install runapi-mcp@agents
export RUNAPI_API_KEY="runapi_xxx"
codex
npx @runapi.ai/mcp init cursor
export RUNAPI_API_KEY="runapi_xxx"
cursor .
npx @runapi.ai/mcp init windsurf
export RUNAPI_API_KEY="runapi_xxx"
windsurf .
npx @runapi.ai/mcp init vscode
export RUNAPI_API_KEY="runapi_xxx"
code .
npx @runapi.ai/mcp init roo
export RUNAPI_API_KEY="runapi_xxx"
code .
RunAPI MCP 서버란?
RunAPI MCP 서버는 MCP 호환 코딩 도구를 RunAPI 플랫폼에 연결합니다. AI 어시스턴트가 18개 공급업체의 130개 이상 모델을 탐색하고, 입력 파라미터를 확인하고, 실시간 요금을 조회하고, 미디어 생성 태스크를 만들고, 태스크 상태를 폴링하고, 계정 잔액을 확인하고, LLM 엔드포인트를 호출할 수 있습니다 — 모두 편집기 안에서. 탐색 도구는 API 키 없이 사용 가능합니다. 인증이 필요한 작업에는 RunAPI API 키가 필요합니다.
기본 제공 8가지 도구
AI 어시스턴트가 AI 모델을 탐색하고, 요금을 확인하고, 실행하는 데 필요한 모든 것.
list_models
모달리티, 서비스, 엔드포인트별로 모델을 탐색합니다.
get_model_info
모델의 입력 파라미터, 제약 조건, 요금을 확인합니다.
list_actions
출력 모달리티별로 엔드포인트 이름을 그룹화합니다.
check_pricing
서비스, 엔드포인트, 모델의 요금 스냅샷을 반환합니다.
create_task
미디어 태스크를 생성하고 선택적으로 완료될 때까지 폴링합니다.
get_task
기존 태스크의 상태와 최신 페이로드를 가져옵니다.
check_balance
계정 잔액과 사용량 지표를 반환합니다.
chat
RunAPI LLM 엔드포인트에 메시지를 전송합니다.
3단계로 시작하기
설치
클라이언트에 맞는 명령을 선택하세요: Claude Code, Codex, Cursor, Windsurf, VS Code, Roo Code.
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
인증
셸에서 RUNAPI_API_KEY를 설정하거나, GUI로 실행되는 편집기의 경우 클라이언트 환경 설정에 추가하세요.
runapi login
사용
AI 어시스턴트에게 이미지, 비디오, 음악 생성 또는 LLM 호출을 요청하세요. 나머지는 알아서 처리합니다.
"Kling으로 일몰 영상을 만들어줘"
130개 이상 모델, 5가지 모달리티
단일 MCP 서버를 통해 모든 모델에 접근할 수 있습니다.
| 모달리티 | 모델 | 공급업체 |
|---|---|---|
| 이미지 | Flux Kontext, Nano Banana, GPT Image, Seedream, Ideogram, Qwen | Black Forest Labs, Google, OpenAI, Bytedance, Ideogram, Alibaba |
| 비디오 | Kling, Veo, Seedance, Hailuo, Wan, Runway, Luma | Kuaishou, Google, Bytedance, MiniMax, Alibaba, Runway, Luma |
| 음악 | Suno v4 / v4.5 / v5 / v5.5 | Suno |
| 오디오 | ElevenLabs TTS, Sound Effects, STT, Isolation | ElevenLabs |
| LLM | Claude, GPT, Gemini, DeepSeek | Anthropic, OpenAI, Google, DeepSeek |
자주 묻는 질문
list_models, get_model_info, list_actions, check_pricing 같은 탐색 도구는 API 키 없이 작동합니다. 태스크 생성, 잔액 확인, LLM 채팅을 위해서는 대시보드에서 무료 RunAPI API 키가 필요합니다.
RunAPI MCP 서버는 MCP 호환 호스트라면 모두 지원합니다: Claude Code, Codex, Cursor, VS Code (GitHub Copilot 경유), Windsurf, Roo Code. MCP 프로토콜을 지원하는 어떤 도구 와도 연동 가능합니다.
18개 공급업체, 5가지 모달리티에 걸쳐 130개 이상의 모델을 지원합니다: 이미지 생성 (Flux, Nano Banana, GPT Image), 비디오 생성 (Kling, Veo, Seedance), 음악 제작 (Suno), 오디오 (ElevenLabs), LLM (Claude, GPT, Gemini, DeepSeek).
클라이언트에 맞는 명령을 사용하세요. Claude Code는 claude mcp add runapi -s user -- npx -y @runapi.ai/mcp를 사용합니다. Codex는 codex plugin install runapi-mcp@agents를 사용합니다. Cursor, Windsurf, VS Code, Roo Code는 npx @runapi.ai/mcp init <platform>을 사용합니다. npm 전역 설치가 필요 없습니다.
MCP 서버 자체는 무료 오픈소스(Apache 2.0)입니다. API 사용량은 RunAPI 계정을 통해 종량제로 청구됩니다. 구독이나 최소 사용 금액이 없습니다.
예. RUNAPI_API_KEY 환경 변수를 설정하고 에이전트나 CI 파이프라인에 MCP 서버를 구성하세요. 서버는 stdio 프로세스로 실행되며 브라우저나 GUI가 필요 없습니다.