Aller au contenu
Pour
tous les clients PermisAPI, de l’accès gratuit à Entreprise, surtout ceux qui ne veulent pas écrire de code.
Temps
4 minutes de lecture.
Budget
inclus dans toutes les formules, accès gratuit compris (le connecteur utilise les requêtes de votre formule).

PermisAPI dans Claude, ChatGPT et Cursor : le connecteur PermisAPI (MCP)

Pour qui : tous les clients PermisAPI, de l’accès gratuit à Entreprise, surtout ceux qui ne veulent pas écrire de code.

Temps : 4 minutes de lecture.

Budget : inclus dans toutes les formules, accès gratuit compris (le connecteur utilise les requêtes de votre formule).

En bref : le connecteur PermisAPI branche les permis de construire dans Claude et ChatGPT (connecteur hébergé, sans rien installer) ou dans Claude Desktop, Cursor et Windsurf (installation locale). Vous posez votre question en français, l’assistant choisit lui-même parmi 18 outils en lecture seule et vous répond avec les données de l’API.

Recevez chaque mois les nouveaux permis de votre commune

Le lendemain de chaque publication de l’État, une fois par mois, avec l’entreprise qui porte le projet quand c’en est une. Gratuit.

Un e-mail de confirmation part d’abord : rien ne vous est envoyé sans votre clic. Chaque e-mail permet d’arrêter en un clic.

Votre adresse sert seulement à cet envoi, elle n’est ni vendue ni prêtée. Vos données

Le problème

Vous utilisez un assistant comme Claude ou ChatGPT au quotidien, et vous voulez qu’il regarde des permis. Sans connecteur, il faut copier-coller les résultats du tableau de bord ou écrire un script. Le connecteur supprime cette étape.

C’est quoi MCP ?

Le Model Context Protocol (MCP) est un protocole ouvert, publié par Anthropic en novembre 2024, qui permet à un assistant d’appeler des outils extérieurs :

  • côté service, un serveur MCP décrit ses outils (ce qu’ils font, les paramètres qu’ils acceptent) ;
  • côté assistant, le client découvre ces outils et les appelle quand votre question le demande.

Vous écrivez : « Quels permis de logement ont été autorisés dans le 18e arrondissement de Paris ces trois derniers mois ? ». L’assistant fait les appels et vous répond.

Les 18 outils

OutilCe qu’il faitFormule
search_permitsChercher des permis (département, commune, type, état, dates, surface, SIREN ; avec Régional, aussi par note, risque et zonage)Toutes
get_permit_detailsLa fiche d’un permisToutes
fuzzy_search_addressesChercher par adresse, même avec des fautesToutes
find_dvf_neighborsLes ventes voisines (DVF)Dès Régional
get_mdb_scoreLa note d’opportunité de 0 à 100Dès Régional
get_score_explanationLe détail des 11 signaux de la noteDès Régional
get_plu_zoningLe zonage du PLUDès Régional
get_risksLes risques de la commune et les sites Seveso prochesDès Régional
get_parcelle_geometryLa parcelle du permisDès Régional
get_existing_buildingsLes bâtiments déjà présents sur la parcelleDès Régional
get_parcelle_by_idUne parcelle par sa référence cadastraleDès Régional
get_neighbor_parcelsLes parcelles voisines et leurs permisDès Régional
get_permit_full_viewLe dossier complet d’un permis (6 requêtes décomptées)Dès Régional
get_economicsLe budget estimé du chantierDès Régional
get_contractorsLes entreprises du bâtiment prochesDès Régional
search_permits_in_polygonChercher dans une zone dessinéeDès Business
get_commune_density_statsLa densité d’une communeDès Business
bulk_enrich_listEnrichir une liste de 1 000 adresses au plusDès Business

Si vous demandez une donnée que votre formule ne comprend pas, l’assistant reçoit un refus qui explique quelle formule la donne, et vous le dit.

Installer le connecteur

Claude et ChatGPT (connecteur hébergé) : ajoutez un connecteur personnalisé avec l’adresse https://mcp.permisapi.fr/mcp/, puis autorisez-le : une page de PermisAPI vous demande votre clé, et l’assistant reçoit un jeton d’accès, jamais la clé. Les menus exacts de Claude et de ChatGPT sont décrits pas à pas sur permisapi.fr/mcp. Votre assistant doit accepter les connecteurs personnalisés, ce qui dépend de son abonnement.

Claude Desktop (installation locale) :

pip install permisapi-mcp

Puis, dans le fichier de configuration de Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "permisapi": {
      "command": "permisapi-mcp",
      "env": {
        "PERMISAPI_KEY": "pk_live_VOTRE_CLE"
      }
    }
  }
}

Cursor : le connecteur hébergé, avec votre clé dans l’en-tête :

{
  "mcpServers": {
    "permisapi": {
      "url": "https://mcp.permisapi.fr/mcp/",
      "headers": { "Authorization": "Bearer pk_live_VOTRE_CLE" }
    }
  }
}

Quatre exemples de questions

  1. « Liste les permis de construire de logements autorisés en Gironde depuis le 1er juillet, avec le nom du demandeur et la surface du terrain. »
  2. « Pour le permis 0130552500467, quel est le zonage du PLU et quels sont les risques connus ? » (formule Régional et suivantes)
  3. « Fais-moi le dossier complet du permis 0130552500467 : détail, entreprise du demandeur, ventes voisines, note d’opportunité, zonage et risques. » (formule Régional et suivantes)
  4. « Compare le nombre de permis de logement déposés en 2025 à Bordeaux, Toulouse et Lyon. » (il faut une formule qui couvre ces trois départements)

L’assistant affiche les outils qu’il appelle : vous voyez ce qui a été demandé à PermisAPI.

Sécurité

  1. Votre clé reste chez vous. Avec le connecteur hébergé, vous la collez sur la page d’autorisation de PermisAPI, pas dans la conversation. En installation locale, elle reste dans le fichier de configuration de votre ordinateur.
  2. Lecture seule. Aucun des 18 outils ne modifie ni ne supprime de données.
  3. Votre formule s’applique. Départements, historique et quota sont ceux de votre formule : un accès gratuit reste à 500 requêtes par mois, connecteur compris. Une recherche décompte une requête par permis renvoyé.
  4. Révocation. Supprimez le connecteur dans votre assistant, ou régénérez votre clé depuis votre tableau de bord : l’ancienne cesse de fonctionner.

Ce que le connecteur ne fait pas

  • Créer une alerte : les alertes se créent avec l’API (POST /v1/alerts) ou depuis le tableau de bord. Aucun outil du connecteur n’écrit de données.

Pourquoi on l’a construit

Beaucoup de personnes qui suivent les permis de construire ne programment pas. Le connecteur leur donne accès aux mêmes données que l’API, avec les mêmes droits, en posant des questions en français. Une suggestion ? Écrivez-moi à evan@permisapi.fr.

Les nouveaux permis de votre zone, chaque mois

Un e-mail le lendemain de chaque publication de l’État. Gratuit, sans compte.

Un e-mail de confirmation part d’abord : rien ne vous est envoyé sans votre clic. Chaque e-mail permet d’arrêter en un clic.

Votre adresse sert seulement à cet envoi, elle n’est ni vendue ni prêtée. Vos données

Regardez les permis de votre secteur.

Un département au choix, les nouveaux permis des 2 derniers mois, sans carte bancaire. Une question ? Écrivez à Evan : evan@permisapi.fr

Lire la documentation

Autres tutoriels