Passer au contenu principal

​
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.