Serveur MCP

Intégration du Protocole de Contexte Modèle

Le serveur mindzieAPI MCP permet aux assistants de codage IA d’interagir de manière programmatique avec mindzieStudio. MCP (Model Context Protocol) fournit une méthode standardisée pour que les outils IA accèdent à des capacités externes.

Outils Disponibles

Le serveur MCP expose les outils suivants pour les assistants IA :

mindzie_list_block_types

Récupère des informations sur les types de blocs disponibles (filtres, calculateurs, enrichissements).

Paramètres

Paramètre	Type	Obligatoire	Description
`category`	Chaîne	Non	Filtrer par catégorie : "filters", "calculators", "unified", ou omettre pour les filtres uniquement

Options de Catégorie

Valeur	Retourne
`"filters"`	Types de blocs filtre uniquement (par défaut)
`"calculators"`	Types de blocs calculateur uniquement
`"unified"`	Tous les types de blocs y compris enrichissements, regroupés par catégorie

Exemple : Obtenir Tous les Types de Blocs (Recommandé)

mindzie_list_block_types category="unified"

Retourne les métadonnées complètes pour tous les types de blocs :

{
  "BlockTypes": [
    {
      "OperatorName": "CaseAttributeFilter",
      "DisplayName": "Filtre Attribut Cas",
      "Description": "Filtrer les cas selon les valeurs des attributs",
      "Category": "Filtres Attributs",
      "BlockType": "Filter",
      "DocumentationUrl": "/mindzie_studio/filters/case-attribute-filter",
      "UsageFrequency": "High",
      "CommonUseCases": ["Filtrer par segment client", "Se concentrer sur des régions spécifiques"]
    },
    {
      "OperatorName": "CaseDurationCalculator",
      "DisplayName": "Calculateur Durée Cas",
      "Description": "Calculer la durée totale des cas",
      "Category": "Calculateurs Temps",
      "BlockType": "Calculator",
      "DocumentationUrl": "/mindzie_studio/calculators/case-duration-calculator",
      "UsageFrequency": "High",
      "CommonUseCases": ["Analyser les temps de cycle", "Identifier les cas lents"]
    },
    {
      "OperatorName": "CaseStageCalculator",
      "DisplayName": "Calculateur Étape Cas",
      "Description": "Attribuer des étiquettes d’étape aux cas selon les motifs d’activité",
      "Category": "Analyse Étapes",
      "BlockType": "Enrichment",
      "DocumentationUrl": "/mindzie_studio/enrichments/case-stage-calculator",
      "UsageFrequency": "Medium",
      "CommonUseCases": ["Suivre la progression des cas", "Surveiller les transitions d’étape"]
    }
  ],
  "Categories": ["Filtres Attributs", "Filtres Temps", "Calculateurs Temps", "Analyse Étapes"],
  "TotalCount": 45,
  "ByBlockCategory": {
    "Filter": [...],
    "Calculator": [...],
    "Enrichment": [...]
  }
}

Exemple : Obtenir Seulement les Filtres

mindzie_list_block_types category="filters"

Exemple : Obtenir Seulement les Calculateurs

mindzie_list_block_types category="calculators"

mindzie_list_projects

Lister les projets disponibles dans le locataire courant.

Paramètres

Paramètre	Type	Obligatoire	Description
`tenant_id`	Chaîne	Oui	Identifiant du locataire

mindzie_get_project

Obtenir les détails d’un projet spécifique.

Paramètres

Paramètre	Type	Obligatoire	Description
`tenant_id`	Chaîne	Oui	Identifiant du locataire
`project_id`	Chaîne	Oui	Identifiant du projet

mindzie_execute_block

Exécuter un bloc et retourner les résultats.

Paramètres

Paramètre	Type	Obligatoire	Description
`tenant_id`	Chaîne	Oui	Identifiant du locataire
`project_id`	Chaîne	Oui	Identifiant du projet
`block_id`	Chaîne	Oui	Bloc à exécuter

mindzie_generate_url

Générer des URL vers les pages et entités mindzieStudio pour navigation ou partage.

Paramètres

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	Oui	Type d’URL (voir Types d’URL ci-dessous)
`entity_id`	Chaîne	Conditionnel	ID de l’entité pour pages spécifiques à une entité
`parent_id`	Chaîne	Conditionnel	ID parent (projectId ou notebookId)

Types d’URL

Pages Listes (pas besoin de entity_id) :

Type	parent_id	Description
`projects`	-	Liste des projets
`apps`	-	Liste des applications
`investigations`	projectId	Investigations pour un projet
`dashboards-list`	projectId	Liste des tableaux de bord pour un projet
`datasets`	projectId	Jeux de données pour un projet
`actions`	projectId	Actions pour un projet
`bpmn`	projectId	Éditeur BPMN pour un projet

Pages Entités (entity_id requis) :

Type	entity_id	parent_id	Description
`dashboard`	dashboardId	-	Tableau de bord unique
`analysis`	notebookId	-	Page cahier d’analyse
`block`	blockId	notebookId	Bloc spécifique
`enrichment`	enrichmentId	projectId (optionnel)	Cahier d’enrichissement

Exemple : Obtenir l’URL d’un Tableau de Bord

mindzie_generate_url type="dashboard" entity_id="{dashboardId}"

Retourne :

{
  "url": "https://host/navigate?type=dashboard&id=...",
  "entityType": "dashboard",
  "entityId": "...",
  "tenantId": "..."
}

Exemple : Obtenir l’URL d’un Bloc

mindzie_generate_url type="block" entity_id="{blockId}" parent_id="{notebookId}"

Exemple : Obtenir l’URL de la Liste des Investigations

mindzie_generate_url type="investigations" parent_id="{projectId}"

Prérequis

Avant de configurer le serveur MCP, assurez-vous d’avoir :

Node.js 18 ou supérieur – Téléchargez depuis nodejs.org
Un token API mindzie – Généré depuis les paramètres de votre compte mindzieStudio
L’URL de votre instance mindzieStudio – Soit https://www.mindziestudio.com (cloud) ou votre URL on-premise

Installation

Le serveur mindzie MCP s’installe automatiquement via npx – aucune installation manuelle requise :

npx -y @mindzie/mcp-server

Variables d’Environnement

Variable	Obligatoire	Description
`MINDZIE_API_URL`	Oui	URL de votre instance mindzieStudio
`MINDZIE_API_TOKEN`	Oui	Votre token d’authentification API

Configuration par Application

Claude Desktop

Claude Desktop est l’application de bureau d’Anthropic pour Claude AI.

Configuration Windows

Éditez le fichier de configuration à l’adresse :

%APPDATA%\Claude\claude_desktop_config.json

Ajoutez le serveur mindzie MCP :

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "votre-token-api-ici"
      }
    }
  }
}

Configuration macOS

Éditez le fichier de configuration à :

~/Library/Application Support/Claude/claude_desktop_config.json

Ajoutez la même configuration que pour Windows ci-dessus.

Après Configuration

Sauvegardez le fichier de configuration
Redémarrez complètement Claude Desktop (quitter et relancer)
Cherchez l’icône de marteau dans l’interface de chat – cela indique que les outils MCP sont disponibles

Claude Code (CLI)

Claude Code est l’interface en ligne de commande d’Anthropic pour Claude AI.

Ajouter le Serveur MCP

Exécutez cette commande pour enregistrer le serveur mindzie MCP :

claude mcp add mindzie -- npx -y @mindzie/mcp-server

Définir les Variables d’Environnement

Windows (PowerShell) :

$env:MINDZIE_API_URL = "https://www.mindziestudio.com"
$env:MINDZIE_API_TOKEN = "votre-token-api-ici"

Windows (Invite de commandes) :

set MINDZIE_API_URL=https://www.mindziestudio.com
set MINDZIE_API_TOKEN=votre-token-api-ici

macOS/Linux :

export MINDZIE_API_URL="https://www.mindziestudio.com"
export MINDZIE_API_TOKEN="votre-token-api-ici"

Configuration Persistante

Ajoutez les variables d’environnement dans le profil de votre shell (.bashrc, .zshrc ou profil PowerShell) pour qu’elles persistent.

Cursor IDE

Cursor est un éditeur de code IA basé sur VS Code.

Emplacement du Fichier de Configuration

Créez ou éditez .cursor/mcp.json dans votre dossier personnel ou racine du projet :

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "votre-token-api-ici"
      }
    }
  }
}

Alternative : Interface de Paramètres

Ouvrez Cursor
Allez à Paramètres (Ctrl/Cmd + ,)
Recherchez “MCP”
Cliquez sur Modifier dans settings.json
Ajoutez la configuration du serveur mindzie

Vérifier la Configuration

Après configuration, redémarrez Cursor et vérifiez que les outils mindzie apparaissent dans les outils disponibles de l’assistant IA.

Windsurf (Codeium)

Windsurf est l’IDE propulsé par IA de Codeium.

Emplacement du Fichier de Configuration

Créez ou éditez le fichier de configuration MCP :

Windows :

%USERPROFILE%\.codeium\windsurf\mcp_config.json

macOS/Linux :

~/.codeium/windsurf/mcp_config.json

Configuration

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "votre-token-api-ici"
      }
    }
  }
}

Vérifier la Configuration

Redémarrez Windsurf
Ouvrez le panneau Cascade
Les outils mindzie devraient être disponibles pour les requêtes de data mining processus

VS Code avec l’Extension Continue

Continue est un assistant de codage IA open source pour VS Code.

Installer Continue

Ouvrez VS Code
Allez dans Extensions (Ctrl/Cmd + Maj + X)
Recherchez “Continue” et installez-le

Configurer le Serveur MCP

Éditez le fichier de configuration de Continue :

Windows :

%USERPROFILE%\.continue\config.json

macOS/Linux :

~/.continue/config.json

Ajoutez le serveur MCP dans la section mcpServers :

{
  "mcpServers": [
    {
      "name": "mindzie",
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "votre-token-api-ici"
      }
    }
  ]
}

Vérifier la Configuration

Redémarrez VS Code
Ouvrez le panneau Continue
Tapez /tools pour voir les outils MCP disponibles incluant mindzie

Dépannage

Le serveur MCP ne se connecte pas

Vérifiez l’installation de Node.js : Exécutez node --version (doit être 18+)
Testez le serveur manuellement : Lancez npx -y @mindzie/mcp-server dans le terminal
Vérifiez les variables d’environnement : Assurez-vous que MINDZIE_API_URL et MINDZIE_API_TOKEN sont définis
Redémarrez l’application : Fermez complètement et rouvrez

Erreurs d’authentification

Vérifiez votre token API : Les tokens peuvent expirer ou être révoqués
Contrôlez les permissions du token : Assurez-vous que le token a accès aux ressources requises
Vérifiez l’URL : Confirmez que MINDZIE_API_URL pointe vers votre instance correcte

Outils qui n’apparaissent pas

Vérifiez la syntaxe de configuration : Assurez-vous que le JSON est valide (pas de virgule finale)
Vérifiez l’emplacement du fichier : Le fichier de configuration doit être au bon chemin
Consultez les logs de l’application : Recherchez des messages d’erreur liés au MCP
Redémarrez complètement : Certaines applications mettent en cache les configurations MCP

Erreurs communes de configuration

Erreur	Solution
Flag `-y` manquant dans les args npx	Ajoutez `-y` pour éviter la confirmation : `["-y", "@mindzie/mcp-server"]`
Virgule finale dans le JSON	Supprimez les virgules finales dans les objets JSON
Mauvais emplacement du fichier de config	Vérifiez à nouveau le chemin selon votre OS
Token contient des caractères spéciaux	Assurez-vous que le token est correctement cité dans le JSON

Bonnes Pratiques de Sécurité

Ne jamais commettre les tokens dans le contrôle de version – Utilisez des variables d’environnement ou gestionnaires de secrets
Utiliser des tokens spécifiques aux projets – Créez des tokens séparés pour différents projets
Faire tourner les tokens régulièrement – Surtout en production
Restreindre les permissions des tokens – Accorder uniquement les accès nécessaires
Surveiller l’usage des tokens – Examiner régulièrement les logs d’accès API

Découverte Unifiée pour Assistants IA

Le paramètre de catégorie unified est conçu spécifiquement pour les assistants IA. Lorsqu’une IA a besoin de comprendre les capacités d’analyse disponibles, elle peut effectuer un seul appel MCP :

mindzie_list_block_types category="unified"

Cela retourne tout ce dont l’IA a besoin pour :

Comprendre les capacités disponibles : Tous les filtres, calculateurs et enrichissements
Sélectionner les types de blocs appropriés : Basé sur UsageFrequency et CommonUseCases
Faire le lien avec la documentation : Chaque type de bloc inclut DocumentationUrl
Identifier les relations : Le champ RelatedBlocks suggère des types de blocs complémentaires

Exemple de Flux de Travail IA

Un assistant IA aidant un utilisateur à analyser la durée des processus pourrait :

Appeler mindzie_list_block_types category="unified" pour découvrir les capacités
Trouver les types de blocs dont CommonUseCases contient "duration"
Suggérer CaseDurationCalculator et WaitTimeCalculator
Créer les blocs appropriés via l’API
Exécuter et interpréter les résultats

Références des Champs de Réponse

Lorsque vous utilisez category="unified", chaque type de bloc inclut :

Champ	Description	Usage IA
`OperatorName`	Identifiant technique	Utiliser lors de la création des blocs via l’API
`DisplayName`	Nom lisible	Afficher aux utilisateurs
`Description`	Brève description	Aider les utilisateurs à comprendre le but
`Category`	Regroupement fonctionnel	Organiser les suggestions
`BlockType`	Filtre / Calculateur / Enrichissement	Déterminer le contexte d’utilisation
`DocumentationUrl`	Lien vers docs	Obtenir des informations détaillées
`UsageFrequency`	Élevé / Moyen / Faible	Prioriser les blocs fréquents
`CommonUseCases`	Scénarios exemples	Correspondre aux objectifs utilisateurs
`RelatedBlocks`	Types de blocs connexes	Suggérer des blocs complémentaires
`UsageNotes`	Guides supplémentaires	Fournir du contexte aux utilisateurs

Bonnes Pratiques

Pour les Assistants IA

Commencer par la découverte unifiée : Toujours appeler d’abord avec category="unified"
Mettre en cache les résultats : Les métadonnées des types de bloc changent peu fréquemment
Correspondre aux cas d’usage : Utiliser le champ CommonUseCases pour trouver les blocs pertinents
Suggérer des blocs liés : Utiliser RelatedBlocks pour offrir des analyses complémentaires

Pour les Développeurs

Sécuriser vos tokens : Ne jamais exposer les tokens API côté client
Utiliser les scopes appropriés : Demander uniquement les permissions nécessaires
Gérer les limites de taux : Implémenter un backoff exponentiel pour les réessais
Valider les réponses : Vérifier les erreurs avant de traiter les résultats

Étapes Suivantes

API des Types de Blocs Unifiés – Documentation API directe
API de Génération d’URL – Générer des URL de navigation
Vue d’ensemble des Outils de Codage IA – Intégration générale des outils IA
Authentification – Détails d’authentification API