Ressources pour développeurs

Hosted MCP

Connectez Claude Desktop, Cursor, VS Code, Windsurf ou un autre client MCP à RunAPI avec OAuth.

Hosted MCP est la méthode recommandée pour utiliser les outils RunAPI. Votre client MCP se connecte directement à RunAPI, vous n’avez donc pas besoin d’installer Node.js ni de maintenir un processus local en cours d’exécution.

Utilisez ce point de terminaison :

TEXT

https://mcp.runapi.ai/mcp

Choisissez votre client MCP ci-dessous. Lorsque le client ouvre RunAPI dans votre navigateur, connectez-vous, sélectionnez le compte à utiliser et approuvez l’accès.

Claude Desktop

Ouvrez Settings > Connectors et ajoutez un connecteur personnalisé.
Nommez-le RunAPI et saisissez le point de terminaison ci-dessus.
Sélectionnez Connect et finalisez l’autorisation RunAPI dans votre navigateur.
Dans une conversation, ouvrez + > Connectors et activez RunAPI.

Si RunAPI n’apparaît pas dans une conversation, revenez dans Paramètres > Connecteurs, reconnectez-le et confirmez qu’il est activé pour cette conversation.

Curseur

Ajoutez RunAPI à votre mcp.json Cursor, par exemple dans .cursor/mcp.json au niveau du projet :

JSON

{
  "mcpServers": {
    "runapi": {
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

Ouvrez Personnaliser dans la barre latérale Cursor, trouvez RunAPI, activez-le et finalisez l’autorisation dans votre navigateur.

RunAPI devrait apparaître comme connecté et exposer ses outils. En cas d’erreurs de connexion ou d’authentification, ouvrez le panneau Sortie et sélectionnez MCP Logs.

VS Code

Ouvrez la palette de commandes et exécutez MCP: Add Server.
Choisissez HTTP, saisissez le point de terminaison ci-dessus et nommez le serveur RunAPI.
Démarrez le serveur, approuvez-le lorsque vous y êtes invité et finalisez l’autorisation dans votre navigateur.

Les outils RunAPI devraient apparaître dans le Chat. En cas d’erreurs, exécutez MCP : Lister les serveurs, sélectionnez RunAPI et choisissez Afficher la sortie.

Windsurf

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

Ouvrez Devin Settings > Cascade > MCP Servers et modifiez directement le fichier ~/.codeium/windsurf/mcp_config.json.
Ajoutez RunAPI en tant que serveur HTTP distant :

JSON

{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}

Enregistrez le fichier, actualisez les serveurs MCP, activez RunAPI et finalisez l’autorisation dans votre navigateur.

Si les outils n’apparaissent pas, ouvrez les paramètres MCP, confirmez que RunAPI est activé et reconnectez-le.

Autres clients MCP

Ajoutez le point de terminaison ci-dessus en tant que serveur HTTP Streamable. Le client doit prendre en charge Remote MCP et OAuth via navigateur. Finalisez l’autorisation lorsque vous y êtes invité, puis activez les outils RunAPI dans le client.

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. Cela confirme que la connexion et la répartition des outils fonctionnent.

Utiliser une clé API à la place

OAuth est la méthode recommandée. N’utilisez une clé API standard dédiée que pour un client non supervisé ou lorsque OAuth n’est pas disponible ; suivez le Guide d’authentification pour en créer une. Ne mettez jamais la clé dans l’URL du point de terminaison ni ne la commitez dans un dépôt.

Claude Desktop : si les en-têtes de requête sont disponibles pour les connecteurs personnalisés, ajoutez un en-tête Authorization avec la valeur Bearer YOUR_API_KEY.
Cursor : définissez RUNAPI_API_KEY dans l’environnement visible par l’application Cursor, puis utilisez Authorization: Bearer ${env:RUNAPI_API_KEY} dans les headers du serveur. Les serveurs distants ne lisent pas les paramètres envFile de Cursor.
VS Code : référencez un ${input:...} de type mot de passe depuis l’en-tête Authorization du serveur afin que VS Code invite à saisir la clé et la stocke au lieu de l’écrire dans mcp.json.
Windsurf : référencez ${env:RUNAPI_API_KEY} ou ${file:...} depuis l’en-tête Authorization dans ~/.codeium/windsurf/mcp_config.json.

Révoquez la clé depuis la page Clés API lorsque le client est retiré ou que la clé a pu être exposée.

Résoudre les problèmes

L’autorisation n’a pas abouti : reconnectez RunAPI depuis le client et recommencez le flux navigateur.
RunAPI est connecté mais ses outils sont absents : vérifiez que le serveur est activé, supprimez puis rajoutez l’endpoint exact, puis démarrez une nouvelle conversation.
La question de vérification échoue : consultez le journal du client décrit dans la section correspondante ci-dessus, puis reconnectez RunAPI avant de réessayer.

Vous avez besoin d’un client pour démarrer RunAPI sur votre machine ? Configurez Local MCP.