Connecter des assistants IA (MCP)

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

Il s’agit de la même API v1 à laquelle vous accédez avec une clé 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, fonctions personnalisées, base de connaissances, rendez-vous, analyses, tags, listes, diffusions, transactions, connexions de canaux et sous-comptes. Les automatisations peuvent être listées et lues, mais pas encore créées ou modifiées via MCP ; créez-les dans l’application. Dans ce qu’il expose, il n’y a pas d’autorisations par outil ni de valeur par défaut en lecture seule, la clé API constitue donc l’intégralité du contrôle d’accès.

Point de terminaison : https://mcp.youraiconnector.com/mcp
Authentification : votre clé API Your AI Connector (envoyée via l’en-tête X-API-Key)
Requis : un forfait avec accès 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 ai-connector https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Exécutez ensuite /mcp dans Claude Code pour confirmer qu’il affiche ai-connector ✓ connected.

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": {
    "ai-connector": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Ajoutez le serveur en tant que connecteur personnalisé. Il est configuré dans votre compte Claude, il fonctionne donc aussi bien dans Claude Desktop que sur claude.ai (les comptes Claude gratuits peuvent ajouter un connecteur personnalisé).

Ouvrez Personnaliser → Connecteurs, cliquez sur + Ajouter, puis sur Ajouter un connecteur personnalisé.
Donnez-lui un nom et saisissez https://mcp.youraiconnector.com/mcp comme URL.
Sous Authentification, choisissez Aucune connexion. Le serveur MCP n’a pas de page de connexion : choisir une option de connexion aboutit à “Impossible de s’enregistrer auprès du service de connexion …”.
Sous En-têtes de requête, ajoutez un en-tête nommé X-API-Key avec votre clé API comme valeur.
Cliquez sur Ajouter. Les outils Your AI Connector apparaissent dans le menu des outils d’une nouvelle discussion.

Pas de champ En-têtes de requête ? Votre version de Claude Desktop est ancienne : mettez-la à jour ou utilisez plutôt le fichier de configuration. Le fichier de configuration (claude_desktop_config.json, Paramètres → Développeur → Modifier la configuration) exécute uniquement des programmes sur votre ordinateur et ignore une entrée url, il nécessite donc le petit pont mcp-remote, qui requiert Node.js 18 ou une version ultérieure :

{
  "mcpServers": {
    "ai-connector": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.youraiconnector.com/mcp",
        "--header",
        "X-API-Key:${AI_CONNECTOR_KEY}"
      ],
      "env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" }
    }
  }
}

Gardez X-API-Key:${AI_CONNECTOR_KEY} exactement tel quel, sans espace après le deux-points (sur Windows, un espace sépare l’en-tête), et mettez votre clé uniquement dans env. Ensuite, quittez complètement Claude Desktop (sur Windows, faites un clic droit sur l’icône de la barre d’état système → Quitter) et rouvrez-le.

ChatGPT

ChatGPT ne peut pas se connecter au serveur MCP pour le moment. Son formulaire de connecteur personnalisé ne propose que OAuth ou Aucune authentification, et le serveur MCP Your AI Connector se connecte avec votre clé API, envoyée dans l’en-tête de la requête. Choisir OAuth échoue avec le message « could not discover OAuth settings », et Aucune authentification est refusée car chaque requête nécessite la clé.

Utilisez un assistant qui vous permet de définir un en-tête de requête à la place : Claude Code, Claude Desktop, Cursor ou un autre client MCP, ou l’API Claude.

ChatGPT peut toujours lire la documentation d’aide sans connexion : consultez La documentation d’aide est intégrée pour les fichiers llms.txt publics.

Cursor et autres clients MCP

La plupart des éditeurs compatibles MCP utilisent la même structure .mcp.json présentée ci-dessus (un serveur HTTP avec un url et un en-tête X-API-Key). Ajoutez un serveur ai-connector 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 Your AI Connector sans client distinct :

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my AI agents" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "ai-connector",
      "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é :

Agents IA : lister, créer, mettre à jour, suspendre/reprendre, inspecter la configuration.
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 ? »
« Quel est l’état des canaux de Northside Dental, et combien de discussions ont eu lieu cette semaine ? »

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.

Modifier le compte d’un client fonctionne de la même manière. Chaque action qui accepte un compte client dans l’API est disponible pour un client nommé : configuration d’agents IA, base de connaissances, fonctions personnalisées, modèles WhatsApp, points d’entrée, connexions de canaux, contacts, tags, diffusions, rendez-vous, transactions et tâches, ainsi que l’envoi de messages. Les exceptions sont les actions au niveau de l’agence, qui s’exécutent toujours sur votre propre compte d’agence : gestion des comptes clients eux-mêmes (limites, fonctionnalités, tarification, mise en pause), instantanés, votre équipe et vos clés API. L’ajout ou la suppression de contacts de la liste d’un client n’est pas encore disponible pour un client nommé ; effectuez cette opération à partir de la propre clé de ce client ou dans son compte. Le guide de l’API d’agence répertorie ce qui est pris en charge.

Les outils d’agence ne sont disponibles qu’à l’adresse standard sans marque, https://mcp.youraiconnector.com/mcp. Une adresse MCP en marque blanche sur votre propre domaine (mcp.youragency.com) est conçue pour vos clients et les exclut ; connectez-vous donc avec l’adresse standard sans marque lorsque vous gérez des comptes clients.

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.

Tester l’agent d’un client

Demandez à l’assistant d’essayer l’agent d’un client (« envoie ‘livrez-vous le dimanche ?’ à l’agent Boulangerie du client X et montre-moi ce qu’il a fait »). Il envoie un message d’essai avec votre clé d’agence et le sub_account_id du client, attend, puis lit la réponse ainsi que toutes les actions effectuées par l’agent. Aucune copie de l’agent n’est nécessaire. Si l’assistant indique que vous n’avez pas de compte d’agence, c’est qu’il est connecté avec la clé d’un client : reconnectez-le avec la clé de votre compte d’agence. Voir Essayer.

Clients avec une limite d’outils

Certains clients IA n’acceptent qu’un serveur avec un nombre limité d’outils. Composio, par exemple, refuse un serveur qui liste plus de 500 outils et n’en importe aucun. La connexion complète à l’agence en liste plus que cela, ajoutez donc ?tags= à l’adresse avec uniquement les groupes d’outils dont vous avez besoin.

Pour une agence qui souhaite lister ses comptes clients, lire leurs contacts, chats et messages, et envoyer des messages :

https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages

Cela charge environ 80 outils. Nommez le client dans votre requête et l’assistant agira sur le compte de ce client, comme décrit ci-dessus.

Séparez les groupes par des virgules ; les majuscules et minuscules fonctionnent toutes deux.
Pour ajouter des outils individuels, listez leurs noms exacts avec tools=, par exemple ?tags=Contacts&tools=list_or_get_subaccounts. Vous obtenez tous les outils de l’une ou l’autre liste.
Les outils de documentation d’aide sont toujours inclus.
La clé API va toujours dans l’en-tête X-API-Key (ou Authorization: Bearer YOUR_API_KEY), jamais dans l’adresse.

L’aide est intégrée

Le serveur MCP fournit à l’assistant votre compte et cette documentation. Trois outils lisent l’aide en direct, afin que l’assistant puisse rechercher le fonctionnement d’une fonctionnalité ou les changements récents, au lieu de deviner :

docs_search : trouve les sections qui répondent à une question et les renvoie avec le lien vers la page.
docs_read : lit une page en entier, ou une section de celle-ci.
docs_list : liste toutes les pages par zone.

Il n’y a rien à configurer, et les outils de documentation ne touchent jamais aux données de votre compte. Demandez « comment fonctionnent les points d’entrée ? » ou « quoi de neuf dans les automatisations ? » et l’assistant recherche d’abord dans la documentation. Comme les outils lisent le site d’aide lui-même, une fonctionnalité est connue de votre assistant dès que son guide est publié.

Un assistant qui n’est pas connecté via MCP peut toujours lire la documentation : pointez-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 (toute la documentation dans un seul fichier Markdown). Les deux sont publics, ne nécessitent aucune clé et sont reconstruits à chaque modification de la documentation.

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

“Connexion refusée” ou “introuvable” — l’adresse manque du /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 un X-API-Key valide.
“Impossible de découvrir les paramètres OAuth” (ChatGPT) — ChatGPT ne prend en charge que l’OAuth ou l’absence d’authentification pour les connecteurs personnalisés, et le serveur MCP utilise une clé API, donc ChatGPT ne peut pas se connecter pour le moment. Voir ChatGPT.
“Impossible de s’enregistrer auprès du service de connexion …” ou “ajouter un ID client OAuth” (Claude Desktop) — le connecteur personnalisé a été ajouté avec une option de connexion. Il n’y a pas d’ID client OAuth à saisir : supprimez le connecteur et ajoutez-le à nouveau avec Authentification → Aucune connexion et votre clé API comme en-tête de requête X-API-Key, comme dans Claude Desktop.
Claude Desktop n’affiche aucun outil après la modification du fichier de configuration — le fichier de configuration ignore une entrée "url" ; utilisez le connecteur personnalisé ou le formulaire mcp-remote dans Claude Desktop, puis quittez complètement et rouvrez l’application.
Un outil renvoie 403 — votre forfait ou votre rôle d’équipe ne permet pas cette action ; le serveur MCP n’applique rien de supplémentaire, 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 à partir de 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 en soi : le sous-domaine doit également être vérifié dans le tableau de bord avant de pouvoir servir 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 de marque. L’adresse de marque omet les outils d’agence ; continuez à utiliser l’adresse standard sans marque pour ceux-ci. Tant que votre adresse de marque n’est pas vérifiée, utilisez l’adresse standard sans marque : elle peut être partagée en toute sécurité avec les 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.

Connecter des assistants IA (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursor et autres clients MCP #

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

Ce que vous pouvez faire #

Interroger les comptes de vos clients (agences) #

Tester l’agent d’un client #

Clients avec une limite d’outils #

L’aide est intégrée #

Trouver ou générer votre clé API #

Dépannage #

Étapes suivantes #