--- title: "Développer avec Matchai" description: "Lisez les inscriptions Matchai dès aujourd'hui avec le serveur MCP, la recherche et les pages lisibles par l'IA, sans clé. L'API Matchai arrive bientôt." last_updated: "2026-10-21" lang: "fr-CA" canonical: "https://matchai.co/docs/fr/developers" --- # Développer avec Matchai > Lisez les inscriptions Matchai dès aujourd'hui avec le serveur MCP, la recherche et les pages lisibles par l'IA, sans clé. L'API Matchai arrive bientôt. Source: https://matchai.co/docs/fr/developers Les professionnels de l'immobilier publient sur Matchai leurs inscriptions, leur site Web (un site Matchai) et un profil d'une page (une Page Matchai). Tout ce qu'ils publient peut être lu par un logiciel, et cette partie fonctionne dès aujourd'hui, sans compte, sans clé d'API et sans approbation. L'étape suivante consiste à laisser un logiciel travailler **dans** le compte d'un professionnel, avec sa permission : tenir ses inscriptions à jour, ajouter ses prospects, réserver ses visites. Cette partie est prévue. Cette section documente les deux, et indique ce qui n'est pas encore offert. ## Ce qui est offert aujourd'hui [#what-is-live-today] | Interface | Adresse | Utilisez-la pour | |---|---|---| | Serveur MCP | `https://matchai.co/mcp` | Permettre à un assistant IA de chercher des inscriptions, d'ouvrir une inscription et de trouver un courtier | | Recherche d'inscriptions | `https://matchai.co/ask` | Chercher parmi les inscriptions publiées en langage courant, depuis votre propre code | | Pages lisibles par l'IA | `/llms.txt`, copies Markdown, `/sitemap.xml` sur chaque hôte Matchai | Lire le site d'un courtier ou sa Page Matchai en texte épuré | | Contrat OpenAPI | `https://matchai.co/openapi.json` | Examiner les points de terminaison publics ou générer un client | Le fichier OpenAPI à `/openapi.json` décrit ces points de terminaison publics en lecture seule, et rien d'autre. L'API prévue a son propre contrat, décrit [plus bas](#what-is-coming). ### Essayer [#try-it] Cette requête cherche parmi toutes les inscriptions publiées sur Matchai et renvoie jusqu'à 10 résultats en JSON : ```bash title="Terminal" curl "https://matchai.co/ask?query=3+bedroom+condo+in+Laval+under+600k" ``` La page [Recherche d'inscriptions](https://matchai.co/docs/fr/developers/listing-search) explique la requête, la réponse et les limites. ### Règles de base des interfaces publiques [#ground-rules-for-the-public-surfaces] - **Public et en lecture seule.** Rien ici ne modifie de données, et rien n'est lié à un compte d'utilisateur. - **Données publiées seulement.** Les inscriptions, les sites et les pages qu'un professionnel n'a pas publiés ne sont jamais renvoyés. Les numéros de téléphone et les adresses courriel n'apparaissent que là où le professionnel a choisi de les publier sur sa carte professionnelle. - **Limites d'utilisation équitable.** Chaque point de terminaison public limite le nombre de requêtes qu'un même appelant peut faire par minute. Les [limites](https://matchai.co/docs/fr/developers/rate-limits) sont réunies sur une seule page. - **Les résultats ne sont pas à vendre.** Les résultats sont classés selon leur pertinence pour la requête et selon la date de la dernière mise à jour de l'inscription. Aucun courtier ne peut payer pour changer l'ordre ou pour y figurer. - **Renvoyez à la source.** Quand vous affichez une inscription, faites un lien vers sa page d'inscription. Cette page est la source du prix, du statut et des détails à jour. ## Ce qui est prévu [#what-is-coming] **(Bientôt disponible)** L'API Matchai permet à une application d'agir pour **un seul compte Matchai** : lire et modifier ses inscriptions, gérer ses contacts, envoyer des messages, réserver des visites, classer des documents et être avisée des changements. Elle peut faire ce que le titulaire du compte peut faire dans Matchai, selon les mêmes règles et les mêmes permissions, et rien de plus. Rien de tout cela n'est encore ouvert. Les pages ci-dessous décrivent comment elle fonctionnera, pour que vous puissiez planifier. | Interface | Adresse | Utilisez-la pour | |---|---|---| | API Matchai | `https://api.matchai.co/v1` | Lire et modifier les inscriptions, les contacts, les conversations, le calendrier, les documents, les sites et la Page Matchai d'un compte | | Clés d'API | **Paramètres → Connecteurs → Options avancées (pour les développeurs)** | Automatiser votre propre compte avec des scripts, ou alimenter vos propres outils IA | | Se connecter avec Matchai | OAuth 2.1 | Permettre aux professionnels de connecter leur compte à votre application en quelques clics | | Webhooks | Votre point de terminaison `https` | Être avisé des nouveaux prospects, des réservations et des inscriptions publiées au moment où ils arrivent | | Outils MCP authentifiés | `https://matchai.co/mcp` | Donner à un assistant IA les actions propres à un professionnel, une fois qu'il l'a connecté | Quatre règles encadrent le tout : - **Un identifiant de connexion, un compte.** Une clé ou un jeton n'atteint jamais les données d'un autre compte. Une application qui sert trois professionnels détient trois connexions. - **Les actions finales demandent d'abord.** L'envoi, la publication, le paiement et la suppression attendent l'approbation du titulaire du compte, à moins qu'il ait choisi **Autorisé** pour votre application. - **Les lectures publiques restent gratuites.** Lire ce qu'un professionnel a déjà publié ne demande aucune connexion. Connecter une application à un compte est un connecteur Matchai payant, et une application connectée seulement au compte de son propre développeur est en mode test gratuit. - **L'énergie est un état, jamais un nombre.** Les actions qui utilisent l'IA ou qui envoient des messages texte dépensent de l'Énergie Matchai, comme dans l'application. Commencez par le [démarrage rapide](https://matchai.co/docs/fr/developers/quickstart), puis lisez la page [Authentification](https://matchai.co/docs/fr/developers/authentication). ## À qui s'adresse cette section [#who-this-is-for] - **Les développeurs qui travaillent avec des assistants IA.** Connectez le [serveur MCP](https://matchai.co/docs/fr/developers/mcp-server) à votre propre assistant ou script, ou appelez directement la [recherche d'inscriptions](https://matchai.co/docs/fr/developers/listing-search). Les deux fonctionnent dès aujourd'hui. - **Les créateurs de sites Web.** Si vous hébergez le site Web d'un courtier sur Matchai, chaque [page lisible par l'IA](https://matchai.co/docs/fr/developers/agent-readable-pages) y est déjà. Quand l'API ouvrira, vous pourrez lire les inscriptions d'un courtier, envoyer les prospects de son site Web dans ses contacts Matchai, réserver des visites selon ses vraies disponibilités et être avisé des changements par webhooks. Un courtier connecte son compte à votre produit avec [Se connecter avec Matchai](https://matchai.co/docs/fr/developers/authentication/connect-with-matchai). - **Les courtiers et les équipes qui créent leurs propres outils par script.** Utilisez une [clé d'API](https://matchai.co/docs/fr/developers/authentication/api-keys) pour travailler avec votre propre compte depuis votre propre code. - **Les personnes qui veulent que leur propre assistant connaisse les inscriptions Matchai.** Ajoutez le serveur MCP à Claude ou à ChatGPT en quelques minutes. Les étapes se trouvent dans le [guide du serveur MCP](https://matchai.co/docs/fr/developers/mcp-server#connect-an-assistant). Créez une clé d'API, appelez l'API et ajoutez un contact. Bientôt disponible. Clés d'API, Se connecter avec Matchai, portées et approbations. Bientôt disponible. Points de terminaison, transport et configuration pour Claude, ChatGPT et tout autre client MCP. Entrées, sorties et exemples pour search_listings, get_listing et get_professional. Recherche en langage naturel parmi les inscriptions publiées, avec le point de terminaison /ask. Comment les sites Matchai se décrivent aux assistants IA, et comment reproduire cette approche. Des événements envoyés à votre point de terminaison, avec des livraisons signées. Bientôt disponible. Des démarches complètes pour les créateurs de sites Web et les assistants IA. Bientôt disponible. Chaque point de terminaison prévu, avec ses portées, ses prix et des exemples. Bientôt disponible. Le format des erreurs, chaque code d'erreur et la façon de réessayer. Bientôt disponible. Ce que les interfaces publiques permettent aujourd'hui, et comment les limites fonctionneront dans l'API. Comment l'API évolue sans briser votre application. Bientôt disponible. Ce qui a changé dans la documentation pour les développeurs et, plus tard, dans l'API. ## Sitemap - [Toutes les pages de la documentation Matchai](https://matchai.co/docs/sitemap.md) - [llms.txt](https://matchai.co/docs/fr/llms.txt)