Connecter un client MCP

1. Obtenir un token

La passerelle s’authentifie avec un token de compte de service. 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).

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.

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 :

{
  "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 :

{
  "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.

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.

​1. Obtenir un token

​2. Trouver l’URL de la passerelle

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

​3b. Connecter en local (stdio)

​4. Vérifier

1. Obtenir un token

2. Trouver l’URL de la passerelle

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

3b. Connecter en local (stdio)

4. Vérifier