> ## Documentation Index
> Fetch the complete documentation index at: https://help.onetsolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Serveur MCP

> Connectez vos agents IA (Claude Desktop, Claude Code, Cursor) à OnetSolutions via le Model Context Protocol

Le serveur MCP OnetSolutions permet à un agent IA d'agir sur votre compte — gérer vos VPS, vos domaines, votre facturation et toute autre ressource exposée par l'API publique — directement depuis votre assistant favori.

<Note>
  **Beta** — le serveur MCP est en version preview. Les endpoints, noms d'outils et capacités peuvent évoluer. Nous vous recommandons de tester d'abord sur une organisation hors production.
</Note>

<Info>
  **Prérequis**

  * Un compte OnetSolutions avec au moins une organisation
  * Un client compatible MCP (Claude Desktop, Claude Code, Cursor, ou tout autre client supportant le [Model Context Protocol](https://modelcontextprotocol.io))
</Info>

## Endpoint du serveur

|                                        |                                                                      |
| -------------------------------------- | -------------------------------------------------------------------- |
| **URL**                                | `https://mcp.onetsolutions.net/mcp`                                  |
| **Transport**                          | Streamable HTTP                                                      |
| **Authentification**                   | OAuth 2.1 avec PKCE                                                  |
| **Enregistrement dynamique du client** | Supporté ([RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591)) |

Le serveur expose la même surface que l'[API REST OnetSolutions](/fr/api-reference/introduction) : tout ce que vous pouvez faire avec une clé API, un agent peut le faire via MCP — dans la limite des permissions de votre compte.

## Authentification

Le serveur utilise OAuth 2.1 standard. Vous n'avez ni clé API à créer ni jeton à coller : lorsque vous ajoutez le serveur dans un client MCP, ce dernier ouvre un navigateur, vous vous connectez à OnetSolutions et accordez l'accès. Les jetons sont stockés par le client et rafraîchis automatiquement.

<Warning>
  L'agent agit en votre nom, avec les permissions de votre compte. Validez chaque action proposée par votre agent avant de la confirmer, en particulier les actions destructrices (suppression d'une instance, transfert d'un domaine, résiliation d'un abonnement).
</Warning>

## Connecter un client

<Tabs>
  <Tab title="Claude Desktop">
    <Steps>
      <Step title="Ouvrir les connecteurs">
        Dans Claude Desktop, ouvrez **Paramètres → Connecteurs**.
      </Step>

      <Step title="Ajouter un connecteur personnalisé">
        Cliquez sur **Ajouter un connecteur personnalisé** et renseignez :

        * **Nom** : `OnetSolutions`
        * **URL du serveur MCP distant** : `https://mcp.onetsolutions.net/mcp`
      </Step>

      <Step title="S'authentifier">
        Claude Desktop ouvre une fenêtre de navigateur. Connectez-vous à votre compte OnetSolutions et validez les permissions demandées.
      </Step>

      <Step title="Utiliser le serveur">
        Démarrez une nouvelle conversation et demandez à Claude d'interagir avec vos ressources, par exemple : *« Liste mes VPS et leur statut actuel. »*
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    Ajoutez le serveur en une seule commande :

    ```bash theme={null}
    claude mcp add --transport http onetsolutions https://mcp.onetsolutions.net/mcp
    ```

    Lancez ensuite `/mcp` dans Claude Code et sélectionnez **onetsolutions → Authenticate**. Une fenêtre de navigateur s'ouvre pour terminer le flux OAuth.

    Pour retirer le serveur plus tard :

    ```bash theme={null}
    claude mcp remove onetsolutions
    ```
  </Tab>

  <Tab title="Cursor">
    Modifiez `~/.cursor/mcp.json` (créez le fichier s'il n'existe pas) et ajoutez :

    ```json theme={null}
    {
      "mcpServers": {
        "onetsolutions": {
          "url": "https://mcp.onetsolutions.net/mcp"
        }
      }
    }
    ```

    Redémarrez Cursor, ouvrez **Settings → MCP** et cliquez sur **Authenticate** à côté du serveur `onetsolutions`. Le flux OAuth s'ouvre dans votre navigateur.
  </Tab>
</Tabs>

## Ce que vous pouvez demander

Comme le serveur MCP reflète l'API REST, les agents peuvent vous aider sur tout ce que couvre la [Référence API](/fr/api-reference/introduction). Quelques exemples pour démarrer :

* *« Redémarre mon VPS `web-01`. »*
* *« Affiche les renouvellements à venir sur mes domaines. »*
* *« Crée un snapshot de `db-prod` avant que je lance la migration. »*
* *« Résume mes trois dernières factures. »*

La liste exacte des outils est annoncée par le serveur lui-même — votre client l'affiche dès la connexion établie.

## Révoquer un accès

Pour déconnecter un agent de votre compte :

1. Rendez-vous dans **Console → Paramètres → Sécurité** ([console.onetsolutions.net](https://console.onetsolutions.net)).
2. Repérez l'application OAuth correspondant à votre client (par exemple `Claude Desktop`).
3. Cliquez sur **Révoquer**.

L'agent perd l'accès immédiatement. Toute session active échouera dès la requête suivante.

## Dépannage

<AccordionGroup>
  <Accordion title="Le navigateur ne s'ouvre pas pendant l'authentification">
    Certains clients ne lancent pas automatiquement de navigateur. Copiez l'URL d'autorisation affichée dans les logs du client et ouvrez-la manuellement.
  </Accordion>

  <Accordion title="`401 Unauthorized` après une longue inactivité">
    Votre refresh token a peut-être expiré. Relancez l'étape d'authentification dans votre client (`/mcp` dans Claude Code, ou **Reconnect** dans Claude Desktop / Cursor).
  </Accordion>

  <Accordion title="L'agent dit qu'un outil est manquant">
    Le serveur MCP est en beta et le catalogue d'outils évolue. Redémarrez votre client pour récupérer la dernière liste, ou consultez le [changelog](/fr/changelog/overview).
  </Accordion>

  <Accordion title="Une action est refusée avec `403 Forbidden`">
    Votre compte ou le rôle utilisé pour l'authentification n'a pas la permission requise. Vérifiez votre rôle dans **Console → Organisations**.
  </Accordion>
</AccordionGroup>

## Pour aller plus loin

<CardGroup cols={2}>
  <Card title="Référence API" icon="book" href="/fr/api-reference/introduction">
    Liste complète des ressources et opérations exposées via MCP.
  </Card>

  <Card title="Clés API" icon="key" href="/fr/console/api-keys">
    Utilisez plutôt des clés API statiques — pratique pour les pipelines CI/CD ou les scripts.
  </Card>
</CardGroup>