---
title: "RunAPI MCP 서버 — Claude Code, Cursor, VS Code를 위한 130개 이상의 AI 모델"
url: "https://runapi.ai/ko/mcp.md"
canonical: "https://runapi.ai/ko/mcp"
locale: "ko"
---

# RunAPI MCP Server

Claude Code, Cursor, VS Code, Windsurf 등 MCP 호환 호스트를 RunAPI에 연결하세요 — 편집기를 벗어나지 않고 이미지, 비디오, 음악을 생성하고 LLM을 호출할 수 있습니다.

## What Is RunAPI MCP Server?

RunAPI MCP 서버는 MCP 호환 코딩 도구를 RunAPI 플랫폼에 연결합니다. AI 어시스턴트가 18개 공급업체의 130개 이상 모델을 탐색하고, 입력 파라미터를 확인하고, 실시간 요금을 조회하고, 미디어 생성 태스크를 만들고, 태스크 상태를 폴링하고, 계정 잔액을 확인하고, LLM 엔드포인트를 호출할 수 있습니다 — 모두 편집기 안에서. 탐색 도구는 API 키 없이 사용 가능합니다. 인증이 필요한 작업에는 RunAPI API 키가 필요합니다.

## Tools

| Tool | Auth | Purpose |
|---|---|---|
| list_models | No | Browse models by modality, service, or action. |
| get_model_info | No | Inspect input params, constraints, and pricing for a model. |
| list_actions | No | Group endpoint action names by output modality. |
| check_pricing | No | Return pricing snapshot for a service + action + model. |
| create_task | Yes | Create a media task and optionally poll until completion. |
| get_task | Yes | Fetch status and latest payload for an existing task. |
| check_balance | Yes | Return account balance and spending metrics. |
| chat | Yes | Send messages to a RunAPI LLM endpoint. |

## Quick Start

Choose the command for your MCP client.

### Claude Code

```bash
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
export RUNAPI_API_KEY="runapi_xxx"
claude
```

Use project scope when you want the repo to share `.mcp.json`:

```bash
claude mcp add runapi -s project -- npx -y @runapi.ai/mcp
```

### Codex

```bash
codex plugin install runapi-mcp@agents
export RUNAPI_API_KEY="runapi_xxx"
codex
```

### Cursor

```bash
npx @runapi.ai/mcp init cursor
export RUNAPI_API_KEY="runapi_xxx"
cursor .
```

### Windsurf

```bash
npx @runapi.ai/mcp init windsurf
export RUNAPI_API_KEY="runapi_xxx"
windsurf .
```

### VS Code

```bash
npx @runapi.ai/mcp init vscode
export RUNAPI_API_KEY="runapi_xxx"
code .
```

### Roo Code

```bash
npx @runapi.ai/mcp init roo
export RUNAPI_API_KEY="runapi_xxx"
code .
```

Free catalog tools work without a key.
Set `RUNAPI_API_KEY` for `create_task`, `check_balance`, and `chat`.
For GUI-launched clients, add the variable in the client's environment settings.

## Model Coverage

- **Image** — Flux Kontext, Nano Banana, GPT Image, Seedream, Ideogram, Qwen
- **Video** — Kling, Veo, Seedance, Hailuo, Wan, Runway, Luma
- **Music** — Suno v4 / v4.5 / v5 / v5.5
- **Audio** — ElevenLabs TTS, Sound Effects, STT, Isolation
- **LLM** — Claude, GPT, Gemini, DeepSeek

## FAQ

### RunAPI MCP 서버를 사용하려면 API 키가 필요한가요?

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 프로토콜을 지원하는 어떤 도구 와도 연동 가능합니다.

### MCP 서버를 통해 어떤 AI 모델에 접근할 수 있나요?

18개 공급업체, 5가지 모달리티에 걸쳐 130개 이상의 모델을 지원합니다: 이미지 생성 (Flux, Nano Banana, GPT Image), 비디오 생성 (Kling, Veo, Seedance), 음악 제작 (Suno), 오디오 (ElevenLabs), LLM (Claude, GPT, Gemini, DeepSeek).

### MCP 서버는 어떻게 설치하나요?

클라이언트에 맞는 명령을 사용하세요. 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 서버는 무료인가요?

MCP 서버 자체는 무료 오픈소스(Apache 2.0)입니다. API 사용량은 RunAPI 계정을 통해 종량제로 청구됩니다. 구독이나 최소 사용 금액이 없습니다.

### CI 또는 헤드리스 환경에서 MCP 서버를 사용할 수 있나요?

예. RUNAPI_API_KEY 환경 변수를 설정하고 에이전트나 CI 파이프라인에 MCP 서버를 구성하세요. 서버는 stdio 프로세스로 실행되며 브라우저나 GUI가 필요 없습니다.


## Links

- [Model catalog](https://runapi.ai/ko/models)
- [CLI](https://runapi.ai/ko/cli)
- [SDKs](https://runapi.ai/ko/sdk)
- [Skills](https://runapi.ai/ko/skills)
- [Pricing](https://runapi.ai/ko/pricing)
- [API docs](https://runapi.ai/ko/docs)
- [GitHub](https://github.com/runapi-ai/mcp)
- [npm](https://www.npmjs.com/package/@runapi.ai/mcp)