---
title: "RunAPI MCP Server — 210+ modelli AI per Claude Code, Cursor e VS Code"
url: "https://runapi.ai/it/mcp.md"
canonical: "https://runapi.ai/it/mcp"
locale: "it"
---

# RunAPI MCP Server

Collega Claude Code, Cursor, VS Code, Windsurf e qualsiasi host compatibile MCP a RunAPI — genera immagini, video, musica e chiama gli LLM senza uscire dall'editor.

## What Is RunAPI MCP Server?

RunAPI MCP Server collega gli strumenti di coding compatibili con MCP alla piattaforma RunAPI. Consente al tuo assistente AI di esplorare 210+ modelli di 23 provider, ispezionare i parametri di input, verificare i prezzi in tempo reale, creare task di generazione media, controllare lo stato dei task, verificare il saldo dell'account e chiamare endpoint LLM — tutto direttamente dall'editor. Gli strumenti di discovery funzionano senza API key. Le operazioni autenticte richiedono una API key RunAPI.

## 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

### Serve una API key per usare RunAPI MCP Server?

Gli strumenti di discovery come list_models, get_model_info, list_actions e check_pricing funzionano senza API key. Per la creazione di task, il controllo del saldo e la chat con LLM, ti serve una RunAPI API key gratuita dal dashboard.

### Quali strumenti di coding sono supportati?

RunAPI MCP Server funziona con qualsiasi host compatibile con MCP: Claude Code, Codex, Cursor, VS Code (tramite GitHub Copilot), Windsurf e Roo Code. Può anche essere configurato con qualsiasi strumento che supporti il protocollo MCP.

### Quali modelli AI posso usare tramite il server MCP?

210+ modelli su 23 provider e 5 modalità: generazione immagini (Flux, Nano Banana, GPT Image), generazione video (Kling, Veo, Seedance), creazione musica (Suno), audio (ElevenLabs) e LLM (Claude, GPT, Gemini, DeepSeek).

### Come installo il server MCP?

Usa il comando del tuo client. Claude Code usa claude mcp add runapi -s user -- npx -y @runapi.ai/mcp. Codex usa codex plugin install runapi-mcp@agents. Cursor, Windsurf, VS Code e Roo Code usano npx @runapi.ai/mcp init <platform>. Non serve un'installazione globale di npm.

### Il server MCP è gratuito?

Il server MCP in sé è gratuito e open-source (Apache 2.0). L'uso delle API viene fatturato tramite il tuo account RunAPI con prezzi pay-as-you-go. Nessun abbonamento o minimo di spesa.

### Posso usare il server MCP in CI o in ambienti headless?

Sì. Imposta la variabile d'ambiente RUNAPI_API_KEY e configura il server MCP nel tuo agent o nella tua pipeline CI. Il server gira come processo stdio e non richiede un browser o una GUI.


## Links

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