Smart BTP Developer Resources

Connecter un agent à Smart BTP avec MCP

Smart BTP expose un serveur MCP Streamable HTTP authentifié pour consulter les projets, les DPGF, les estimations et les preuves documentaires. L’intégration publique actuelle est strictement en lecture seule et respecte les droits de l’utilisateur ou de son organisation.

Spécification OpenAPI Instructions agents

Démarrage rapide

  1. 01Connectez-vous à Smart BTP puis ouvrez Configuration → Intégrations → MCP.
  2. 02Créez un jeton nommé pour votre agent. Le secret n’est affiché qu’une fois et expire automatiquement.
  3. 03Configurez le transport Streamable HTTP avec l’URL https://www.smartbtp.ai/api/mcp.
  4. 04Envoyez le jeton dans l’en-tête Authorization: Bearer … et commencez par projects_list.
{
  "mcpServers": {
    "smartbtp": {
      "type": "streamable-http",
      "url": "https://www.smartbtp.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <VOTRE_JETON_MCP>"
      }
    }
  }
}

Outils MCP disponibles

projects_list

Lister jusqu’à 50 projets accessibles et rechercher un projet par son nom.

project_get

Lire la synthèse, la structure du site, les lots et l’index documentaire.

project_get_readiness

Contrôler les blocages et avertissements des étapes 1 à 3.

project_get_dpgf_matches

Examiner les lignes DPGF et leurs correspondances documentaires.

project_get_estimation

Consulter prestations, quantités, rendements, coûts et zones de travail.

project_search_evidence

Rechercher une preuve dans les analyses structurées et l’estimation.

Quand utiliser Smart BTP

Utilisez le serveur lorsqu’un utilisateur autorisé veut retrouver un dossier BTP, contrôler sa préparation, rapprocher une ligne DPGF des documents, vérifier une estimation ou obtenir une preuve précise. Les réponses doivent toujours distinguer les données retournées des déductions de l’agent et signaler les informations manquantes.

Smart BTP n’est pas un service de validation juridique ou contractuelle. Les résultats d’analyse et de chiffrage doivent être relus par l’entreprise avant toute utilisation dans une offre ou sur un chantier.