Configurer le MCP Tulip

  • Publié le Aug 7, 2025
  • 4 Minute(s) lue(s)
  • Pete Hartnett
 Prev Next

Comment configurer Tulip MCP ?

Une documentation détaillée sur l'installation de Tulip MCP est disponible dans le dépôt officiel : https://github.com/tulip/tulip-mcp/tree/master

L'installation de Tulip MCP a été simplifiée. Le nouveau processus implique trois étapes clés :

  1. Configurer vos informations d'identification
  2. Exécuter le serveur
  3. Se connecter à un client MCP

Conditions préalables

Avant de commencer, assurez-vous que Node.js est installé sur votre système. Cela est nécessaire pour exécuter le serveur.

Vérifier votre version de npm et Node.jsExécutezles commandes suivantes dans votre terminal/Windows Terminal (Command Prompt, PowerShell) :

node -vnpm -vSivous obtenez un nom de version, vous pouvez continuer à l'étape 1. Sinon, allez sur node.js et installez la dernière version pour votre système d'exploitation.

Configurez vos identifiants API Tulip

Pour vous connecter à Tulip via l'API, vous devez créer un fichier .env qui stocke de manière sécurisée vos identifiants API.

1. Créer un dossier de configuration

Choisissez ou créez un dossier dans lequel vous souhaitez stocker votre fichier de configuration de l'environnement.

Guide : Créer un fichier .env

Ce fichier stockera vos identifiants Tulip. Un exemple de fichier .env est disponible ici.

Utilisateurs Mac :

  1. Ouvrez Terminal et exécutez les commandes suivantes :

bashtouch .envnano .env2. Collez le modèle d'informations d'identification (dans l'étape suivante) dans le nouveau fichier. 3. Après avoir ajouté vos informations d'identification, suivez les instructions de sauvegarde ci-dessous.

Utilisateurs de Windows :

  1. Ouvrez le Bloc-notes.
  2. Collez le modèle d'informations d'identification (dans l'étape suivante) dans le nouveau fichier.
  3. Après avoir ajouté vos informations d'identification, suivez les instructions de sauvegarde ci-dessous.

2. Ajouter vos informations d'identification Tulip

Copiez et collez les éléments suivants dans le fichier .env, en remplaçant les valeurs de remplacement 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=your_workspace_id_here_if_using_account_api_key

  • TULIP_BASE_URL: C'est 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.

:: :(Warning) (Important) N'incluez TULIP_WORKSPACE_ID que si vous utilisez une clé API de compte (à partir des paramètres du compte).

Si vous utilisez une clé API d'espace de travail (à partir des paramètres de l 'espace de travail), vous pouvez laisser cette adresse field vide.
:: :
Enregistrez votre fichier et assurez-vous qu'il se trouve dans le dossier que vous avez indiqué.

3. Exécuter le serveur

Une fois que votre fichier .env est configuré, vous pouvez démarrer le serveur.

Ouvrez votre terminal ou votre invite de commande, naviguez jusqu'au dossier contenant votre fichier .env, et exécutez la commande suivante :

bashnpx @tulip/mcp-server Lacommande téléchargera la dernière version du serveur Tulip MCP et le démarrera. Le serveur est maintenant en marche et prêt à être connecté à un client MCP.

4. Se connecter au Tulip MCP

Lorsqu'un client MCP exécute le serveur, il peut ne pas se trouver dans le même répertoire que votre fichier .env, il ne trouvera donc pas automatiquement les informations d'identification. Pour résoudre ce problème, vous devez fournir le chemin complet de votre fichier .env en utilisant l'option --env dans la configuration du client.

Guide : Trouver le chemin de votre fichier .env

  1. Naviguez jusqu'au dossier dans lequel vous avez créé votre fichier .env.
  2. Sous Windows : Cliquez avec le bouton droit de la souris sur le fichier .env tout en maintenant la touche Majuscule enfoncée, puis sélectionnez "Copier en tant que chemin".
  3. Sous macOS : Faites un clic droit sur le fichier . env, maintenez la touche Option enfoncée, puis sélectionnez "Copy .env as Pathname".
  4. Vous utiliserez ce chemin 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 dans l'objet mcpServers. Vous devez remplacer "C:\Npath\Nto\Nyour\N.env" par le chemin réel que vous avez copié. json { " mcpServers" : { "tulip-mcp" : { "command" : "npx", "args" : ["@tulip/mcp-server", "--env", "C:\N-\NPathes\N{\N-\N-{\N-{\N-{\N-{\N-{\N-{\N-{\N-{\N-{\N-}}" ] } } }
  4. Sauvegardez le fichier et redémarrez Claude Desktop.

Pour plus de détails, voir le document officiel Claude Desktop MCP Quickstart.

Curseur

Pour l'installation la plus simple, cliquez sur le bouton ci-dessous. La commande sera pré-remplie 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 complet de votre fichier .env que vous avez copié plus tôt.

Configuration avancée

Obtenir les identifiants API de Tulip

Vous pouvez créer des identifiants API (Tokens) à partir de vos paramètres Tulip instance.

  1. Se connecter : Accédez à votre Tulip instance.
  2. Naviguez jusqu'à API Tokens: Allez dans Paramètres > Jetons API.
  3. Créez un nouveau jeton API : Générez un nouveau jeton, en lui donnant un nom descriptif (par exemple, "MCP Server").
  4. Configurez les champs d'application : Accordez au jeton les autorisations nécessaires (scopes). Un bon ensemble de scopes pour un accès de base est : stations:read, users:read, tables:read, machines:read, apps:read, urls:sign.
  5. Copier les informations d'identification : Copiez la clé et le secret API générés et 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 en utilisant la variable d'environnement ENABLED_TOOLS dans votre fichier .env.

La variable ENABLED_TOOLS accepte une liste séparée par des virgules, qui peut inclure les éléments suivants

  • des noms d'outils individuels Des outils spécifiques tels que listStations.
  • Des catégories : Groupes basés sur la sécurité(lecture seule, écriture, admin).
  • Types : Groupements 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 précaution car cela permet de supprimer/archiver des données)

ENABLED\_TOOLS=lecture seule,écriture,admin````

**Articles connexes**

* [Mettre en place une API Tulip](/r230/docs/set-up-a-tulip-api)