Platform

Casafari est la plateforme d'intelligence de données immobilières native pour les agents IA. L'index immobilier le plus complet d'Europe : un graphe immobilier nettoyé et dédoublé de biens résidentiels et commerciaux, à la vente et à la location, dans 16 pays.L'index immobilier le plus complet d'Europe : un graphe immobilier nettoyé et dédoublé.

Comment le graphe est construit

Connecter un client MCP : Claude, ChatGPT, Cursor, VS Code, Zed

Ajoutez un connecteur, https://platform.casafari.com/mcp, connectez-vous une seule fois, et les outils de chaque produit seront disponibles.

text
https://platform.casafari.com/mcp

Tout client MCP compatible avec les serveurs MCP distants via Streamable HTTP et OAuth peut se connecter ; dans Claude et ChatGPT, cela implique l'ajout d'un connecteur MCP personnalisé. Vous vous connectez via OAuth dans votre navigateur, sans aucune clé à copier ; si vous n'avez pas encore de compte, vous pouvez en créer un lors de l'authentification (plan Free, aucune carte bancaire requise). Nommez le connecteur Casafari (ou utilisez l'entrée casafari dans un fichier de configuration). Le guide complet, incluant REST et les clés d'API, se trouve dans Connect to the Casafari Platform.

Déjà client Casafari ? Utilisez le même serveur : inscrivez-vous sur https://platform.casafari.com/console/. Si vous avez un contrat, Casafari configure votre compte sur le plan Custom. mcp.casafari.com est la passerelle historique, toujours active, en cours de migration vers https://platform.casafari.com/mcp/<product>.

Client par client

Claude

  1. Ouvrez Customize → Connectors, sélectionnez + Add, puis Add custom connector.
  2. Nommez-le Casafari et collez https://platform.casafari.com/mcp dans le champ URL.
  3. Choisissez Connect, connectez-vous ou créez votre compte, acceptez les Platform Terms of Use et validez.

Le connecteur fonctionne aussi bien sur claude.ai que dans Claude Desktop et les applications mobiles Claude.

Vous utilisez Claude Team ou Enterprise ? Dans un espace de travail Claude d'entreprise, seul un propriétaire d'organisation peut ajouter un connecteur personnalisé ; les membres voient l'option Add custom connector grisée (« Demandez à un propriétaire de l'organisation d'ajouter ceci pour votre équipe »). Un propriétaire ajoute le connecteur une seule fois, via Organization settings → Connectors → Add custom connector, nommé Casafari avec l'URL https://platform.casafari.com/mcp.

Chaque membre choisit ensuite Connect sur le connecteur et se connecte avec son propre compte Plateforme Casafari, afin que les plans et la consommation soient rattachés au compte de chaque utilisateur. Aucun propriétaire disponible ? Claude Code ajoute un serveur pour vous seul : claude mcp add --transport http casafari https://platform.casafari.com/mcp.

ChatGPT

  1. Activez le Developer mode dans les paramètres de ChatGPT (Apps & Connectors, paramètres avancés).
  2. Créez un connecteur nommé Casafari, collez https://platform.casafari.com/mcp comme URL du serveur MCP et sélectionnez OAuth.
  3. Connectez-vous ou créez votre compte, puis validez.

Pour exécuter également les playbooks, créez un second connecteur de la même manière, nommé Playbooks, avec l'adresse Playbooks (ci-dessous).

Claude Code

bash
claude mcp add --transport http casafari https://platform.casafari.com/mcp

Exécutez ensuite /mcp dans Claude Code et sélectionnez Authenticate.

Cursor

Ajoutez ceci dans ~/.cursor/mcp.json (ou .cursor/mcp.json au sein d'un projet) :

json
{
  "mcpServers": {
    "casafari": { "url": "https://platform.casafari.com/mcp" }
  }
}

VS Code

Ajoutez ceci dans .vscode/mcp.json :

json
{
  "servers": {
    "casafari": { "type": "http", "url": "https://platform.casafari.com/mcp" }
  }
}

Codex CLI

bash
codex mcp add casafari --url https://platform.casafari.com/mcp
codex mcp login casafari

La commande codex mcp login ouvre la page de connexion Casafari dans votre navigateur. L'entrée est [mcp_servers.casafari] avec url = "https://platform.casafari.com/mcp" dans ~/.codex/config.toml, fichier partagé par l'extension Codex IDE.

Gemini CLI

bash
gemini mcp add --transport http casafari https://platform.casafari.com/mcp

Exécutez ensuite /mcp auth casafari dans Gemini CLI et connectez-vous via le navigateur. L'entrée est enregistrée dans .gemini/settings.json sous "httpUrl" ; ajoutez --scope user pour la conserver dans ~/.gemini/settings.json pour chaque projet.

Devin Desktop (anciennement Windsurf)

Ajoutez ceci dans ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json sur Windows), également utilisé par Devin CLI :

json
{
  "mcpServers": {
    "casafari": { "url": "https://platform.casafari.com/mcp" }
  }
}

Devin ouvre la page de connexion Casafari lors de la première utilisation du serveur ; avec Devin CLI, la commande devin mcp login casafari permet de le faire à la demande.

Visual Studio

GitHub Copilot dans Visual Studio 2022 17.14 ou version ultérieure. Ajoutez ceci dans %USERPROFILE%\.mcp.json (ou dans .mcp.json au sein du dossier de la solution) :

json
{
  "servers": {
    "casafari": { "url": "https://platform.casafari.com/mcp" }
  }
}

Sélectionnez ensuite Manage Authentication dans le CodeLens au-dessus du serveur et connectez-vous via votre navigateur.

Zed

Ouvrez Settings → AI → MCP Servers, choisissez Add Server, puis Add Remote Server. Vous pouvez également ajouter ceci dans ~/.config/zed/settings.json (%APPDATA%\Zed\settings.json sur Windows) :

json
{
  "context_servers": {
    "casafari": { "url": "https://platform.casafari.com/mcp" }
  }
}

Sans en-tête Authorization dans l'entrée, Zed utilise le flux OAuth standard de MCP et ouvre la page de connexion Casafari.

Cline

Dans le panneau MCP Servers de Cline, ouvrez Remote Servers, nommez le serveur casafari, collez l'URL et sélectionnez Streamable HTTP. Dans le fichier de configuration MCP (Configure MCP Servers), l'entrée est la suivante :

json
{
  "mcpServers": {
    "casafari": { "type": "streamableHttp", "url": "https://platform.casafari.com/mcp" }
  }
}

Cline autorise un serveur distant dans le navigateur ; dans Cline CLI, cline mcp propose Authorize OAuth.

JetBrains Junie

Ajoutez ceci à ~/.junie/mcp/mcp.json (ou .junie/mcp/mcp.json à la racine d'un projet) ; Junie dans les IDE JetBrains et Junie CLI lisent la même configuration :

json
{
  "mcpServers": {
    "casafari": { "url": "https://platform.casafari.com/mcp" }
  }
}

Le serveur indique Authorization required jusqu'à votre connexion : dans Junie CLI, lancez /mcp, choisissez Authorize sur le serveur et connectez-vous via le navigateur.

Kiro

Ajoutez ceci à ~/.kiro/settings/mcp.json (ou .kiro/settings/mcp.json dans un espace de travail) :

json
{
  "mcpServers": {
    "casafari": { "url": "https://platform.casafari.com/mcp" }
  }
}

Kiro lance l'authentification OAuth dans le navigateur lors de la connexion.

Warp

Ouvrez Settings → Agents → MCP servers, choisissez + Add et collez ce qui suit :

json
{
  "casafari": { "url": "https://platform.casafari.com/mcp" }
}

Warp ouvre le navigateur pour l'authentification lors du premier démarrage du serveur.

goose

Lancez goose configure, choisissez Add Extension, puis Remote Extension (Streamable HTTP), et saisissez https://platform.casafari.com/mcp comme URL (dans goose Desktop : Extensions → Add custom extension). goose s'enregistre et se connecte via OAuth dans le navigateur.

Tout autre client ou assistant

Pointez le client vers https://platform.casafari.com/mcp. Il s'enregistre lui-même (OAuth 2.1 avec enregistrement dynamique de client et PKCE) et ouvre la page de connexion de Casafari ; les métadonnées du serveur d'autorisation sont disponibles sur https://platform.casafari.com/.well-known/oauth-authorization-server.

Vérifier le fonctionnement

Demandez à votre assistant d'appeler account_status : il répondra en indiquant votre plan et votre solde. Les noms de lieux deviennent des identifiants de localisation avec locations_search, accessible gratuitement sur le même serveur.

Où retrouver Casafari

Chaque entrée ci-dessous pointe vers les mêmes serveurs via https://platform.casafari.com/mcp et utilise OAuth 2.1, rendant toute clé d'API inutile.

Un produit à la fois

Chaque produit constitue également son propre serveur, pour un connecteur limité à un seul produit ou à une connexion existante :

  • Location Lookup: https://platform.casafari.com/mcp/locations
  • Area Insights: https://platform.casafari.com/mcp/area-insights
  • Comparables : https://platform.casafari.com/mcp/comparables
  • Comparables with Transactions: https://platform.casafari.com/mcp/comparables-transactions
  • Property Sourcing: https://platform.casafari.com/mcp/property-sourcing
  • Private Seller Leads: https://platform.casafari.com/mcp/private-sellers
  • AgencyGraph: https://platform.casafari.com/mcp/agencygraph
  • Cadastre: https://platform.casafari.com/mcp/cadastre
  • Parcel Zoning: https://platform.casafari.com/mcp/parcel-zoning
  • Claro AI: https://platform.casafari.com/mcp/claro

Chacune de ces ressources est protégée et possède sa propre authentification ; ses outils et ses prix sont identiques à ceux du serveur principal. Pour le serveur d'un produit, utilisez son URL dans les étapes ci-dessus et nommez l'entrée casafari-<product>, par exemple casafari-comparables. Les alertes et les High Potential Seller Leads ne disposent pas de serveur MCP. Playbooks est un connecteur distinct, détaillé ci-dessous, et non un produit du serveur principal.

Playbooks

Playbooks sont des flux de travail prêts à l'emploi basés sur les données de Casafari, chacun à un coût fixe en jetons. Ils s'exécutent via leur propre connecteur, https://platform.casafari.com/mcp/playbook, que vous ajoutez à côté du serveur principal en suivant les mêmes étapes (nommez-le Playbooks, ou casafari-playbook dans un fichier) et en vous connectant une seule fois. Dans Claude et ChatGPT, il apparaît comme un second connecteur à côté de Casafari. Le serveur principal ne gère pas les playbooks ; il ne contient que les outils produits.

Le connecteur comprend cinq outils, tous gratuits en eux-mêmes : playbook_plan (détaille les besoins d'un objectif et son coût maximal ; rien n'est exécuté ni facturé), playbook_run, playbook_status, playbook_explain et playbook_call, en plus de account_status et locations_search. Demandez un résultat en langage naturel (« Exécute le playbook de dossier de vente pour l'Espagne », « Combien coûterait un rapport de marché hebdomadaire pour Lisbonne ? ») : l'assistant planifie d'abord, vous montre les étapes et le coût maximal en jetons, et ne lance l'exécution qu'après votre accord. Une exécution coûte exactement la somme de ses étapes, facturées par chaque produit comme n'importe quel appel. Si une exécution s'interrompt (besoin de paiement, de vérification ou dépassement de temps), les étapes terminées conservent leurs résultats et playbook_run avec le même identifiant d'exécution reprend à l'étape suivante, sans double facturation.

Les Playbooks nécessitent le connecteur authentifié : une exécution avec une API key doit se terminer en un seul appel, ainsi un playbook long répond needs_oauth, et le bouton Run now de la console utilise votre session de la même manière. Dans Claude Code : claude mcp add --transport http casafari-playbook https://platform.casafari.com/mcp/playbook.

Questions à ce sujet

Astuce : ajoutez .md à n'importe quelle URL pour la lire en format Markdown.