Richten Sie das Tulip MCP ein

Wie richte ich das Tulip MCP ein?

Eine detaillierte Dokumentation zur Einrichtung des Tulip MCP ist im offiziellen Repository verfügbar: https://github.com/tulip/tulip-mcp/tree/master

Die Einrichtung des Tulip MCP wurde vereinfacht. Der neue Prozess umfasst drei wichtige Schritte:

Konfigurieren Sie Ihre Anmeldedaten
Starten Sie den Server
Verbinden Sie sich mit einem MCP-Client

Voraussetzungen

Stellen Sie vor dem Start sicher, dass Node.js auf Ihrem System installiert ist. Dies ist für den Betrieb des Servers erforderlich.

Überprüfen Sie Ihre Version von npm und Node.js. Führen Siedie folgenden Befehle in Ihrem Terminal/Windows-Terminal (Eingabeaufforderung, PowerShell)aus:

node -v npm -v Wennein Versionsname angezeigt wird, können Sie fortfahren und mit Schritt 1 beginnen. Ist dies nicht der Fall, rufen Sie die Node.js-Website auf und installieren Sie die neueste Version für Ihr Betriebssystem.

Konfigurieren Sie Ihre Tulip-API-Anmeldedaten

Um über die API eine Verbindung zu Tulip herzustellen, müssen Sie eine .env-Datei erstellen, in der Ihre API-Anmeldedaten sicher gespeichert werden.

1. Erstellen Sie einen Konfigurationsordner

Wählen Sie einen Ordner aus oder erstellen Sie einen neuen, in dem Sie Ihre Umgebungskonfigurationsdatei speichern möchten.

Anleitung: Erstellen einer `.env` -Datei

In dieser Datei werden Ihre Tulip-Anmeldedaten gespeichert. Ein Beispiel für eine .env-Datei finden Sie hier.

Mac-Nutzer:

Öffnen Sie das Terminal und führen Sie die folgenden Befehle aus:

bashtouch .envnano .env2. Fügen Sie die Vorlage für die Anmeldedaten (im nächsten Schritt) in die neue Datei ein.3. Befolgen Sie nach dem Hinzufügen Ihrer Anmeldedaten die unten stehenden Anweisungen zum Speichern.

Windows-Benutzer:

Öffnen Sie den Editor.
Fügen Sie die Vorlage für die Anmeldedaten (im nächsten Schritt) in die neue Datei ein.
Befolgen Sie nach dem Hinzufügen Ihrer Anmeldedaten die nachstehenden Anweisungen zum Speichern.

2. Fügen Sie Ihre Tulip-Anmeldedaten hinzu

Kopieren Sie den folgenden Text und fügen Sie ihn in die .env -Datei ein, wobei Sie die Platzhalterwerte durch Ihre tatsächlichen Anmeldedaten ersetzen:

TULIP_API_KEY=Ihr_API-Schlüssel_hierTULIP_API_SECRET=Ihr_API-Geheimnis_hierTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=Ihre_Workspace-ID_hier_bei_Verwendung_eines_Account-API-Schlüssels

TULIP_BASE_URL: Dies ist die URL, über die Sie auf Tulip zugreifen.
Beispiel: https://my-company.tulip.co
TULIP_WORKSPACE_ID: Diese finden Sie in Ihrer Tulip-URL hinter /w/.
Beispiel: In https://my-company.tulip.co/w/DEFAULT lautet die Workspace-ID „DEFAULT“.

:::(Warnung) (Wichtig)
Geben Sie TULIP_WORKSPACE_ID nur an, wenn Sie einen Account-API-Schlüssel (aus den Account-Einstellungen) verwenden.

Wenn Sie einen Workspace-API-Schlüssel (aus den Workspace-Einstellungen) verwenden, können Sie diese „ field “ leer lassen.
:::
Speichern Sie Ihre Datei und stellen Sie sicher, dass sich die Datei in dem von Ihnen angegebenen Ordner befindet.

3. Starten Sie den Server

Sobald Ihre .env -Datei konfiguriert ist, können Sie den Server starten.

Öffnen Sie Ihr Terminal oder die Eingabeaufforderung, wechseln Sie in den Ordner, der Ihre .env-Datei enthält, und führen Sie den folgenden Befehl aus:

bashnpx @tulip/mcp-server DerBefehl lädt die neueste Version des Tulip-MCP-Servers herunter und startet ihn. Der Server läuft nun und ist bereit für die Verbindung mit einem MCP-Client.

4. Verbindung zum Tulip MCP herstellen

Wenn ein MCP-Client den Server ausführt, befindet er sich möglicherweise nicht im selben Verzeichnis wie Ihre .env-Datei, sodass er die Anmeldedaten nicht automatisch findet. Um dies zu beheben, müssen Sie den vollständigen Pfad zu Ihrer .env-Datei mithilfe des Flags `--env` in der Konfiguration des Clients angeben.

Anleitung: So finden Sie den Pfad zu Ihrer .env-Datei

Navigiere zu dem Ordner, in dem du deine .env -Datei erstellt hast.
Unter Windows: Klicke mit der rechten Maustaste auf die .env -Datei, während du die Umschalttaste gedrückt hältst, und wähle dann „Als Pfad kopieren“.
Unter macOS: Klicken Sie mit der rechten Maustaste auf die .env -Datei, halten Sie die Optionstaste gedrückt und wählen Sie dann „.env als Pfadname kopieren“.
Diesen kopierten Pfad verwenden Sie in der folgenden Client-Konfiguration.

Anleitung: Claude Desktop

Wählen Sie in der Menüleiste von Claude Desktop „Einstellungen…“ > „Entwickler“ > „Konfiguration bearbeiten“.
Dadurch wird die Datei „claude_desktop_config.json“ geöffnet.
Fügen Sie die Serverkonfiguration innerhalb des Objekts „mcpServers“ hinzu. Sie müssen „C:\\Pfad\\zu\\Ihrer\\.env“ durch den tatsächlich kopierten Pfad ersetzen. json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\Pfad\\zu\\Ihrer\\.env" ] } } }
Speichern Sie die Datei und starten Sie Claude Desktop neu.

Weitere Informationen findest du im offiziellen Claude Desktop MCP-Schnellstart.

Cursor

Für die einfachste Einrichtung klicken Sie auf die Schaltfläche unten. Dadurch wird der Befehl in Cursor automatisch ausgefüllt.

Mit Cursor verbinden

Nachdem Sie auf die Schaltfläche geklickt haben, müssen Sie den Platzhaltertext (REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) durch den vollständigen Pfad zu Ihrer zuvor kopierten .env-Datei ersetzen.

Erweiterte Konfiguration

Tulip-API-Anmeldedaten abrufen

Sie können API-Zugangsdaten (Dienstkonten) in Ihren „ Tulip instance “-Einstellungen erstellen.

Anmelden: Rufen Sie Ihre „ Tulip instance “ auf.
Navigieren Sie zur Tulip-API: Gehen Sie zu „Einstellungen“ > „Tulip-API“.
Neues Dienstkonto erstellen: Erstellen Sie ein neues Dienstkonto und vergeben Sie einen aussagekräftigen Namen (z. B. „MCP-Server“).
Bereiche konfigurieren: Erteilen Sie dem Dienstkonto die erforderlichen Berechtigungen (Bereiche). Eine gute Ausgangsbasis für den grundlegenden Zugriff sind folgende Bereiche: stations:read, users:read, tables:read, machines:read, apps:read, urls:sign
Anmeldedaten kopieren: Kopieren Sie den generierten API-Schlüssel und das API-Geheimnis und fügen Sie diese in Ihre .env -Datei ein.

Konfiguration der Tool-Auswahl

Standardmäßig aktiviert der Server aus Sicherheitsgründen nur Lese- und Tabellen-Tools. Sie können über die Umgebungsvariable ENABLED_TOOLS in Ihrer `.env` -Datei festlegen, welche Tools verfügbar sind.

Die Variable ENABLED_TOOLS akzeptiert eine durch Kommas getrennte Liste, die Folgendes enthalten kann:

Einzelne Tool-Namen: Bestimmte Tools wie „listStations“.
Kategorien: Sicherheitsbasierte Gruppierungen (nur Lesen, Schreiben, Admin).
Typen: Ressourcenbasierte Gruppierungen (Tabelle, Maschine, Benutzer, App, Schnittstelle, Station, Stationsgruppe, Dienstprogramm).

Beispiele:


# Alle Lese- und Schreibvorgänge aktivieren

ENABLED\_TOOLS=read-only,write

# Alle Werkzeuge im Zusammenhang mit Tabellen und Stationen aktivieren

ENABLED\_TOOLS=table,station

# Bestimmte Tools aktivieren

ENABLED\_TOOLS=listStations,addRecord

# Ein empfohlener gemischter Ansatz

ENABLED\_TOOLS=read-only,interface,station,user

# Alles aktivieren (mit Vorsicht verwenden, da dies das Löschen/Archivieren von Daten ermöglicht)

ENABLED\_TOOLS=read-only,write,admin```

**Verwandte Artikel**

* [Einrichten einer Tulip-API](/r230/docs/set-up-a-tulip-api)