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.
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
| Outil | Ce qu’il fait | Formule |
|---|---|---|
search_permits | Chercher des permis (département, commune, type, état, dates, surface, SIREN ; avec Régional, aussi par note, risque et zonage) | Toutes |
get_permit_details | La fiche d’un permis | Toutes |
fuzzy_search_addresses | Chercher par adresse, même avec des fautes | Toutes |
find_dvf_neighbors | Les ventes voisines (DVF) | Dès Régional |
get_mdb_score | La note d’opportunité de 0 à 100 | Dès Régional |
get_score_explanation | Le détail des 11 signaux de la note | Dès Régional |
get_plu_zoning | Le zonage du PLU | Dès Régional |
get_risks | Les risques de la commune et les sites Seveso proches | Dès Régional |
get_parcelle_geometry | La parcelle du permis | Dès Régional |
get_existing_buildings | Les bâtiments déjà présents sur la parcelle | Dès Régional |
get_parcelle_by_id | Une parcelle par sa référence cadastrale | Dès Régional |
get_neighbor_parcels | Les parcelles voisines et leurs permis | Dès Régional |
get_permit_full_view | Le dossier complet d’un permis (6 requêtes décomptées) | Dès Régional |
get_economics | Le budget estimé du chantier | Dès Régional |
get_contractors | Les entreprises du bâtiment proches | Dès Régional |
search_permits_in_polygon | Chercher dans une zone dessinée | Dès Business |
get_commune_density_stats | La densité d’une commune | Dès Business |
bulk_enrich_list | Enrichir une liste de 1 000 adresses au plus | Dè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
- « 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. »
- « Pour le permis 0130552500467, quel est le zonage du PLU et quels sont les risques connus ? » (formule Régional et suivantes)
- « 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)
- « 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é
- 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.
- Lecture seule. Aucun des 18 outils ne modifie ni ne supprime de données.
- 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é.
- 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.