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

La configuration du Tulip MCP a été simplifiée. Le nouveau processus comprend trois étapes clés :

Configurer vos identifiants
Lancer le serveur
Se connecter à un client MCP

Prérequis

Avant de commencer, assurez-vous que Node.js 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écutezles commandes suivantes dans votre terminal/Terminal Windows (Invite de commandes, PowerShell) :

node -v npm -v Siun 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 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.

Utilisateurs Mac :

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 :

Ouvrez le Bloc-notes.
Collez le modèle d'identifiants (disponible à l'étape suivante) dans le nouveau fichier.
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-serverCettecommande 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

Accédez au dossier dans lequel vous avez créé votre fichier .env.
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 ».
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 ».
Vous utiliserez ce chemin d'accès copié dans la configuration du client ci-dessous.

Guide : Claude Desktop

Dans la barre de menu de Claude Desktop, sélectionnez Paramètres… > Développeur > Modifier la configuration.
Cela ouvrira le fichier claude_desktop_config.json.
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" ] } } }
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.

Cursor

Pour une configuration simplifiée, cliquez sur le bouton ci-dessous. Cela permettra de préremplir la commande dans Cursor.

Se connecter à Cursor

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.

Connexion : accédez à votre Tulip instance.
Accédez à l’API Tulip: rendez-vous dans Paramètres > API Tulip.
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 »).
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
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)