Serveur MCP

Le serveur MCP de Matchai permet à un assistant IA de chercher parmi les inscriptions que des professionnels de l'immobilier ont publiées sur Matchai, d'ouvrir une inscription et de trouver un courtier. MCP, le Model Context Protocol, est la norme ouverte qu'utilisent les assistants pour appeler des outils externes.

Le serveur est public et en lecture seule. Il ne demande ni compte, ni clé d'API, ni connexion, et il ne renvoie que des données publiées.

Points de terminaisonCopier le lien de cette section

TransportCopier le lien de cette section

Le serveur parle MCP sur Streamable HTTP, dans sa forme sans état, avec des messages JSON-RPC 2.0.

• POST : envoyez un seul message JSON-RPC au point de terminaison. Une requête reçoit 200 avec un corps application/json. Une notification reçoit 202 sans corps.
• Aucune session. Le serveur n'émet aucun Mcp-Session-Id et ne garde rien en mémoire d'une requête à l'autre, alors chaque requête peut recevoir une réponse à elle seule. Suivez quand même la séquence d'initialisation standard, pour que votre client fonctionne aussi avec d'autres serveurs.
• Aucun flux d'événements. GET et DELETE répondent 405, ce qui est la bonne réponse pour un serveur qui n'a rien à pousser. OPTIONS répond 204 pour CORS.
• Aucun lot. Envoyez un seul message par requête. Un tableau est refusé avec -32600.
• Versions du protocole : 2025-11-25, 2025-06-18 et 2025-03-26. initialize renvoie votre version quand le serveur la parle, et la plus récente sinon. Si vous envoyez un en-tête MCP-Protocol-Version après initialize, il doit s'agir de l'une de ces versions, sinon la requête échoue avec 400.
• Taille. Le corps d'une requête peut atteindre 256 Ko.

Le serveur répond à ces méthodes :

Toute autre méthode répond -32601 (méthode introuvable). Le serveur n'offre ni invites (prompts), ni journalisation, ni complétion.

serverInfo.name vaut matchai-listings, et serverInfo.version est un numéro de version sémantique. Il change quand un outil ou un champ est ajouté ou change de forme.

Accès, données et limitesCopier le lien de cette section

• Authentification. Aucune. /.well-known/mcp.json déclare authentication.required: false, et le serveur ne demande aucune clé, aucun jeton ni aucune connexion.
• Données. Les inscriptions publiées, et le profil public des courtiers qui ont publié un site, une Page Matchai ou une carte professionnelle. Le numéro de téléphone et l'adresse courriel d'un courtier n'apparaissent que s'ils sont publiés sur cette carte professionnelle.
• Ordre des résultats. Selon la pertinence pour la requête et la date de la dernière mise à jour de l'inscription. Aucun courtier ne peut payer pour changer l'ordre ou pour y figurer.
• Limite de débit. Chaque adresse appelante peut faire 600 requêtes tools/call par minute. Au-delà, l'appel renvoie un résultat d'outil avec isError: true et un message qui vous invite à réessayer dans une minute. La limite s'applique seulement à tools/call. C'est une protection contre les abus, fixée assez haut pour qu'une plateforme d'assistant très sollicitée ne l'atteigne pas.
• CORS. Ouvert à toutes les origines, pour que les outils qui s'exécutent dans un navigateur, comme le MCP Inspector, fonctionnent. Le serveur ne lit aucun témoin (cookie) ni aucun identifiant de connexion. Les réponses aux requêtes de pré-vérification peuvent être mises en cache pendant 24 heures.
• Mise en cache. Les réponses sont envoyées avec Cache-Control: no-store.

Documents de découverteCopier le lien de cette section

Matchai publie des descriptions du serveur lisibles par machine. Toutes sont en JSON, envoient un ETag, respectent If-None-Match et autorisent les lectures multi-origines.

Les sites de courtiers et les Pages Matchai servent leurs propres copies de ces documents. Elles pointent vers le même serveur MCP sur matchai.co.

Connecter un assistantCopier le lien de cette section

ClaudeCopier le lien de cette section

Pour ajouter le serveur à Claude Code depuis un terminal :

claude mcp add --transport http matchai https://matchai.co/mcp

ChatGPTCopier le lien de cette section

Autres clientsCopier le lien de cette section

La plupart des clients qui prennent en charge les serveurs MCP distants acceptent une URL dans un fichier de configuration :

{
  "mcpServers": {
    "matchai": {
      "url": "https://matchai.co/mcp"
    }
  }
}

Les clients qui demandent un type de transport doivent utiliser Streamable HTTP, sans authentification.

Appeler le serveur depuis votre propre codeCopier le lien de cette section

Les exemples utilisent curl. Chaque requête est un seul message JSON-RPC.

curl -s https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": { "name": "my-client", "version": "0.1.0" }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-11-25",
    "capabilities": { "tools": {}, "resources": {} },
    "serverInfo": {
      "name": "matchai-listings",
      "title": "Matchai",
      "version": "1.0.0",
      "websiteUrl": "https://matchai.co"
    },
    "instructions": "Matchai is a real estate platform where licensed brokers in Québec and across Canada publish their listings. …"
  }
}

curl -s -i https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "method": "notifications/initialized" }'

curl -s https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }'

curl -s https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "search_listings",
      "arguments": { "query": "3 bedroom condo in Laval under 600k", "limit": 3 }
    }
  }'

ErreursCopier le lien de cette section

Les problèmes liés au message lui-même sont des erreurs JSON-RPC. Les problèmes qu'un modèle peut corriger, comme un argument erroné ou une URL qui ne correspond à aucune inscription, reviennent sous forme de résultat d'outil avec isError: true et un message que le modèle peut lire.