---
title: MCP local | RunAPI
description: Exécutez le serveur MCP RunAPI localement avec Claude Code, Cursor, VS
  Code, Windsurf, ou un autre client stdio.
url: https://runapi.ai/fr/docs/resources/mcp/local.md
canonical: https://runapi.ai/fr/docs/resources/mcp/local
locale: fr
---

> Version HTML: https://runapi.ai/fr/docs/resources/mcp/local
> Index du site pour les agents: https://runapi.ai/llms.txt

# MCP local

Le MCP local permet à votre client MCP de démarrer le serveur MCP RunAPI sur votre
machine. Utilisez-le lorsque le client ne prend pas en charge Remote MCP ou que vous
avez explicitement besoin d'un processus local.

## Avant de démarrer

Installez Node.js et confirmez que `npx` est disponible. Votre client MCP doit prendre en charge les serveurs stdio locaux.

Chaque client ci-dessous démarre avec la même commande :

```shell
npx -y @runapi.ai/mcp
```

Vous pouvez vous connecter et utiliser les outils du catalogue sans vous authentifier.

## Claude Code

Exécutez :

```shell
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
```

Utilisez `-s user` pour rendre RunAPI disponible dans tous vos projets. Redémarrez
Claude Code s'il était déjà en cours d'exécution, puis confirmez que RunAPI est bien répertorié comme
serveur MCP.

## Curseur

Ajoutez le serveur sous `mcpServers` dans `.cursor/mcp.json` ou dans votre configuration MCP
utilisateur :

```json
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}
```

Ouvrez **Personnaliser** dans la barre latérale Cursor, trouvez RunAPI et activez-le. Si
le processus ne démarre pas, ouvrez le panneau **Sortie** et sélectionnez **Journaux MCP**.

## VS Code

1.  Ouvrez la palette de commandes et exécutez **MCP: Add Server**.
2.  Choisissez **Command (stdio)** et saisissez `npx -y @runapi.ai/mcp`.
3.  Nommez le serveur **RunAPI**, choisissez sa portée de configuration et
    démarrez-le.
4.  Approuvez le serveur lorsque vous y êtes invité. En cas d'erreur, exécutez **MCP: List
    Servers**, sélectionnez RunAPI et choisissez **Show Output**.

VS Code stocke la configuration manuelle sous la clé de premier niveau `servers`
et utilise `type: "stdio"`.

## Windsurf

Ces étapes s'appliquent à l'agent Cascade. Devin Local utilise la configuration
de la CLI Devin.

1.  Ouvrez **Devin Settings > Cascade > MCP Servers**.
2.  Ouvrez la configuration MCP brute dans
    `~/.codeium/windsurf/mcp_config.json`.
3.  Ajoutez RunAPI avec la commande `npx` et les arguments indiqués dans l'exemple Cursor ci-dessus.
4.  Enregistrez le fichier, actualisez les serveurs MCP et activez RunAPI.

## Autres clients MCP

Ajoutez un serveur stdio local nommé **RunAPI**. Définissez sa commande sur `npx` et
ses arguments sur `-y` et `@runapi.ai/mcp`. Redémarrez ou actualisez le
client après avoir enregistré la configuration.

## Vérifier la connexion

Interrogez votre client :

> Quels modèles d'image RunAPI sont disponibles ?

Le client doit appeler `list_models` et retourner les modèles d'image disponibles.
Cet outil de découverte public ne nécessite pas d'authentification.

## Se connecter si nécessaire

Continuez à utiliser les outils de découverte sans vous connecter. Lorsque vous demandez pour la première fois à RunAPI de créer une tâche, de récupérer une tâche ou de vérifier un solde, laissez le client appeler l'outil `login`. Il ouvre RunAPI dans votre navigateur et enregistre l'identifiant dans la configuration locale partagée.

Si vous préférez vous connecter depuis un terminal, installez le [CLI RunAPI](https://runapi.ai/fr/docs/resources/cli.md) et exécutez :

```shell
runapi login
```

Pour les clients sans interface graphique ou CI, suivez le [Guide
d'authentification](https://runapi.ai/fr/docs/guides/authentication.md) pour créer une clé API
standard dédiée, puis fournissez-la en tant que `RUNAPI_API_KEY` via la
configuration d'environnement ou de secret du client. Une clé d'environnement est
prioritaire sur les informations d'identification enregistrées par la connexion MCP locale.

## Résoudre les problèmes

* `npx` est introuvable : vérifiez que `node --version` et `npx --version`
  fonctionnent, puis redémarrez complètement le client MCP afin qu'il
  reçoive l'environnement mis à jour.
* Le serveur local se ferme immédiatement : exécutez `npx -y @runapi.ai/mcp`
  dans un terminal, corrigez l'erreur Node.js ou de paquet signalée, puis
  redémarrez le client.
* Les outils RunAPI n'apparaissent pas : vérifiez que le serveur est activé
  et que la commande utilise stdio, puis consultez le journal du client décrit
  ci-dessus.
* Un outil authentifié échoue : demandez au client d'appeler l'outil `login`.
  Si `RUNAPI_API_KEY` est défini, mettez-le à jour ou supprimez-le avant de
  réessayer Local MCP Login.

Vous préférez une connexion sans processus Node.js local ? [Configurez le MCP hébergé](https://runapi.ai/fr/docs/resources/mcp/hosted.md).

---

## Plus de ressources de RunAPI

- [Accueil](https://runapi.ai/fr/.md)
- [Catalogue de modèles](https://runapi.ai/fr/models.md)
- [Tarifs](https://runapi.ai/fr/pricing.md)
- [Fournisseurs](https://runapi.ai/fr/models)
- [Documentation](https://runapi.ai/fr/docs/guides)
- [SDK](https://runapi.ai/fr/sdk.md)
- [CLI](https://runapi.ai/fr/cli.md)
- [Serveur MCP](https://runapi.ai/fr/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/fr/claude-code-vs-cursor.md)
- [Configuration de l’API Cursor](https://runapi.ai/fr/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/fr/openrouter-alternative.md)
- [Entreprise](https://runapi.ai/fr/contact.md)
- [Contact](https://runapi.ai/fr/contact.md)
- [Conditions](https://runapi.ai/fr/terms.md)
- [Confidentialité](https://runapi.ai/fr/privacy.md)
- [Index du site pour les agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Données structurées

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/fr",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/fr/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/fr",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/fricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "TechArticle",
    "headline": "MCP local",
    "description": "Exécutez le serveur MCP RunAPI localement avec Claude Code, Cursor, VS Code, Windsurf, ou un autre client stdio.",
    "url": "https://runapi.ai/fr/docs/resources/mcp/local",
    "mainEntityOfPage": "https://runapi.ai/fr/docs/resources/mcp/local"
  }
]
```