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

# Passerelle MCP

> Connectez un agent IA à Solya via le Model Context Protocol — découvrez ce qu'est la passerelle, ses outils et comment elle se mappe à l'API.

La **passerelle MCP Solya** permet à un agent IA (Claude, Cursor ou tout client
[MCP](https://modelcontextprotocol.io)) de piloter Solya via l'
[API REST](/fr/developers/overview) — découvrir des endpoints, les inspecter et les appeler — le tout
grâce à trois outils génériques.

## Comment ça marche

La passerelle est un service hébergé en frontal de l'API Solya. Elle lit la
[spécification OpenAPI](/fr/developers/overview) en direct au runtime (elle ne dérive donc jamais) et
expose chaque opération via trois outils :

| Outil                | Ce qu'il fait                                                                                                                                                                                  |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_operations`  | Recherche par mot-clé les opérations de l'API ; retourne une liste compacte (`operation_id`, méthode, chemin, résumé, tags). Les résultats sont filtrés selon ce que votre token peut accéder. |
| `describe_operation` | Retourne le schéma complet d'une opération — méthode, chemin, paramètres, corps de requête/réponse, authentification requise.                                                                  |
| `invoke_operation`   | Exécute une opération — remplit les paramètres de chemin, ajoute les paramètres de requête et un corps JSON, attache votre token, et retourne le statut HTTP + la réponse analysée.            |

Un flux agent typique :

<Steps>
  <Step title="Rechercher">
    `search_operations("plans de rééquilibrage")` → trouver l'endpoint pertinent.
  </Step>

  <Step title="Décrire">
    `describe_operation("listRebalancePlans")` → obtenir son schéma exact.
  </Step>

  <Step title="Invoquer">
    `invoke_operation("listRebalancePlans", query: { page: 1 })` → récupérer les données.
  </Step>
</Steps>

## Authentification et périmètre

La passerelle est un **proxy léger** — elle ne stocke aucun secret. Chaque client envoie son propre
[token de compte de service](/fr/developers/authentication) (`solya_sa_…`) comme en-tête bearer,
que la passerelle transfère à l'API. Par conséquent :

* Tout s'exécute **avec votre token** : même périmètre d'organisation, mêmes permissions. L'agent
  peut seulement faire ce que les permissions du token permettent (l'API applique toujours les `403`).
* `search_operations` masque les opérations que votre token ne peut pas utiliser (ergonomique, pas une
  limite de sécurité — l'API est la limite).
* Les réponses sont l'enveloppe API standard : `{ "success": true, "data": … }` ou
  `{ "success": false, "errorCode": … }` (voir [Codes d'erreur](/fr/developers/error-codes)).

<Note>
  Parce que la passerelle reflète la spécification OpenAPI, **n'importe quel** endpoint Solya que votre token
  peut appeler est accessible via `invoke_operation` — pas d'câblage spécifique aux outils. Pour connecter un client, voir
  [Connecter un client](/fr/mcp/connect).
</Note>