MCP natif Insyder

Connectez votre assistant IA à vos espaces de travail Insyder. Le MCP natif propose les 51 opérations de l’API publique sous forme d’outils : consulter les prospects et les statistiques, modifier les coordonnées des prospects, gérer les produits, enregistrer des achats et créer des exports, dans les limites des autorisations que vous approuvez.

C’est le MCP à utiliser pour travailler avec vos données. Le MCP de documentation, distinct, recherche dans ces guides et explique l’API ; il ne peut ni accéder aux données de vos espaces de travail ni les modifier. Vous pouvez connecter les deux et les nommer Insyder Native et Insyder API Docs pour les distinguer.

Vous devez disposer d’un compte Insyder ayant accès à un espace de travail et être autorisé à ajouter des connecteurs personnalisés dans votre assistant. Le connecteur hébergé de Claude et ChatGPT dans un navigateur utilisent une connexion OAuth. Le formulaire Add MCP server de l’application de bureau ChatGPT utilise une clé API personnelle Insyder. Ces deux configurations ne nécessitent ni passerelle locale, ni installation de Node.js, ni tunnel.

Utilisez cette URL de serveur :

https://api.insyder.io/mcp

Avec OAuth, connectez-vous à votre compte Insyder existant lorsque cela vous est demandé, choisissez un espace de travail, puis sélectionnez Autoriser l’accès. L’accès en lecture seule est sélectionné par défaut. Activez les actions supplémentaires demandées uniquement si vous souhaitez que l’assistant effectue des modifications ou crée des exports. Votre assistant reçoit les données renvoyées par les outils que vous autorisez.

Utilisez le connecteur personnalisé hébergé de Claude. Vous pouvez l’ajouter depuis votre compte Claude et l’utiliser dans Claude Desktop.

1. Ouvrez Claude, puis Customize > Connectors > Add custom connector.
2. Nommez-le Insyder Native, saisissez https://api.insyder.io/mcp, puis sélectionnez Continue.
3. Conservez les paramètres détectés Sign in now et Use Claude’s published identity, puis sélectionnez Add. Sur la page du connecteur, sélectionnez Connect. Connectez-vous à Insyder, choisissez l’espace de travail et les autorisations, puis sélectionnez Autoriser l’accès. Aucun identifiant client ni secret n’est nécessaire.
4. Activez Insyder Native dans le menu + > Connectors de votre conversation. Demandez : « Utilise Insyder Native pour lister mes espaces de travail accessibles. »

Pour Team et Enterprise, un propriétaire ajoute d’abord l’URL dans Organization settings > Connectors > Add > Custom > Web. Chaque membre sélectionne ensuite Connect pour autoriser son propre accès Insyder. Consultez les instructions de Claude sur les connecteurs personnalisés.

Si vous utilisiez claude_desktop_config.json, désactivez cette entrée locale Insyder après avoir vérifié la nouvelle connexion, afin d’éviter les outils en double. La passerelle facultative avec clé API reste disponible pour les clients limités aux connexions locales.

Suivez ces étapes si votre page Plugins comporte les onglets Plugins / Apps / MCPs / Skills. Cette connexion utilise une clé API. Pour vous connecter avec votre compte Insyder, suivez plutôt la section ChatGPT dans un navigateur ci-dessous.

1. Créez une clé Insyder. Dans Insyder, ouvrez Préférences > Accès API > Créer une clé. Saisissez ChatGPT comme Nom de la clé, choisissez Lecture seule et sélectionnez l’espace de travail souhaité. Sélectionnez Enregistrer, puis Copier. La clé complète n’est affichée qu’une seule fois.

2. Ouvrez le formulaire MCP. Dans l’application de bureau ChatGPT, ouvrez Plugins. Cliquez sur Add en haut à droite, puis sur Add MCP server.

   

3. Renseignez la connexion. Dans Connect to a custom MCP, saisissez Insyder Native dans Name, puis sélectionnez Streamable HTTP à côté de Type. Le champ Command to launch est alors remplacé par URL. Remplissez le formulaire exactement comme suit :

   Champ	Valeur à saisir
   Name	Insyder Native
   Type	Streamable HTTP
   URL	https://api.insyder.io/mcp
   Bearer token env var	Laissez vide
   Headers — Key	X-API-Key
   Headers — Value	Collez la clé Insyder complète que vous avez copiée, commençant par insyder_live_
   Headers from environment variables	Laissez vide

   Collez la clé uniquement dans Headers > Value, sans ajouter Bearer devant. Ne la mettez pas dans les messages de conversation.

   

4. Enregistrez et redémarrez. Cliquez sur Save en bas à droite, puis sur Restart lorsque ChatGPT le propose. Dans Plugins > MCPs, gardez Insyder Native activé.

5. Testez la connexion. Démarrez une nouvelle conversation et envoyez :

   Utilise Insyder Native pour lister mes espaces de travail accessibles.

   ChatGPT doit renvoyer l’espace de travail sélectionné pour la clé. Vous pouvez ensuite lui demander de consulter les prospects, les produits ou les statistiques. Pour autoriser ultérieurement les modifications ou les exports, modifiez les autorisations de la clé dans Insyder > Préférences > Accès API.

Insyder prend actuellement en charge OAuth pour les connexions hébergées de ChatGPT ; la connexion de bureau ci-dessus utilise l’en-tête X-API-Key. Pour en savoir plus sur ce formulaire, consultez le guide MCP de bureau d’OpenAI.

Utilisez cette configuration distincte sur chatgpt.com pour vous connecter avec votre compte Insyder.

1. Ouvrez Settings > Security and login, puis activez Developer mode.
2. Ouvrez ChatGPT Plugins et sélectionnez + pour ajouter une connexion MCP.
3. Saisissez Name : Insyder Native, Description : Consulter et gérer les données de mon espace de travail Insyder, puis l’URL publique https://api.insyder.io/mcp sous Connection. Si des options d’authentification apparaissent, sélectionnez OAuth et laissez les champs facultatifs d’identifiant client et de secret vides.
4. Créez la connexion. Connectez-vous à Insyder, choisissez un espace de travail, vérifiez les autorisations, puis sélectionnez Autoriser l’accès.
5. Démarrez une nouvelle conversation, ajoutez Insyder Native depuis le menu des outils, puis demandez : « Utilise Insyder Native pour lister mes espaces de travail accessibles. »

Si Developer mode ou + n’apparaît pas, votre compte ou les règles de votre espace de travail peuvent restreindre les connexions personnalisées. Un administrateur peut devoir les activer. Consultez les instructions MCP d’OpenAI pour le navigateur.

Les clients acceptant des en-têtes HTTP personnalisés peuvent utiliser une clé API personnelle :

Créez une clé dans Insyder > Préférences > Accès API, sélectionnez ses espaces de travail et ses autorisations, puis enregistrez-la lorsqu’elle s’affiche. Utilisez le stockage privé des secrets du client pour l’en-tête. Ne collez jamais d’identifiants dans un message et ne les ajoutez pas à l’URL du serveur. Consultez l’authentification par clé API.

La connexion OAuth des clients prend actuellement en charge ChatGPT hébergé et Claude. Les autres clients doivent utiliser une clé API, sauf si leur intégration OAuth a été activée par Insyder. Utilisez une seule méthode d’authentification par requête.

L’URL native se termine par /mcp, et non par /v1/mcp ou /sse. L’authentification s’applique à la découverte et aux appels d’outils. Le serveur est sans état et prend en charge les anciens clients MCP ainsi que le protocole 2026-07-28 ; ouvrir l’URL dans un navigateur ne constitue pas un test de connexion.

Pour un client acceptant uniquement une configuration locale mcpServers, installez Node.js LTS et utilisez la passerelle mcp-remote. Cette configuration facultative s’exécute sur votre ordinateur. Les configurations Claude et ChatGPT ci-dessus ne l’utilisent pas.

{
  "mcpServers": {
    "insyder-native": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.13.5",
        "https://api.insyder.io/mcp",
        "--transport",
        "http-only",
        "--silent",
        "--header",
        "X-API-Key:${INSYDER_API_KEY}"
      ],
      "env": {
        "INSYDER_API_KEY": "YOUR_INSYDER_API_KEY"
      }
    }
  }
}

Remplacez YOUR_INSYDER_API_KEY par votre clé dans le fichier de configuration privé ; conservez ${INSYDER_API_KEY} tel quel. Redémarrez complètement le client. Utilisez le chemin absolu de npx s’il n’est pas dans le PATH du client. Fermer la passerelle locale coupe cette connexion.

Après avoir listé vos espaces de travail, essayez ces demandes :

• « Pour l’espace de travail @mybrand, montre 20 prospects non contactés ayant un score d’au moins 80. »
• « Résume le chiffre d’affaires et l’entonnoir de conversion des prospects de @mybrand ce mois-ci. »
• « Montre les produits de @mybrand, y compris les produits archivés. »
• « Remplace les notes de ce prospect par “A demandé à être rappelé demain”. »
• « Prépare un export des prospects de @mybrand et récupère le lien de téléchargement lorsqu’il est prêt. »

Les deux dernières demandes nécessitent les autorisations d’écriture ou d’export correspondantes. L’assistant doit utiliser l’account_id renvoyé par listAccounts ; le nom d’utilisateur d’un espace de travail n’est pas son identifiant API.

Le catalogue répertorie tous les outils, y compris ceux que votre connexion ne peut pas exécuter. L’API vérifie les autorisations à chaque appel. La déconnexion OAuth, la révocation de clé, l’expiration, l’accès aux espaces de travail et les changements d’appartenance sont vérifiés à chaque requête. MCP utilise les mêmes limites que l’API, notamment le quota partagé par utilisateur ; il n’accorde aucun accès supplémentaire.

Les données importées et celles calculées par le système restent en lecture seule. Aucun des deux MCP n’ajoute d’identifiants de fournisseurs, de gestion des connexions, de commandes de synchronisation, de déclenchement d’analyses ou d’autres opérations absentes de l’API publique.

Chaque nom d’outil correspond à un operationId de la référence API, avec les mêmes paramètres et réponses.

La plupart des assistants construisent les arguments des outils pour vous. Pour les intégrations personnalisées, les paramètres de chemin et de requête de l’API deviennent des arguments de premier niveau, les données JSON sont placées dans body et Idempotency-Key devient idempotency_key. Les filtres sous forme de tableau restent des tableaux JSON.

Exemple d’arguments pour listLeads :

{
  "account_id": "WORKSPACE_ID",
  "status": ["uncontacted"],
  "min_score": 80,
  "limit": 20
}

Exemple d’arguments pour updateLead :

{
  "account_id": "WORKSPACE_ID",
  "lead_id": "LEAD_ID",
  "body": { "notes": "Requested a callback tomorrow" }
}

Les outils renvoient à la fois du texte JSON et un contenu structuré contenant le statut de l’API, les en-têtes opérationnels et le corps de réponse inchangé :

{
  "status": 200,
  "headers": { "x-request-id": "REQUEST_ID" },
  "body": {
    "data": [],
    "meta": { "request_id": "REQUEST_ID", "has_more": false, "next_cursor": null }
  }
}

• Pagination : transmettez body.meta.next_cursor comme cursor en conservant les mêmes filtres. Les collections contiennent 50 éléments par défaut, avec un maximum de 200 ; les assistants peuvent traiter plus facilement des pages plus petites.
• Écritures : createProduct, createPurchase et createExport nécessitent idempotency_key. Si le résultat d’un appel est incertain, réessayez avec la même clé et un corps identique. L’API conserve les enregistrements d’idempotence pendant 24 heures.
• Exports : appelez createExport, puis interrogez getExport jusqu’à ce que l’export soit prêt. Utilisez les liens de téléchargement temporaires avant leur expiration. deleteExport annule ou supprime un export.
• Erreurs : les erreurs API définissent isError: true et conservent la réponse d’erreur de l’API. Les arguments invalides sont rejetés avant l’envoi. Une suppression réussie peut renvoyer le statut 204 avec body: null.

Dans Insyder > Préférences > Accès API > Assistants connectés, sélectionnez Déconnecter à côté de la connexion. Cela bloque immédiatement son accès à Insyder. Vous pouvez également supprimer le connecteur dans Claude ou ChatGPT. Les autres connexions et votre session Insyder restent actives.

Pour changer d’espace de travail ou d’autorisations, déconnectez-vous puis reconnectez-vous. Si vous utilisez une clé API, révoquez-la ou modifiez-la dans Accès API, et mettez à jour la configuration privée du client après son renouvellement.