Utiliser BuildData depuis un assistant d'IA (MCP)

BuildData offre un serveur MCP distant. Claude, ChatGPT, Cursor, GitHub Copilot dans VS Code et les autres clients MCP peuvent chercher des permis, des grands projets et des adresses pour vous, avec votre clé API configurée une seule fois : dans la configuration du client, ou sur une page de connexion BuildData pour les connecteurs de claude.ai et de ChatGPT.

Votre clé va dans la configuration du client, jamais dans un message de conversation. Tout ce qui est tapé dans une conversation reste dans son historique et est transmis au fournisseur du modèle. Si une clé a été collée dans une conversation, remplacez-la depuis votre tableau de bord.

Le serveur

Pas encore de clé? Inscrivez-vous gratuitement, sans carte de crédit. Les clients copient la leur depuis le tableau de bord. Remplacez YOUR_KEY par votre clé dans les exemples ci-dessous.

Claude Code

Lancez une seule fois dans un terminal :

claude mcp add --transport http builddata https://api.builddata.ca/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Desktop

Un connecteur ajouté dans claude.ai (plus bas) apparaît aussi dans Claude Desktop, sans rien à installer. Pour passer plutôt par un fichier de configuration, ouvrez Settings, Developer, Edit Config, et ajoutez ceci à claude_desktop_config.json. Node.js est requis pour la passerelle mcp-remote. Redémarrez ensuite Claude Desktop.

{
  "mcpServers": {
    "builddata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.builddata.ca/mcp",
        "--header",
        "Authorization:${BUILDDATA_AUTH}"
      ],
      "env": {
        "BUILDDATA_AUTH": "Bearer YOUR_KEY"
      }
    }
  }
}

Claude sur le Web et sur mobile (claude.ai)

Dans claude.ai, ouvrez Settings, Connectors, puis choisissez Add custom connector. Nommez-le BuildData, collez https://api.builddata.ca/mcp comme URL, laissez vides les champs OAuth sous Advanced settings et ajoutez-le. Claude ouvre ensuite une page BuildData : collez-y votre clé, pas dans la conversation, puis choisissez Connecter. Le connecteur fonctionne dans Claude sur le Web, dans l'application de bureau et sur mobile. Pour le débrancher, retirez le connecteur, ou remplacez votre clé depuis le tableau de bord, ce qui débranche tous les assistants qui l'utilisent. Avec les forfaits Team et Enterprise, un propriétaire doit d'abord ajouter le connecteur dans les paramètres de l'organisation.

Cursor

Ajoutez ceci à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans un seul projet :

{
  "mcpServers": {
    "builddata": {
      "url": "https://api.builddata.ca/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

VS Code et GitHub Copilot

Ajoutez ceci à .vscode/mcp.json. VS Code demande la clé au premier démarrage du serveur et la conserve chiffrée : elle ne se retrouve ni dans le fichier ni dans une conversation Copilot.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "builddata-key",
      "description": "BuildData API key",
      "password": true
    }
  ],
  "servers": {
    "builddata": {
      "type": "http",
      "url": "https://api.builddata.ca/mcp",
      "headers": {
        "Authorization": "Bearer ${input:builddata-key}"
      }
    }
  }
}

Tout autre client

La plupart des clients compatibles Streamable HTTP acceptent une URL de serveur et des en-têtes sous cette forme :

{
  "mcpServers": {
    "builddata": {
      "type": "http",
      "url": "https://api.builddata.ca/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

ChatGPT

Dans ChatGPT, activez le mode développeur sous Settings, Apps & Connectors, Advanced settings. Créez ensuite un connecteur : collez https://api.builddata.ca/mcp comme URL du serveur MCP et choisissez OAuth comme authentification. ChatGPT ouvre une page BuildData où vous collez votre clé avant de choisir Connecter. Dans un espace de travail d'entreprise, un administrateur doit parfois autoriser d'abord les connecteurs personnalisés.

Outils

Chaque outil appelle la route REST indiquée avec votre clé et renvoie donc ce que cette route renvoie, réduit à 25 lignes par défaut, avec une indication pour la page suivante.

Quota et forfait gratuit

Chaque appel d'outil compte pour une requête sur le quota quotidien de votre clé, comme si vous appeliez la route vous-même. La connexion et la liste des outils ne coûtent rien. Avec le forfait gratuit, les dossiers publiés pour la première fois au cours des 30 derniers jours sont retenus, et chaque réponse le précise, ce que l'assistant vous relaiera.

Exemples de questions

• Les permis de construction neuve de plus de 1 M$ délivrés à Calgary depuis janvier.
• Tout ce qui est au dossier au 7236 10 Street NE, à Calgary.
• Les projets d'hôpitaux en construction en Ontario.
• Quelles villes publient des permis d'aménagement?