---
title: Hosted MCP | RunAPI
description: Connectez Claude Desktop, Cursor, VS Code, Windsurf ou un autre client
  MCP à RunAPI avec OAuth.
url: https://runapi.ai/fr/docs/resources/mcp/hosted.md
canonical: https://runapi.ai/fr/docs/resources/mcp/hosted
locale: fr
---

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

# Hosted MCP

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

1.  Ouvrez **Settings > Connectors** et ajoutez un connecteur personnalisé.
2.  Nommez-le **RunAPI** et saisissez le point de terminaison ci-dessus.
3.  Sélectionnez **Connect** et finalisez l'autorisation RunAPI dans votre
    navigateur.
4.  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

1.  Ouvrez la palette de commandes et exécutez **MCP: Add Server**.
2.  Choisissez **HTTP**, saisissez le point de terminaison ci-dessus et nommez le serveur
    **RunAPI**.
3.  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.

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

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

1.  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](https://runapi.ai/fr/docs/guides/authentication.md) 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](https://runapi.ai/fr/docs/resources/mcp/local.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": "Hosted MCP",
    "description": "Connectez Claude Desktop, Cursor, VS Code, Windsurf ou un autre client MCP à RunAPI avec OAuth.",
    "url": "https://runapi.ai/fr/docs/resources/mcp/hosted",
    "mainEntityOfPage": "https://runapi.ai/fr/docs/resources/mcp/hosted"
  }
]
```