Fixatia
Pour les développeurs

Intégration du serveur MCP

Connectez Claude et d'autres assistants IA à la base de données immobilière de Fixatia en utilisant le Protocole de Contexte de Modèle

Qu'est-ce que le MCP ?

Le Protocole de Contexte de Modèle (MCP) est une norme ouverte qui permet aux assistants IA comme Claude d'accéder de manière sécurisée à des sources de données externes. Le serveur MCP de Fixatia fournit un accès en temps réel à notre base de données d'enchères immobilières européennes, permettant aux assistants IA de rechercher des propriétés, de récupérer des détails et de découvrir des filtres disponibles.

Recherchez des milliers de propriétés aux enchères dans 6 pays européens avec des filtres avancés

Obtenez des détails complets sur les propriétés, y compris des estimations de rénovation, des calculs de ROI et des descriptions multilingues

Découvrez dynamiquement les options de filtrage disponibles pour construire des requêtes de recherche puissantes

En savoir plus sur le MCP

Démarrage rapide

1URL du serveur

Le serveur MCP de Fixatia est disponible à l'adresse :

https://mcp.fixatia.com/api/mcp

2Configurer Claude Desktop

Ajoutez ce qui suit à votre fichier de configuration Claude Desktop :

Windows : %APPDATA%\Claude\claude_desktop_config.json

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fixatia": {
      "url": "https://mcp.fixatia.com/api/mcp"
    }
  }
}

3Commencer à utiliser

Redémarrez Claude Desktop et commencez à poser des questions sur les propriétés. Claude utilisera automatiquement les outils Fixatia pour rechercher et récupérer des informations sur les propriétés.

Essayez de demander : "Trouvez-moi des propriétés au Portugal à moins de 150 000 € avec un potentiel de ROI d'au moins 20 %"

Outils Disponibles

Le serveur Fixatia MCP fournit trois outils puissants pour interagir avec notre base de données immobilière :

rechercher_propriétés

Recherchez des propriétés aux enchères immobilières à travers l'Europe. Filtrez par pays, ville, prix, type de propriété, potentiel de ROI, et plus encore. Renvoie une liste de propriétés correspondantes avec des détails clés incluant les prix d'enchères, les valeurs du marché, et les métriques d'investissement.

Paramètres

ParameterTypeRequiredDescription
querystringOptionnelRecherche textuelle pour le titre de la propriété, la ville ou la région
countrystringOptionnelCode du pays : es (Espagne), pt (Portugal), it (Italie), fr (France), de (Allemagne), hr (Croatie)
regionstringOptionnelNom de la région dans le pays
citystringOptionnelNom de la ville
propertyTypestringOptionnelType de propriété : APPARTEMENT, MAISON, VILLA, TERRAIN, ou COMMERCIAL
minPricenumberOptionnelPrix d'enchère minimum en EUR
maxPricenumberOptionnelPrix d'enchère maximum en EUR
minRoinumberOptionnelPourcentage de ROI minimum (par exemple, 20 pour 20 %)
bedroomsnumberOptionnelNombre minimum de chambres
maxResultsnumberOptionnelNombre maximum de résultats à renvoyer (par défaut : 10, max : 50)
sortBystringOptionnelOrdre de tri : le plus récent, prix-bas, prix-haut, roi-haut, ou enchère-prochaine
localestringOptionnelLangue pour les titres/descriptions (par défaut : en). Prend en charge 18 langues.

Demande Exemple

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_properties",
    "arguments": {
      "country": "pt",
      "maxPrice": 150000,
      "minRoi": 20,
      "maxResults": 5
    }
  },
  "id": 1
}

Réponse Exemple

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": {
        "totalCount": 12,
        "results": [
          {
            "id": "b45dc4fc14134da69e9f800f8",
            "title": "2-Bedroom Apartment · Lisbon",
            "country": "pt",
            "city": "Lisboa",
            "propertyType": "APARTMENT",
            "auctionPrice": 120000,
            "marketValue": 165000,
            "potentialRoi": 26.5,
            "bedrooms": 2,
            "squareMeters": 75
          }
        ]
      }
    }]
  }
}

obtenir_propriété

Obtenez les détails complets d'une propriété spécifique par son ID. Renvoie des informations complètes incluant des descriptions multilingues, des images, des coordonnées de localisation, des estimations de rénovation, des détails d'enchères, et des métriques d'investissement.

Paramètres

ParameterTypeRequiredDescription
idstringRequisL'ID de la propriété (obtenu à partir des résultats de recherche)
localestringOptionnelLangue pour le titre/la description (par défaut : en). Prend en charge 18 langues.

Demande Exemple

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_property",
    "arguments": {
      "id": "b45dc4fc14134da69e9f800f8",
      "locale": "en"
    }
  },
  "id": 2
}

obtenir_options_filtre

Obtenez les options de filtre disponibles incluant la liste des pays, régions, villes, types de propriétés, et plages de prix/ROI. Utile pour comprendre quels paramètres de recherche sont disponibles et construire des interfaces de filtre dynamiques.

Cet outil ne prend aucun paramètre.

Demande Exemple

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_filter_options",
    "arguments": {}
  },
  "id": 3
}

Réponse Exemple

{
  "countries": [
    { "code": "pt", "name": "Portugal", "propertyCount": 45 },
    { "code": "es", "name": "Spain", "propertyCount": 120 },
    { "code": "it", "name": "Italy", "propertyCount": 89 }
  ],
  "propertyTypes": [
    { "type": "APARTMENT", "count": 156 },
    { "type": "HOUSE", "count": 78 }
  ],
  "priceRange": { "min": 5000, "max": 800000 },
  "roiRange": { "min": -5, "max": 45 }
}

send_property_inquiry

OAuth 2.1

Envoyez une demande concernant une propriété pour exprimer votre intérêt. Cet outil nécessite une authentification OAuth 2.1 avec PKCE.

Authentification requise (OAuth 2.1)

Cet outil utilise OAuth 2.1 avec PKCE pour une authentification sécurisée. Le flux est:

  • L'utilisateur clique sur 'Autoriser' et se connecte via le navigateur
  • Le code d'autorisation est échangé contre un jeton d'accès (protégé par PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Paramètres

ParameterTypeRequiredDescription
propertyIdstringRequisL'ID de la propriété concernée
messagestringRequisVotre message de demande, minimum 10 caractères

Demande Exemple

// Requires Bearer token authentication
// curl -X POST https://mcp.fixatia.com/api/mcp \
//   -H "Authorization: Bearer YOUR_TOKEN" \
//   -H "Content-Type: application/json" \
//   -d '...'

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_property_inquiry",
    "arguments": {
      "propertyId": "b45dc4fc14134da69e9f800f8",
      "message": "I'm interested in this property. Is it still available?"
    }
  },
  "id": 4
}

Réponse Exemple

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{
      "type": "text",
      "text": "Inquiry sent successfully! The property owner will be notified and may contact you."
    }]
  }
}

Référence de l'API HTTP

Le serveur MCP expose également une API HTTP directe pour un accès programmatique. Toutes les requêtes utilisent le protocole JSON-RPC 2.0.

Points de terminaison

GET
/api/mcp

Vérification de l'état et informations sur le serveur. Renvoie le nom du serveur, la version, la version du protocole et les outils disponibles.

POST
/api/mcp

Requêtes JSON-RPC 2.0 pour l'exécution d'outils. Prend en charge les méthodes initialize, tools/list, tools/call et ping.

Méthodes prises en charge

  • initialize - Initialiser la session MCP et obtenir les capacités du serveur
  • tools/list - Lister tous les outils disponibles avec leurs schémas
  • tools/call - Exécuter un outil spécifique avec des arguments
  • ping - Vérification de l'état par ping

Exemple cURL

curl -X POST https://mcp.fixatia.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_properties",
      "arguments": {
        "country": "pt",
        "maxPrice": 150000
      }
    },
    "id": 1
  }'

Essayez-le

Testez le serveur MCP directement depuis votre navigateur. Sélectionnez un outil et configurez les paramètres.

Sélectionnez un outil

Gestion des erreurs

Le serveur renvoie des réponses d'erreur JSON-RPC 2.0 standard. Voici les codes d'erreur courants :

CodeMessageDescription
-32600Requête invalideLe JSON envoyé n'est pas un objet Request valide
-32601Méthode non trouvéeLa méthode demandée n'existe pas ou n'est pas disponible
-32602Paramètres invalidesParamètre(s) de méthode invalide(s) - vérifiez les champs et types requis
-32603Erreur interneErreur JSON-RPC interne ou problème côté serveur

Exemple de réponse d'erreur

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: Property ID is required"
  }
}

Langues prises en charge

Les titres et descriptions des propriétés sont disponibles en 18 langues. Utilisez le paramètre de locale pour obtenir le contenu dans votre langue préférée :

Anglais (en), Allemand (de), Français (fr), Espagnol (es), Italien (it), Portugais (pt), Néerlandais (nl), Polonais (pl), Grec (el), Roumain (ro), Tchèque (cs), Hongrois (hu), Chinois (zh), Arabe (ar), Russe (ru), Japonais (ja), Coréen (ko), Croate (hr)

Documentation lisible par machine

Pour les assistants IA et les outils automatisés, nous fournissons des fichiers de documentation en texte brut suivant la norme llms.txt :

llms.txt

Documentation concise avec l'URL du serveur, la configuration et les résumés des outils

llms-full.txt

Documentation complète incluant tous les paramètres, exemples de requêtes/réponses et codes d'erreur

En savoir plus sur la norme llms.txt sur llmstxt.org

Besoin d'aide ?

Si vous avez des questions sur l'intégration avec le serveur Fixatia MCP ou si vous rencontrez des problèmes, notre équipe de support développeur est là pour vous aider.

Contacter le support développeurSignaler un problème sur GitHub