Aller au contenu
deveras.
Publier

Serveur MCP

Le Model Context Protocol permet à un assistant d’utiliser des outils externes. Avec notre serveur, Claude ou un autre assistant cherche des biens à louer ou à vendre sur Deveras, les compare et relie chaque annonce à sa page.

Adresse du serveur

URL
https://www.deveras.app/api/mcp

Transport Streamable HTTP, sans état et en lecture seule. Ni compte ni clé nécessaires.

Avec Claude

  1. Dans Claude (web ou bureau), ouvre les Paramètres puis Connecteurs.

  2. Choisis « Ajouter un connecteur personnalisé » et colle l’adresse du serveur.

  3. Dans une conversation, active le connecteur et demande ce que tu cherches.

Avec Claude Code

Terminal
claude mcp add --transport http deveras-listings https://www.deveras.app/api/mcp

Avec d’autres assistants

Tout client compatible MCP en HTTP fonctionne. La plupart acceptent une configuration comme celle-ci :

JSON
{
  "mcpServers": {
    "deveras-listings": {
      "url": "https://www.deveras.app/api/mcp"
    }
  }
}

Si ton client n’accepte que des serveurs locaux, passe par un pont :

Terminal
npx -y mcp-remote https://www.deveras.app/api/mcp

Avec une clé

La limite est celle de l’API : 60 appels par minute sans clé, 600 avec. Chaque appel d’outil compte pour une requête. Pour utiliser ta clé, ajoute l’en-tête Authorization :

Terminal
claude mcp add --transport http deveras-listings https://www.deveras.app/api/mcp \
  --header "Authorization: Bearer $API_KEY"
JSON
{
  "mcpServers": {
    "deveras-listings": {
      "url": "https://www.deveras.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Outils

search_listings
Cherche des annonces avec les mêmes filtres que l’API : lieu, prix, taille, équipements, durée.
get_listing
Renvoie une annonce complète à partir de son identifiant ou de l’adresse de sa page.
list_places
Liste les villes et les quartiers disponibles, avec le nombre d’annonces.
get_profile
Renvoie le profil public d’un propriétaire ou d’un agent.

À essayer

  • Trouve des appartements meublés de 2 chambres à Playa del Carmen à moins de 25 000 pesos par mois.
  • Quels quartiers ont le plus d’annonces qui acceptent les animaux ?
  • Compare ces trois annonces et dis-moi lesquelles ont un bien vérifié.

Mention et vie privée

Les outils demandent à l’assistant d’afficher la mention « Annonces de Deveras » et le lien de chaque annonce. Comme dans l’API, il n’y a ni coordonnées ni adresse exacte : pour prendre contact, l’assistant renvoie vers la page de l’annonce.