Chercher des permis
Par département, commune, type de permis, état, dates, surface du terrain ou SIREN du demandeur ; avec Régional, aussi par note d’opportunité, niveau de risque et zonage.
search_permitsConnecteur pour Claude et ChatGPT
Posez vos questions en français : l’assistant cherche dans PermisAPI les permis, les ventes voisines, le zonage du PLU ou les risques, et vous répond. Sans code et sans rien installer : il suffit d’ajouter une adresse dans les réglages de votre assistant.
Le connecteur est inclus dans toutes les formules, accès gratuit compris. Il utilise les requêtes de votre formule : une recherche décompte une requête par permis renvoyé.
Si vous avez déjà une clé (elle commence par pk_live_ : gardez-la pour vous, comme un mot de passe), vous la collerez sur la page d’autorisation. Sinon, cette même page crée votre accès gratuit, sans carte bancaire : votre adresse e-mail et votre département suffisent, sans clé à copier. Vous pouvez aussi le créer ici.
À coller dans Claude ou dans ChatGPT. Votre assistant doit accepter les connecteurs personnalisés, ce qui dépend de son abonnement : avec l’offre gratuite de Claude, vous pouvez en ajouter un seul.
https://mcp.permisapi.fr/mcpLes intitulés des menus changent d’une version à l’autre : nous donnons aussi le nom anglais entre parenthèses.
Ajout manuel (connecteur personnalisé)
Cliquez sur Ouvrir dans l’annuaire de Claude : la fiche de PermisAPI s’ouvre sur claude.ai, et vous l’ajoutez à votre compte depuis cette fiche. Sinon, cliquez sur Ajout manuel : claude.ai ouvre la fenêtre d’ajout d’un connecteur personnalisé, avec le nom et l’adresse déjà remplis. À défaut, sur claude.ai ou dans l’application Claude, ouvrez Paramètres (Settings), puis Connecteurs (Connectors), choisissez Ajouter un connecteur personnalisé (Add custom connector) et saisissez le nom PermisAPI et l’adresse https://mcp.permisapi.fr/mcp.
Pour l’ajout manuel, laissez vides les champs OAuth des paramètres avancés : Claude s’enregistre tout seul. Validez avec Ajouter (Add).
Cliquez sur Se connecter (Connect) : la page d’autorisation de PermisAPI s’ouvre, à une adresse qui commence par https://mcp.permisapi.fr. Avec une clé : choisissez « J’ai une clé PermisAPI », collez-la et cliquez sur Autoriser. Sans compte : « Je n’ai pas encore de compte » crée votre accès gratuit (adresse e-mail et département), puis Revenir à Claude. La page reste valable 30 minutes.
Dans une conversation, vérifiez que PermisAPI est activé dans le menu des outils, puis posez votre question.
Ouvrez la page des plugins de ChatGPT, chatgpt.com/plugins, cliquez sur +, puis sur Ajouter un serveur MCP personnalisé (Add custom MCP server).
Nom : PermisAPI. Adresse du serveur : https://mcp.permisapi.fr/mcp. Authentification : OAuth. Validez.
La page d’autorisation de PermisAPI s’ouvre, à une adresse qui commence par https://mcp.permisapi.fr : avec une clé, choisissez « J’ai une clé PermisAPI », collez-la et cliquez sur Autoriser ; sans compte, « Je n’ai pas encore de compte » crée votre accès gratuit, puis revenez à ChatGPT.
Dans une conversation, ajoutez PermisAPI depuis le bouton + (outils), puis posez votre question.
L’ajout d’un serveur personnalisé dépend de votre abonnement ChatGPT. Si un intitulé diffère, cherchez « plugin » ou « MCP » dans ChatGPT.
L’assistant choisit lui-même les bons outils.
Tous en lecture seule. Un outil réservé à une formule supérieure renvoie une erreur 402 et l’assistant vous le dit.
Par département, commune, type de permis, état, dates, surface du terrain ou SIREN du demandeur ; avec Régional, aussi par note d’opportunité, niveau de risque et zonage.
search_permitsToutes les informations d’un permis à partir de son numéro.
get_permit_detailsMême avec des fautes de frappe ou sans accents, par exemple « rue de la republique bordeaux ».
fuzzy_search_addressesLes ventes immobilières les plus pertinentes autour du permis (données DVF), pour situer le prix du quartier.
find_dvf_neighborsUne note de 0 à 100 (faible, moyen, élevé, premium) calculée sur 11 critères.
get_mdb_scorePour chacun des 11 critères : son poids, sa valeur pour ce permis et une explication en français, avec ceux qui tirent la note vers le haut et vers le bas.
get_score_explanationLa zone du plan local d’urbanisme (urbaine, à urbaniser, agricole, naturelle) et un avis sur la constructibilité.
get_plu_zoningLes risques connus de la commune (inondation, séisme, mouvements de terrain, sites industriels classés proches) et un niveau global.
get_risksLe contour de la parcelle cadastrale et sa surface officielle, pour la voir sur une carte.
get_parcelle_geometryLe terrain est-il nu ou déjà bâti ? Le nombre et le type des bâtiments sur la parcelle.
get_existing_buildingsÀ partir de l’identifiant cadastral (14 caractères) : surface, commune, contour et permis liés à la parcelle.
get_parcelle_by_idLes parcelles autour d’un permis (de 10 à 2 000 mètres) et leurs permis, pour repérer un secteur qui bouge.
get_neighbor_parcelsDétail, entreprise demandeuse, ventes voisines, note d’opportunité, PLU et risques en une demande (6 requêtes décomptées). Avant Régional : le détail seul.
get_permit_full_viewUne fourchette de coût des travaux (basse, médiane, haute) et sa répartition par corps de métier.
get_economicsLes entreprises du bâtiment autour d’un permis (répertoire Sirene), par métier, rayon et effectif.
get_contractorsLes permis situés dans un polygone que vous fournissez : ZAC, périmètre d’opération, secteur de prospection.
search_permits_in_polygonLes parcelles, les bâtiments et les permis d’une commune, avec un indicateur de densité.
get_commune_density_statsJusqu’à 1 000 adresses, références cadastrales ou points GPS : les permis correspondants en une seule fois.
bulk_enrich_listAvec Claude ou ChatGPT, si vous avez une clé, vous la collez sur la page d’autorisation de PermisAPI, à une adresse qui commence par https://mcp.permisapi.fr, jamais dans la conversation ni sur un autre site. Elle sert une seule fois, à reconnaître votre compte, et n’est pas gardée. Si vous créez votre accès sur cette page, aucune clé n’est affichée ni transmise. Dans les deux cas, l’assistant reçoit un jeton d’accès valable 1 heure, renouvelé tant que vous vous en servez. En installation locale, la clé reste dans le fichier de configuration de votre ordinateur. Ce que le connecteur garde
Aucun des 18 outils ne modifie ni ne supprime de données. Les zones et les listes que vous envoyez (polygone, liste à enrichir) servent à la recherche et ne sont pas conservées.
Départements, historique et quota sont ceux de votre formule : un accès gratuit reste à 500 requêtes par mois, connecteur compris.
Depuis votre espace, assistant par assistant, ou d’un coup en régénérant votre clé : voir ci-dessous.
Dans votre espace, page « Pour les développeurs », chaque assistant autorisé est listé avec le site vers lequel il renvoie (claude.ai, chatgpt.com, ou localhost pour une application de votre ordinateur) et la date de son dernier usage. « Retirer l’accès » le coupe : ses appels suivants sont refusés.
Régénérez votre clé, sur la même page : tous vos assistants perdent l’accès, comme les logiciels qui utilisent l’ancienne clé (Cursor, Windsurf, Claude Desktop en installation locale).
Pour rebrancher un assistant, relancez la connexion depuis l’assistant et collez votre clé sur la page d’autorisation. Sans clé (accès créé depuis la page d’autorisation), votre espace en crée une, rubrique « Pour les développeurs ».
Le serveur existe aussi en installation locale (paquet permisapi-mcp, version 0.6.1 sur PyPI, Python 3.10 ou plus récent), et le serveur hébergé accepte la clé directement en en-tête.
python --version # 3.10 ou plus récent
pip install permisapi-mcpFichier claude_desktop_config.json : dans ~/Library/Application Support/Claude/ sur macOS, dans %APPDATA%\Claude\ sur Windows. Redémarrez Claude Desktop ensuite.
{
"mcpServers": {
"permisapi": {
"command": "permisapi-mcp",
"env": {
"PERMISAPI_KEY": "pk_live_VOTRE_CLE"
}
}
}
}Dans ~/.cursor/mcp.json pour Cursor ; Windsurf et les autres clients compatibles prennent la même adresse et le même en-tête dans leur propre fichier de configuration.
{
"mcpServers": {
"permisapi": {
"url": "https://mcp.permisapi.fr/mcp",
"headers": { "Authorization": "Bearer pk_live_VOTRE_CLE" }
}
}
}Code source et documentation complète : github.com/Evan-Crx/permisapi-mcp
La page d’autorisation reste valable 30 minutes. Relancez la connexion depuis l’assistant (Se connecter, Connect), puis collez votre clé, ou créez votre accès, sur la nouvelle page.
L’accès a été retiré depuis votre espace, votre clé a été régénérée, le connecteur n’a pas servi depuis 90 jours, ou la connexion a été coupée par précaution (un même jeton présenté de nouveau plus de 30 secondes après son premier usage, ou par une autre application). Relancez la connexion depuis l’assistant et collez votre clé actuelle (sans clé : votre espace en crée une, rubrique « Pour les développeurs »).
Elle fonctionne toujours, rien à changer. Pour un nouvel ajout, utilisez https://mcp.permisapi.fr/mcp, sans barre finale.
Les ventes voisines, la note d’opportunité et son explication, le PLU, les risques, la parcelle, les bâtiments, les parcelles voisines, le dossier complet, le budget du chantier et les entreprises proches demandent la formule Régional ou plus. La recherche dans une zone dessinée, la densité des communes et l’enrichissement de liste demandent Business. Voir les formules
Vous avez utilisé les requêtes du mois : 500 avec l’accès gratuit, 2 000 avec Découverte, 5 000 avec Explorateur, 10 000 avec Régional, 50 000 avec Pro, 500 000 avec Business. Le compteur repart à zéro le premier du mois suivant ; vous pouvez aussi changer de formule. Voir les formules
Vérifiez la syntaxe du fichier JSON (une virgule oubliée suffit), que PERMISAPI_KEY est bien renseignée et commence par pk_live_, puis redémarrez Claude Desktop. Les journaux sont dans le menu Aide (Help), Ouvrir le dossier des journaux (Open Logs Directory) : cherchez permisapi-mcp. Vous pouvez aussi lancer permisapi-mcp dans un terminal pour voir l’erreur, et l’envoyer à evan@permisapi.fr.
Votre Python est sans doute plus ancien que 3.10, le minimum du kit MCP. Le plus simple : installer uv, qui lance le serveur dans un Python 3.11 isolé sans toucher à votre installation.
# macOS, Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
uvx --python 3.11 permisapi-mcpPuis, dans la configuration de Claude Desktop :
{
"mcpServers": {
"permisapi": {
"command": "uvx",
"args": ["--python", "3.11", "permisapi-mcp"],
"env": { "PERMISAPI_KEY": "pk_live_VOTRE_CLE" }
}
}
}Accès gratuit sur un département, sans carte bancaire. Bloqué quelque part ? Écrivez à Evan, il répond lui-même : evan@permisapi.fr