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é>"Pour tout client MCP qui lit un fichier de configuration (Claude Desktop, Cursor…), déclarez le serveur en transport HTTP :
{
"mcpServers": {
"streamestate": {
"type": "http",
"url": "https://api-v2.stream.estate/mcp",
"headers": { "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 atteint les mêmes capacités que l'API : rechercher des biens, gérer favoris et alertes, lire les analytics. La liste complète des routes est 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.