--- title: "Configurer le Tulip MCP" slug: "setting-up-the-tulip-mcp" updated: 2026-10-22T11:17:35Z published: 2026-10-22T11:17:35Z canonical: "support.tulip.co/setting-up-the-tulip-mcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Configurer le Tulip MCP ## Comment configurer le Tulip MCP ? La documentation détaillée relative à la configuration du Tulip MCP est disponible dans le référentiel officiel : [https://github.com/tulip/tulip-mcp/tree/master](https://github.com/tulip/tulip-mcp/tree/master) La configuration du Tulip MCP a été simplifiée. Le nouveau processus comprend trois étapes clés : 1. Configurer vos identifiants 2. Lancer le serveur 3. Se connecter à un client MCP ### Prérequis Avant de commencer, assurez-vous que [Node.js](https://nodejs.org/en/download) est bien installé sur votre système. Cela est nécessaire pour exécuter le serveur. **Vérification de la version de npm et de Node.js Exécutez**les commandes suivantes dans votre terminal/Terminal Windows (Invite de commandes, PowerShell) : `node -v npm -v Si`un nom de version s'affiche, tout est prêt et vous pouvez passer à l'étape 1. Sinon, rendez-vous sur [le site de Node.js](https://nodejs.org/en/download) et installez la dernière version adaptée à votre système d'exploitation. ## Configurer vos identifiants API Tulip Pour vous connecter à Tulip via l’API, vous devez créer un fichier `.env` qui stocke vos identifiants API en toute sécurité. ### 1. Créez un dossier de configuration Choisissez ou créez un dossier dans lequel vous souhaitez stocker votre fichier de configuration d’environnement. ### Guide : Créer un fichier `.env` Ce fichier contiendra vos identifiants Tulip. Un exemple de fichier `.env` est disponible [ici](https://github.com/tulip/tulip-mcp/blob/main/env.example). #### **Utilisateurs Mac :** 1. Ouvrez **le Terminal** et exécutez les commandes suivantes : `bashtouch .envnano .env2`. Collez le modèle d'identifiants (à l'étape suivante) dans le nouveau fichier.3. Après avoir ajouté vos identifiants, suivez les instructions d'enregistrement ci-dessous. #### **Utilisateurs Windows :** 1. Ouvrez le Bloc-notes. 2. Collez le modèle d'identifiants (disponible à l'étape suivante) dans le nouveau fichier. 3. Une fois vos identifiants ajoutés, suivez les instructions d'enregistrement ci-dessous. ### 2. Ajoutez vos identifiants Tulip Copiez et collez ce qui suit dans le fichier `.env`, en remplaçant les valeurs par défaut par vos identifiants réels : `TULIP_API_KEY=votre_clé_API_iciTULIP_API_SECRET=votre_secret_API_iciTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=votre_id_d'espace_de_travail_ici_si_vous_utilisez_une_clé_API_de_compte` - **TULIP_BASE_URL**: il s'agit de l'URL que vous utilisez pour accéder à Tulip. *Exemple*: `https://my-company.tulip.co` - **TULIP_WORKSPACE_ID**: se trouve dans votre URL Tulip après `/w/.` *Exemple*: dans `https://my-company.tulip.co/w/DEFAULT`, l’ID de l’espace de travail est `DEFAULT`. :::(Avertissement) (Important) N'indiquez `TULIP_WORKSPACE_ID` que si vous utilisez une **clé API de compte** (disponible dans **les paramètres du compte**). Si vous utilisez une **clé API d’espace de travail** (provenant **des paramètres de l’espace de travail**), vous pouvez laisser cette field vide. ::: Enregistrez votre fichier et assurez-vous qu’il se trouve bien dans le dossier que vous avez spécifié. ### 3. Démarrez le serveur Une fois votre fichier `.env` configuré, vous pouvez démarrer le serveur. Ouvrez votre terminal ou votre invite de commande, accédez au dossier contenant votre fichier `.env`, puis exécutez la commande suivante : `bashnpx @tulip/mcp-serverCette`commande téléchargera la dernière version du serveur Tulip MCP et le lancera. Le serveur est désormais en cours d’exécution et prêt à être connecté à un client MCP. ### 4. Se connecter à Tulip MCP Lorsqu'un client MCP exécute le serveur, celui-ci ne se trouve pas forcément dans le même répertoire que votre fichier `.env`; il ne trouvera donc pas automatiquement les identifiants. Pour remédier à cela, vous devez indiquer le chemin d'accès complet vers votre fichier `.env` à l'aide de l'option `--env` dans la configuration du client. ### Guide : trouver le chemin d’accès à votre fichier .env 1. Accédez au dossier dans lequel vous avez créé votre fichier `.env`. 2. **Sous Windows :** cliquez avec le bouton droit sur le fichier `.env` tout en maintenant la touche `Maj` enfoncée, puis sélectionnez **« Copier en tant que chemin d’accès ».** 3. **Sous macOS :** cliquez avec le bouton droit sur le fichier `.env`, maintenez la touche `Option` enfoncée, puis sélectionnez **« Copier .env en tant que chemin d'accès ».** 4. Vous utiliserez ce chemin d'accès copié dans la configuration du client ci-dessous. ### Guide : Claude Desktop 1. Dans la barre de menu de Claude Desktop, sélectionnez **Paramètres…** > **Développeur** > **Modifier la configuration**. 2. Cela ouvrira le fichier `claude_desktop_config.json`. 3. Ajoutez la configuration du serveur à l'intérieur de l'objet `mcpServers`. **Vous devez remplacer `« C:\\chemin\\vers\\votre\\.env »` par le chemin d'accès réel que vous avez copié.** `json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\chemin\\vers\\votre\\.env" ] } } }` 4. Enregistrez le fichier et **redémarrez Claude Desktop**. > Pour plus de détails, consultez le [guide de démarrage rapide officiel de Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user). ### Cursor Pour une configuration simplifiée, cliquez sur le bouton ci-dessous. Cela permettra de préremplir la commande dans Cursor. [Se connecter à Cursor](https://cursor.com/install-mcp?name=tulip-mcp&config=eyJjb21tYW5kIjoibnB4IEB0dWxpcC9tY3Atc2VydmVyIC0tZW52IEM6XFxwYXRoXFx0b1xceW91clxcLmVudiJ9) Après avoir cliqué sur le bouton, **vous devez remplacer le texte de remplacement** (`REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE`) par le chemin d'accès complet à votre fichier `.env` que vous avez copié précédemment. ### Configuration avancée #### Obtenir les identifiants API de Tulip Vous pouvez créer des identifiants API (comptes de service) à partir des paramètres de votre Tulip instance. 1. **Connexion :** accédez à votre Tulip instance. 2. **Accédez à l’API Tulip**: rendez-vous dans **Paramètres** > **API Tulip**. 3. **Créer un nouveau compte de service :** générez un nouveau compte de service en lui attribuant un nom descriptif (par exemple, « Serveur MCP »). 4. **Configurer les champs d’application :** accordez au compte de service les autorisations nécessaires (champs d’application). Voici un bon ensemble de champs d’application de départ pour un accès de base : `stations:read, users:read, tables:read, machines:read, apps:read, urls:sign` 5. **Copiez les identifiants :** copiez la clé API et le secret générés, puis collez-les dans votre fichier `.env`. #### Configuration de la sélection des outils Par défaut, pour des raisons de sécurité, le serveur n’active que les outils `en lecture seule` et les outils `de table`. Vous pouvez personnaliser les outils disponibles à l’aide de la variable d’environnement `ENABLED_TOOLS` dans votre fichier `.env`. La variable `ENABLED_TOOLS` accepte une liste séparée par des virgules pouvant inclure : - **Des noms d’outils individuels :** des outils spécifiques tels que `listStations`. - **Des catégories :** regroupements basés sur les droits d'accès (`lecture seule`, `écriture`, `administration`). - **Des types :** des regroupements basés sur les ressources (`table`, `machine`, `utilisateur`, `application`, `interface`, `station`, `groupe de stations`, `utilitaire`). **Exemples :** ``` # Activer toutes les opérations de lecture et d'écriture ENABLED\_TOOLS=lecture seule,écriture # Activer tous les outils liés aux tables et aux stations ENABLED\_TOOLS=table,station # Activer des outils spécifiques ENABLED\_TOOLS=listStations,addRecord # Une approche mixte recommandée ENABLED\_TOOLS=read-only,interface,station,user # Tout activer (à utiliser avec prudence car cela permet la suppression/l'archivage des données) ENABLED\_TOOLS=read-only,write,admin``` **Articles connexes** * [Configurer une API Tulip](/r230/docs/set-up-a-tulip-api) ```