MCP
Connecter un assistant IA à l'API Stream Estate via le serveur MCP
Stream Estate expose un serveur MCP (Model Context Protocol) à https://api-v2.stream.estate/mcp. Il permet à un assistant IA — Claude Code, Claude Desktop, Cursor… — d'interroger l'API en langage naturel. Le transport est HTTP et l'authentification utilise la même clé X-API-KEY que le reste de l'API.
Connexion
claude mcp add --transport http streamestate https://api-v2.stream.estate/mcp \
--header "X-API-KEY: <votre_clé>"Authentification
Le serveur MCP utilise la même clé que les appels REST, transmise dans l'en-tête X-API-KEY. Voir Authentification pour l'obtenir et l'utiliser.
Traitez votre clé comme un mot de passe. Ne la commitez jamais dans un dépôt Git public, et ne la collez pas dans une configuration partagée.
Ce que l'assistant peut faire
À travers le serveur MCP, l'assistant dispose de six outils. Chacun passe par la route REST correspondante, avec votre clé et vos permissions :
| Outil | Rôle | Type |
|---|---|---|
search_properties | Rechercher des biens avec un arbre de critères | Lecture |
resolve_location | Résoudre un nom de lieu ou un code postal en division administrative | Lecture |
list_alerts | Lister les alertes du compte | Lecture |
create_alert | Créer une alerte | Écriture |
update_alert | Modifier une alerte existante, champs nommés uniquement | Écriture |
delete_alert | Supprimer une alerte | Écriture |
Chaque outil déclare son comportement selon la spécification MCP (title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Un assistant qui respecte ces indications, Claude compris, exécute les outils de lecture sans demander confirmation et demande confirmation avant toute écriture. Les routes sous-jacentes sont décrites dans la Référence API.
Usage et facturation
Les appels passés via MCP comptent sur la même clé et le même quota que les appels directs. Ils apparaissent dans GET /account/api-usage sous la ventilation byChannel, où channel vaut "MCP" (par opposition à "DIRECT"), avec le nombre de calls et de results par canal. Voir Contrôle d'usage.