--- title: "Richten Sie das Tulip MCP ein" slug: "setting-up-the-tulip-mcp" status: "update" updated: 2026-10-22T11:17:28Z published: 2026-10-22T11:17:28Z 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. # 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](https://github.com/tulip/tulip-mcp/tree/master) Die Einrichtung des Tulip MCP wurde vereinfacht. Der neue Prozess umfasst drei wichtige Schritte: 1. Konfigurieren Sie Ihre Anmeldedaten 2. Starten Sie den Server 3. Verbinden Sie sich mit einem MCP-Client ### Voraussetzungen Stellen Sie vor dem Start sicher, dass [Node.js](https://nodejs.org/en/download) 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 Sie**die folgenden Befehle in Ihrem Terminal/Windows-Terminal (Eingabeaufforderung, PowerShell)**aus**: `node -v npm -v Wenn`ein Versionsname angezeigt wird, können Sie fortfahren und mit Schritt 1 beginnen. Ist dies nicht der Fall, rufen Sie [die Node.js-Website](https://nodejs.org/en/download) 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](https://github.com/tulip/tulip-mcp/blob/main/env.example). #### **Mac-Nutzer:** 1. Ö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:** 1. Öffnen Sie den Editor. 2. 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 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 Der`Befehl 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 1. Navigiere zu dem Ordner, in dem du deine `.env` -Datei erstellt hast. 2. **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**“. 3. **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**“. 4. Diesen kopierten Pfad verwenden Sie in der folgenden Client-Konfiguration. ### Anleitung: Claude Desktop 1. Wählen Sie in der Menüleiste von Claude Desktop **„Einstellungen…“** > **„Entwickler“** > **„Konfiguration bearbeiten**“. 2. Dadurch wird die Datei `„claude_desktop_config.json“` geöffnet. 3. 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" ] } } }` 4. Speichern Sie die Datei und **starten Sie Claude Desktop neu**. > Weitere Informationen findest du im [offiziellen Claude Desktop MCP-Schnellstart](https://modelcontextprotocol.io/quickstart/user). ### 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](https://cursor.com/install-mcp?name=tulip-mcp&config=eyJjb21tYW5kIjoibnB4IEB0dWxpcC9tY3Atc2VydmVyIC0tZW52IEM6XFxwYXRoXFx0b1xceW91clxcLmVudiJ9) 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. 1. **Anmelden:** Rufen Sie Ihre „ Tulip instance “ auf. 2. **Navigieren Sie zur Tulip-API**: Gehen Sie zu **„Einstellungen“** > **„Tulip-API**“. 3. **Neues Dienstkonto erstellen:** Erstellen Sie ein neues Dienstkonto und vergeben Sie einen aussagekräftigen Namen (z. B. „MCP-Server“). 4. **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` 5. **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) ```