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

# Connecter un client MCP

> Obtenez un token et pointez Claude, Cursor ou tout client MCP vers la passerelle Solya — en distant (HTTP) ou en local (stdio).

## 1. Obtenir un token

La passerelle s'authentifie avec un [token de compte de service](/fr/developers/authentication).
Créez-en un dans **Paramètres → Tokens API** avec les permissions dont votre agent a besoin, puis copiez
la valeur `solya_sa_…` (affichée une seule fois).

<Warning>
  Le token accorde tout ce que ses permissions permettent, sans intervention humaine. Limitez-le au minimum et stockez-le dans la config secrète de votre client MCP — jamais dans des fichiers partagés.
</Warning>

## 2. Trouver l'URL de la passerelle

L'URL du serveur s'affiche dans **Paramètres → MCP** (copiable). En production, elle est :

```
https://api-mcp.solya.app/mcp
```

## 3a. Connecter en distant (HTTP) — Claude, Cursor

La plupart des clients acceptent une config JSON. Ajoutez le serveur Solya avec votre token comme en-tête bearer :

```json theme={null}
{
  "mcpServers": {
    "solya-api": {
      "url": "https://api-mcp.solya.app/mcp",
      "headers": { "Authorization": "Bearer solya_sa_xxx" }
    }
  }
}
```

La page **Paramètres → MCP** génère ce snippet par client (Claude, Cursor, Générique) pour que
vous puissiez le copier directement.

Pour un client qui n'accepte que des valeurs brutes :

```
URL du serveur MCP : https://api-mcp.solya.app/mcp
En-tête :           Authorization: Bearer solya_sa_xxx
```

## 3b. Connecter en local (stdio)

Pour une utilisation locale (par ex. Claude Desktop / Claude Code exécutant la passerelle comme sous-processus), la
passerelle fonctionne sur **stdio** et lit le token depuis l'environnement :

```json theme={null}
{
  "mcpServers": {
    "solya-api": {
      "command": "node",
      "args": ["/absolute/path/to/solya-api-mcp/dist/index.js"],
      "env": {
        "SOLYA_API_BASE_URL": "https://app.solya.app",
        "SOLYA_API_TOKEN": "solya_sa_xxx"
      }
    }
  }
}
```

## 4. Vérifier

Demandez à votre agent d'exécuter `search_operations` (par ex. *« lister les opérations Solya pour les marques »*), puis
`describe_operation` et `invoke_operation` sur un endpoint en lecture. Un appel style `whoami` est
une bonne vérification initiale que le token se résout à la bonne organisation et aux bonnes permissions.

<Note>
  Transports : la passerelle hébergée parle du **HTTP Streamable** moderne à `/mcp` (avec un fallback
  **SSE** hérité) ; le mode local parle **stdio**. Choisissez celui que votre client supporte —
  la plupart des clients modernes utilisent la config HTTP distante en 3a.
</Note>