Aller au contenu
Ressources pour développeurs
Ressources pour développeurs

MCP local

Exécutez le serveur MCP RunAPI localement avec Claude Code, Cursor, VS Code, Windsurf, ou un autre client stdio.

Voir en Markdown

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 et exécutez :

SHELL 
runapi login

Pour les clients sans interface graphique ou CI, suivez le Guide d’authentification 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é.