DM Champ Docs

Connecter des assistants IA (MCP)

DM Champ fournit un serveur MCP officiel — un point de terminaison du protocole Model Context Protocol qui permet aux assistants IA comme Claude Code, Claude Desktop, ChatGPT, Cursor et vos propres applications de piloter directement votre compte DM Champ. Posez vos questions en langage naturel (« liste mes campagnes actives », « ajoute ce prospect », « combien m’a coûté l’IA cette semaine ? ») et l’assistant appellera l’API DM Champ pour vous.

Il s’agit de la même API v1 documentée dans la section API, authentifiée avec votre propre clé API. Le serveur MCP crée un outil pour chaque opération de notre spécification d’API publiée ; il couvre donc la majeure partie, mais pas la totalité, de l’API v1 : contacts, messages, campagnes, agents IA, base de connaissances, rendez-vous, analyses, tags, listes et sous-comptes. Les diffusions, les automatisations et les transactions ne sont pas encore disponibles en tant qu’outils MCP — utilisez directement l’API REST pour celles-ci. Dans ce qui est exposé, il n’y a pas d’autorisations par outil ni de valeur par défaut en lecture seule, la clé API constitue donc l’unique contrôle d’accès.

  • Point de terminaison : https://mcp.youraiconnector.com/mcp
  • Authentification : votre clé API DM Champ (envoyée via l’en-tête X-API-Key)
  • Prérequis : un forfait avec accès à l’API. Créer une clé API →

Votre clé API agit sur votre propre compte, avec les mêmes autorisations que le reste de l’API — et peut lire les comptes clients que vous gérez, si vous avez un forfait agence (voir ci-dessous). Traitez-la comme un mot de passe. Vous pouvez la révoquer à tout moment depuis Paramètres → Intégrations → Clé API, ce qui coupe instantanément l’accès de l’assistant.

Claude Code 

claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Exécutez ensuite /mcp dans Claude Code pour confirmer qu’il affiche dm-champ ✓ connecté.

Par défaut, le serveur est ajouté à la portée locale (juste vous, ce projet). Utilisez --scope user pour le rendre disponible dans tous vos projets, ou --scope project to commit it to a repo’s .mcp.json pour votre équipe :

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Modifiez votre claude_desktop_config.json (Paramètres → Développeur → Modifier la configuration) et ajoutez :

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Redémarrez Claude Desktop. Les outils DM Champ apparaîtront dans le menu des outils.

ChatGPT

Les connecteurs MCP personnalisés sont disponibles sur ChatGPT Business, Enterprise et Pro. Un propriétaire ou un administrateur d’espace de travail doit d’abord activer le mode développeur / connecteurs personnalisés dans les paramètres de l’espace de travail — sans cela, l’option de création de connecteur n’apparaîtra jamais.

Ensuite, créez le connecteur avec :

  • URL : https://mcp.youraiconnector.com/mcp
  • Authentification : En-têtes personnalisés
  • Nom de l’en-tête : X-API-Key
  • Valeur de l’en-tête : votre clé API DM Champ

L’URL doit se terminer par /mcp. Coller uniquement https://mcp.youraiconnector.com est l’erreur la plus courante — ChatGPT vérifie cette adresse exacte, n’y trouve rien et affiche « Unable to add connector URL ».

Cursor et autres clients MCP

La plupart des éditeurs compatibles MCP utilisent la même structure .mcp.json que celle présentée ci-dessus (un serveur HTTP avec un url et un en-tête X-API-Key). Ajoutez un serveur dm-champ pointant vers https://mcp.youraiconnector.com/mcp et collez votre clé API dans l’en-tête.

L’API Claude (l’intégrer dans votre propre application)

Vous pouvez connecter le serveur MCP par programmation avec le connecteur MCP de l’API Claude, afin qu’un agent que vous créez puisse utiliser les outils DM Champ sans client distinct :

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}

Ce que vous pouvez faire

Dans la partie de l’API v1 exposée par le serveur MCP, l’assistant choisit automatiquement l’outil approprié :

  • Campagnes : lister, créer, mettre à jour, suspendre/reprendre, inspecter la configuration du bot.
  • Contacts : rechercher, créer, étiqueter, ajouter à des listes, importer.
  • Base de connaissances / FAQ : ajouter, modifier, importer en masse, approuver les suggestions de l’IA.
  • Messages : lire les conversations, envoyer un message à un contact.
  • Rendez-vous : lister, réserver, annuler.
  • Tâches : créer, terminer, lister.
  • Analytique : statistiques des messages, utilisation des crédits, coût de l’IA.
  • Canaux : vérifier l’état de la connexion, démarrer un flux de connexion.

Interroger les comptes de vos clients (agences)

Une seule connexion couvre tous les comptes que vous gérez. Vous n’avez pas besoin d’ajouter une seconde connexion par client : avec un forfait agence, l’assistant peut lire n’importe quel compte client sous votre gestion, vous pouvez donc poser des questions sur tous ces comptes au cours d’une même conversation.

Il suffit de nommer le client :

  • “Combien de contacts Bella’s Bistro possède-t-il ?”
  • “Combien l’IA a-t-elle coûté à chacun de mes clients cette semaine ?”
  • “Quelles campagnes sont actives pour Northside Dental, et quel est l’état de leurs canaux ?”

Cela couvre la lecture des contacts, messages, chats, campagnes, rendez-vous, tâches, tags, événements, FAQ, sources de la base de connaissances, numéros de téléphone, canaux, webhooks et analyses. Nous vérifions que le compte vous appartient réellement avant toute exécution — demander un compte qui n’est pas le vôtre renverra “non trouvé”. Si vous ne précisez pas de client, l’assistant lira votre propre compte, exactement comme auparavant.

La modification du compte d’un client est plus limitée. La configuration d’agents IA, de fonctions personnalisées, de modèles WhatsApp, de points d’entrée, de connexions de canaux, du statut de campagne et l’achat d’un numéro fonctionnent tous pour un client nommé ; la plupart des autres actions d’écriture s’exécutent toujours sur votre propre compte, effectuez donc celles-ci à partir de la propre clé de ce client ou depuis l’REST API, qui couvre davantage d’aspects.

C’est également la solution pour un client qui gère plusieurs entreprises sous une seule connexion. Donnez à chaque entreprise son propre compte, puis invitez l’e-mail du client en tant que membre de l’équipe sur chacun d’eux : il se connecte une fois et bascule entre ses marques grâce au sélecteur de compte dans la barre latérale.

Fournir les documents d’aide à votre assistant

Le serveur MCP donne à un assistant votre compte ; il ne lui donne pas cette documentation. Si vous souhaitez également qu’il réponde correctement aux questions du type « comment faire pour… », dirigez-le vers https://docs.youraiconnector.com/llms.txt (un index de chaque page d’aide avec un lien vers la version Markdown de chaque page) ou https://docs.youraiconnector.com/llms-full.txt (l’intégralité de la documentation dans un seul fichier Markdown). Les deux sont publics, ne nécessitent aucune clé et sont reconstruits à chaque modification de la documentation. Voir Lire ces documents au format Markdown.

Trouver ou générer votre clé API

La clé API utilisée par cette connexion se trouve dans Paramètres → Intégrations → Clé API — une section dédiée, distincte des Webhooks. Consultez Accès à l’API pour connaître les étapes exactes.

Dépannage

  • « Impossible d’ajouter l’URL du connecteur » (ChatGPT) / « connection refused » — l’adresse manque de /mcp à la fin. Utilisez https://mcp.youraiconnector.com/mcp, et non https://mcp.youraiconnector.com.
  • Needs authentication / 401 — votre clé API est manquante ou incorrecte. Ajoutez à nouveau le serveur avec une X-API-Key valide.
  • Un outil renvoie 403 — votre forfait ou votre rôle au sein de l’équipe ne permet pas cette action ; le serveur MCP n’impose rien de plus, il s’agit de la même vérification d’autorisation que pour l’API.
  • Outil introuvable — la liste des outils est générée en direct depuis l’API, elle correspond donc toujours à la version actuelle ; reconnectez-vous pour actualiser.
  • Un avertissement de sécurité ou de certificat sur votre propre domaine — pointer un enregistrement DNS vers nous ne suffit pas : le sous-domaine doit également être vérifié dans le tableau de bord avant de pouvoir établir une connexion sécurisée. Les agences en marque blanche peuvent placer l’adresse MCP sur leur propre domaine (par ex. mcp.youragency.com) depuis la carte Domaine personnalisé sous Paramètres → Marque blanche — ajoutez d’abord le CNAME chez votre registraire, puis saisissez le nom d’hôte dans le bloc Domaine MCP (assistants IA) et cliquez sur Vérifier, selon le même processus que pour vos autres sous-domaines personnalisés. Tant qu’il n’est pas vérifié, utilisez l’adresse standard ci-dessus — elle n’est pas marquée, vous pouvez donc la partager en toute sécurité avec vos clients.

Étapes suivantes

  • Accès à l’API — générer ou renouveler la clé utilisée par cette connexion.
  • Webhooks — l’équivalent basé sur le push de cette connexion MCP basée sur le pull.