Le serveur MCP Costructor permet à votre assistant IA de lire et d'agir sur vos données Costructor via un ensemble d'outils dédiés. Vous pilotez ainsi Costructor en conversant avec le LLM de votre choix.

Il implémente le Model Context Protocol, un standard ouvert créé par Anthropic et maintenu par la communauté, qui permet aux grands modèles de langage de découvrir et d'appeler les outils exposés par un serveur. Du point de vue de l'utilisateur final, une fois le serveur installé, votre assistant gagne un nouvel ensemble de capacités.

Point de terminaison (endpoint)

Le serveur réutilise le même fournisseur d'identité que l'API Costructor. Les scopes OAuth documentés dans la référence de l'API régissent ce que chaque outil peut faire en votre nom.

Ce que vous pouvez faire

Une fois connecté, votre assistant peut réaliser des actions et écritures sur votre compte :

• Créer de nouveaux éléments dans votre compte Costructor
• Modifier et mettre à jour des éléments existants

L'installer

Choisissez le client qui correspond à votre assistant. Certains clients (Cursor, VS Code) proposent une installation en un clic ; d'autres (Claude, ChatGPT, Le Chat) demandent de coller l'URL dans leurs paramètres de connecteurs.

Pour la configuration manuelle, utilisez simplement l'URL du serveur et l'authentification OAuth :

{
  "mcpServers": {
    "costructor": {
      "url": "https://api.costructor.co/mcp"
    }
  }
}

Au premier appel, votre client ouvre le flux OAuth Costructor dans le navigateur pour autoriser la connexion.

Authentification (OAuth)

1. Ajoutez le serveur MCP dans votre client avec l'URL ci-dessus.
2. Au premier appel d'outil, le client déclenche le flux OAuth et ouvre une page de connexion Costructor.
3. Connectez-vous et autorisez l'accès. Les scopes accordés déterminent les actions autorisées.
4. Le client stocke le jeton d'accès et rafraîchit automatiquement la session.

Vous pouvez révoquer l'accès à tout moment depuis la section applications connectées de votre compte Costructor.

Lien avec l'API Costructor

Le serveur MCP est construit au-dessus de l'API Costructor et utilise ses endpoints en aval pour agir en votre nom. Les outils MCP sont pensés autour de ce dont un assistant a besoin pour accomplir une tâche, plutôt que de refléter l'API à l'identique : un seul outil peut combiner plusieurs endpoints, ajouter de la validation, ou adapter les entrées/sorties à un usage conversationnel. Il n'y a donc pas de correspondance un-à-un entre un outil et un endpoint de l'API.

Utilisez l'API directement si vous construisez une intégration backend sur mesure, un connecteur ERP, ou un produit embarqué. Utilisez le serveur MCP si vous souhaitez une interface conversationnelle et ad hoc vers votre compte Costructor via un assistant que vous utilisez déjà.

Utiliser l'API directement

L'API Costructor utilise des clés API pour authentifier les requêtes. Vous pouvez consulter et gérer vos clés API via Réglages > API.

Toutes les requêtes API nécessitent un Bearer Token. Passez votre clé API dans l'en-tête Authorization au format Bearer YOUR_API_TOKEN :

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.costructor.co/external/v1/contacts

Consultez la référence de l'API pour la liste complète des endpoints.

Modèle de sécurité

• Chaque appel d'outil est authentifié en votre nom : le serveur détient un jeton d'accès OAuth émis pour votre utilisateur Costructor. Il ne peut pas agir au-delà de ce que votre rôle et votre organisation autorisent.
• Le serveur MCP Costructor lui-même ne stocke pas le contenu des conversations, ni les transcriptions, ni vos données métier ; il ne fait que relayer les appels d'outils vers l'API.
• Le client MCP (Claude, ChatGPT, Cursor, etc.) détient la conversation, y compris les données renvoyées par les outils. Vérifiez la politique de traitement des données de votre client avant de vous connecter.
• Vous pouvez révoquer l'accès à tout moment depuis la section applications connectées de votre compte Costructor.

Mis à jour le : 22/07/2026