Connecter un agent IA

Donnez une phrase à n'importe quel agent IA, et il peut travailler dans mindzieStudio pour vous. Claude Cowork, Claude Code, Codex, Cursor ou tout autre : il configure les projets et les utilisateurs, charge les données, et travaille dans AI Process Intelligence et BPM Studio, simplement en lui disant ce que vous voulez en langage naturel.

Cette phrase est tout ce que vous lui donnez. La page vers laquelle elle pointe est écrite pour l'agent : l'agent demande à quel mindzieStudio vous vous connectez et ce que vous voulez faire, il détermine comment se connecter, et vous indique où créer votre clé. La clé ne figure jamais dans la conversation : vous la mettez dans les paramètres de connecteur de votre agent, ou dans une page que l'agent ouvre dans votre navigateur.

Ce que votre agent peut faire, et ce dont il a besoin

Vous voulez que l'agent...	Quels agents	Clé
Travaille dans mindzieStudio : crée des projets, ajoute des utilisateurs et décide qui voit quel projet, charge des données	Tout agent, y compris Claude Cowork et claude.ai	Clé locataire
Travaille dans AI Process Intelligence et BPM Studio : crée, démarre et arrête des projets, charge des données, travaille à l'intérieur d'un projet, crée des rapports IA, des plannings et alertes, édite des diagrammes	Tout cela, dans n'importe quel agent : Claude Cowork et claude.ai via le serveur MCP hébergé, et les agents pouvant exécuter des commandes, comme Claude Code et Codex, via l’outil mz ou le serveur hébergé	Clé locataire
Crée des locataires pour d'autres entreprises	Tout agent	Clé globale : uniquement pour les administrateurs serveur et partenaires

Derrière la phrase, il y a deux façons d'entrer, et l'agent choisit la bonne : le serveur MCP hébergé que chaque serveur mindzieStudio exécute (rien à installer), et l’outil mz que l’agent capable d’exécuter des commandes installe pour lui-même. Vous n'avez pas à choisir. Pour les détails sur mz, voir Connecter votre propre agent.

Votre clé

Une clé locataire suffit pour tout ce qui précède. Dans mindzieStudio, ouvrez le menu sous votre nom, puis Administration > Paramètres > Clés API et cliquez sur Créer une nouvelle clé secrète. Vous devez avoir le rôle d’Administrateur dans le locataire. La clé est affichée une seule fois, copiez-la immédiatement.

Une clé API globale ouvre tous les locataires sur le serveur et peut en créer de nouveaux. Seul un administrateur serveur peut en créer une (menu sous votre nom, Paramètres serveur > Clés API globales), et seuls les partenaires qui configurent des locataires pour leurs clients en ont besoin. Voir Mettre en place un client en une étape.

Configuration manuelle du serveur MCP hébergé

L'agent vous guide lui-même à travers cette étape. Cette section est pour ceux qui veulent le faire sans l’aide de l’agent.

L’URL

Serveur	URL MCP
mindzieStudio (États-Unis)	https://www.mindziestudio.com/mcp
mindzieStudio Europe	https://europe.mindziestudio.com/mcp
Votre propre serveur	https://<votre serveur>/mcp

Il y a deux façons de transmettre la clé :

Votre agent peut...	Entrée
Envoyer un en-tête avec une URL (Claude Cowork, Claude Code, Cursor, VS Code, APIs d’agent)	URL https://www.mindziestudio.com/mcp et en-tête Authorization: Bearer <votre clé API>
Prendre seulement une URL	https://www.mindziestudio.com/mcp/k/<votre clé API>

Traitez la deuxième forme comme un mot de passe. La clé fait partie de l'URL, donc toute personne qui voit l'URL peut utiliser la clé. Ne la collez pas dans des documents ou discussions partagés. Si elle fuit, supprimez la clé dans mindzieStudio et créez-en une nouvelle.

L’ajouter à votre agent

Claude Cowork / application desktop Claude

1. Ouvrez Paramètres > Connecteurs (sur claude.ai : Personnaliser > Connecteurs), choisissez Ajouter, puis Ajouter un connecteur personnalisé. Les connecteurs appartiennent à votre compte Claude, donc Cowork, l’appli desktop et claude.ai le reçoivent tous.
2. Nommez-le mindzie, et pour l’URL collez https://www.mindziestudio.com/mcp.
3. Sous Authentification, choisissez Pas de connexion. Claude suggère d’abord « Se connecter maintenant » ; mindzieStudio utilise une clé API à la place, et l’en-tête d'autorisation ne peut être ajouté qu'après avoir choisi Pas de connexion.
4. Sous En-têtes de requête, ajoutez l’en-tête authorization avec la valeur Bearer <votre clé API> (le mot Bearer, un espace, puis la clé).
5. Enregistrez. Claude liste les outils mindzie. Démarrez une nouvelle conversation et demandez : « Avec mindzie, sous quel compte suis-je connecté ? » Claude demandera la permission avant chaque appel d’outil.

Si votre version de Claude ne montre pas d’option d’en-tête, utilisez l’URL https://www.mindziestudio.com/mcp/k/<votre clé API> à la place.

Claude Code

claude mcp add --transport http mindzie https://www.mindziestudio.com/mcp --header "Authorization: Bearer <your API key>"

Cursor / VS Code

Ajoutez à votre configuration MCP (.cursor/mcp.json ou .vscode/mcp.json) :

{
  "mcpServers": {
    "mindzie": {
      "url": "https://www.mindziestudio.com/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

Grok, OpenAI et autres APIs d’agents

Les APIs d’agents qui supportent les serveurs MCP distants prennent une URL de serveur et une valeur d’autorisation. Utilisez https://www.mindziestudio.com/mcp comme URL et Bearer <votre clé API> comme autorisation. Si l’API prend seulement une URL, utilisez la forme /mcp/k/<votre clé API>.

Vérifier la connexion

Demandez à votre agent d’exécuter mindzie_whoami. Il répond avec le serveur atteint et si la clé est globale (canManageTenants: true) ou limitée à un seul locataire (keyTenantId : le locataire qu’il ouvre).

Mettre en place un client en une étape

Cela nécessite une clé API globale, et est destiné aux partenaires qui créent des locataires pour leurs clients. Avec une clé locataire, votre agent travaille uniquement dans votre propre locataire.

L’outil mindzie_provision_tenant configure un client complètement en un appel :

• crée le locataire,
• active ou désactive ses modules (Process Mining, Data Designer, BPM Studio, AI Process Intelligence),
• donne un accès à l’utilisateur admin (un compte existant est réutilisé ; un nouveau est créé),
• crée les projets, avec l’admin comme propriétaire, donc l’admin les voit immédiatement.

Exemple de prompt :

En utilisant mindzie, crée un locataire nommé acme-corp avec le nom affiché "Acme Corporation", 5 utilisateurs et 2 analystes. Active Process Mining et Data Designer, et désactive BPM Studio et AI Process Intelligence. L’admin est jane@acme.com (Jane Smith). Crée les projets "Purchase to Pay" et "Order to Cash".

Aucun email n’est envoyé. Un nouveau compte admin est créé sans mot de passe ; l’admin se connecte en choisissant Mot de passe oublié sur la page de connexion, ou vous leur communiquez leur premier mot de passe si vous en attribuez un.

Plusieurs clients en même temps

Fournissez à l’agent la liste (par exemple une feuille de calcul avec noms des entreprises, emails des admin et modules) et demandez-lui de configurer chacun et de rendre compte du résultat par client. Si une exécution s’arrête en cours de route, demandez-lui de relancer avec resumeExisting pour les clients déjà existants : les étapes déjà faites sont marquées existant et rien n’est dupliqué.

Chargement des données

Utilisez mindzie_upload_dataset_from_url avec un lien https vers un fichier CSV jusqu’à 1 Go, comme un lien de stockage cloud avec un jeton de lecture. Le serveur mindzieStudio télécharge le fichier lui-même, donc les fichiers volumineux ne passent jamais par la conversation. Le lien doit être accessible publiquement ; les liens vers des adresses privées ou du réseau interne sont refusés.

Pour quelques milliers de lignes vous pouvez aussi coller le texte CSV avec mindzie_upload_dataset_csv_text.

Outils disponibles

Outil	Ce qu’il fait	Clé nécessaire
mindzie_whoami	Informations serveur et clé	N’importe laquelle
mindzie_provision_tenant	Locataire, modules, admin et projets en un seul appel	Globale
mindzie_list_projects, mindzie_get_project, mindzie_create_project, mindzie_update_project, mindzie_delete_project	Projets mindzieStudio	Globale ou locataire
mindzie_list_project_members, mindzie_add_project_member	Qui peut voir un projet	Globale ou locataire
mindzie_list_datasets, mindzie_upload_dataset_csv_text, mindzie_upload_dataset_from_url	Jeux de données	Globale ou locataire

À côté de ceux-ci, le serveur offre les mêmes outils que la ligne de commande mz, générés à partir des mêmes spécifications, donc les deux ne peuvent jamais diverger. Chacun est un groupe de commandes, appelé avec un method et ses params ; la méthode describe liste les paramètres d’une méthode.

Outil	Ce qu’il fait	Clé nécessaire
projects, projects_backups, projects_keys, projects_reports	Projets AI Process Intelligence : créer, démarrer, arrêter, renommer, redimensionner, supprimer, importer depuis un fichier ; sauvegardes et restauration ; relancer un rapport publié	Locataire
cube_log, cube_files, cube_data, cube_eventlogs, cube_schema, cube_build, cube_filters, cube_enrichments, cube_rules, cube_calendar, cube_costs, cube_jobs, cube_reports, cube_schedules, cube_alerts, cube_styles et les autres	Tout dans le cube d’un projet : charger les données, interroger le journal d’événements, filtres, enrichissements, règles, schéma, jobs de rapports IA, rapports publiés, plannings et alertes. Chaque méthode prend pi_project_id ; le projet doit être en cours d’exécution	Locataire
bpmn_diagrams, bpmn_comments, bpmn_approvals, bpmn_audit, bpmn_ai, bpmn_ai_files	BPM Studio : modèles, révisions, commentaires, validations, journal d’audit, enquêtes IA à partir d’image ou SOP	Locataire, ou global avec tenant_id
studio_projects, studio_projects_members	Les projets sur lesquels BPM Studio travaille et leurs membres	Locataire, ou global avec tenant_id
tenants, tenants_settings, users, users_tenant	Locataires, leurs paramètres et modules, utilisateurs	Global

Les suppressions nécessitent le nom exact de ce qui est supprimé. Le travail IA — un rapport IA, relancer un rapport, une enquête IA BPM Studio — utilise les crédits IA du locataire.

Chaque outil suit strictement les mêmes règles que l’API REST : mêmes permissions, validation et messages d’erreur.

Bon à savoir

• Un locataire vide possède les modules par défaut du serveur, qui peuvent ne pas correspondre aux attentes d’un client. Utilisez mindzie_provision_tenant, ou définissez explicitement les modules avec la méthode update de tenants_settings.
• Un projet est visible uniquement par ses membres. Un projet créé avec mindzie_create_project n’a pas de membres tant que vous ne les avez pas ajoutés avec mindzie_add_project_member. mindzie_provision_tenant gère cela pour vous.
• La suppression est définitive. Un bon agent confirme d’abord avec vous ; les outils de suppression exigent les noms exacts.
• Chaque appel d’outil est journalisé sur le serveur avec le nom de la clé API utilisée.

Résolution des problèmes

Ce que vous voyez	Pourquoi	Que faire
HTTP 401 / "non autorisé" lors de la connexion	La clé est incorrecte, supprimée, ou pour un autre serveur (chaque région a ses propres clés)	Créez une clé sur le serveur auquel vous vous connectez
"nécessite une clé API globale"	Une clé locataire a été utilisée pour un outil qui fonctionne à travers les locataires (listage, création, modification ou suppression des locataires, paramètres ou modules)	Ces outils sont pour les administrateurs serveur et partenaires qui configurent des locataires. Travaillez dans votre propre locataire avec les outils de projet, utilisateur et jeu de données. Si vous créez des locataires pour d’autres entreprises, voir Mettre en place un client en une étape
"piloté avec une clé API LOCATAIRE, jamais une clé globale"	Une clé globale a été utilisée sur un outil Process Intelligence ou cube_	Créez une clé locataire dans le locataire du projet, et connectez-vous avec celle-ci
"n’a pas accès au locataire"	L’ID de locataire ne correspond pas à celui de la clé	Utilisez keyTenantId depuis mindzie_whoami
L’admin se connecte et ne voit aucun projet	Il n’est pas membre des projets	mindzie_add_project_member, ou provisionnez avec mindzie_provision_tenant
"existe déjà" lors du provisionnement	Le nom du locataire est déjà pris	S’il s’agit du même client, relancez avec resumeExisting ; sinon choisissez un nom différent
"adresse non publique" lors du chargement des données	Le lien pointe vers un réseau privé ou interne	Utilisez un lien https accessible publiquement