A Tulip MCP beállítása

  • közzétett Aug 7, 2025
  • 4 leolvasott perc(ek)
  • Pete Hartnett
 Prev Next

Hogyan kell beállítani a Tulip MCP-t?

A Tulip MCP részletes beállítási dokumentációja a hivatalos tárolóban érhető el: https://github.com/tulip/tulip-mcp/tree/master.

A Tulip MCP beállítása egyszerűsödött. Az új folyamat három kulcsfontosságú lépést foglal magában:

  1. A hitelesítő adatok konfigurálása
  2. A kiszolgáló futtatása
  3. Csatlakozás egy MCP klienshez

Előfeltételek

Mielőtt elkezdené, győződjön meg róla, hogy a Node.js telepítve van a rendszerén. Ez szükséges a kiszolgáló futtatásához.

Az npm és a Node.js verziójának ellenőrzéseFuttassaa következő parancsokat a termináljában/Windows Terminalban (Command Prompt, PowerShell):

Hamegkapja a verzió nevét, akkor készen áll, és folytathatja az 1. lépést.Ha nem, akkor irány a node.js, és telepítse az operációs rendszerének legfrissebb verzióját.

A Tulip API hitelesítő adatainak konfigurálása

Ahhoz, hogy API-n keresztül csatlakozhasson a Tuliphoz, létre kell hoznia egy .env fájlt, amely biztonságosan tárolja az API hitelesítő adatait.

1. Hozzon létre egy konfigurációs mappát

Válasszon ki vagy hozzon létre egy mappát, ahol a környezeti konfigurációs fájlját tárolni szeretné.

Útmutató: env fájl létrehozása

Ez a fájl fogja tárolni a Tulip hitelesítő adatait. Egy példa .env fájl itt érhető el.

Mac felhasználók:

  1. Nyissa meg a Terminált, és futtassa a következő parancsokat:

envnano .env2. Illessze be a hitelesítő adatok sablonját (a következő lépésben) az új fájlba. 3. A hitelesítő adatok hozzáadása után kövesse az alábbi mentési utasításokat.

Windows-felhasználók:

  1. Nyissa meg a Jegyzettömböt.
  2. Illessze be a hitelesítő adatok sablonját (a következő lépésben) az új fájlba.
  3. A hitelesítő adatok hozzáadása után kövesse az alábbi mentési utasításokat.

2. A Tulip hitelesítő adatok hozzáadása

Másolja ki és illessze be az alábbiakat az .env fájlba, a helyőrző értékek helyettesítve a tényleges hitelesítő adatokkal:

TULIP_API_KEY=a_api_kulcsa_ittTULIP_API_SECRET=a_api_titka_ittTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

  • TULIP_BASE_URL: Ez az az URL, amelyet a Tulip eléréséhez használ.
    Példa: https://my-company.tulip.co
  • TULIP_WORKSPACE_ID: A Tulip URL-címében található a /w/ után.
    Példa: A https://my-compa ny.tulip.co/w/DEFAULT oldalon a munkaterület azonosítója a DEFAULT.

::::(Figyelmeztetés) (Fontos) A TULIP_WORKSPACE_ID-t csak akkor adja meg, ha fiók API-kulcsot használ (a fiókbeállításokból).

Ha munkaterület API-kulcsot használ (a munkaterület-beállításokból), akkor ezt a field címet üresen hagyhatja.
:::
Mentse a fájlt, és győződjön meg róla, hogy a fájl a megadott mappában található.

3. Futtassa a kiszolgálót

Miután az .env fájl konfigurálva van, elindíthatja a kiszolgálót.

Nyissa meg a terminált vagy a parancssort, navigáljon az .env fájlt tartalmazó mappába, és futtassa a következő parancsot:

Aparancs letölti a Tulip MCP-kiszolgáló legújabb verzióját, és elindítja azt. A kiszolgáló most már fut, és készen áll az MCP-ügyfélhez való csatlakozásra.

4. Csatlakozás a Tulip MCP-hez

Amikor egy MCP-kliens futtatja a kiszolgálót, előfordulhat, hogy az nem ugyanabban a könyvtárban van, mint az .env fájl, így nem fogja automatikusan megtalálni a hitelesítő adatokat. Ennek kijavításához meg kell adnia az .env fájl teljes elérési útvonalát az ügyfél konfigurációjában a --env jelzővel.

Útmutató: env fájl elérési útvonalának megkeresése

  1. Navigáljon abba a mappába, ahol létrehozta az .env fájlt.
  2. Windows alatt: Kattintson a jobb gombbal az .env fájlra, miközben lenyomva tartja a Shift billentyűt, majd válassza a "Copy as path" (Másolás útvonalként) lehetőséget.
  3. MacOS rendszeren: Kattintson a jobb gombbal az .env fájlra, tartsa lenyomva az Option billentyűt, majd válassza a "Copy .env as Pathname" lehetőséget.
  4. Ezt a másolt elérési utat fogja használni az alábbi ügyfélkonfigurációban.

Útmutató: Claude Desktop

  1. A Claude Desktop menüsorában válassza a Beállítások... > Fejlesztő > Konfiguráció szerkesztése menüpontot.
  2. Ez megnyitja a claude_desktop_config.json fájlt.
  3. Adja hozzá a szerverkonfigurációt az mcpServers objektumon belül. A "C:\\\path\\to\\\your\\.env" helyett a tényleges másolt elérési útvonalat kell megadnia. json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\\path\\to\\\your\\\.env" ] ] } } }
  4. Mentse a fájlt, és indítsa újra a Claude Desktopot.

További részletekért lásd a hivatalos Claude Desktop MCP Quickstart című dokumentumot.

Cursor

A legegyszerűbb beállításhoz kattintson az alábbi gombra. Ez előre kitölti a parancsot a Cursorban.

Csatlakozás a Cursorhoz

A gombra kattintás után a helyőrző szöveget(REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) ki kell cserélnie a korábban másolt .env fájl teljes elérési útvonalára.

Speciális konfiguráció

Tulip API hitelesítő adatok beszerzése

API hitelesítő adatokat (Tokeneket) a Tulip instance beállításaiból hozhat létre.

  1. Jelentkezzen be: Lépjen be a Tulip instance.
  2. Navigáljon az API tokenek menüpontra: Menjen a Beállítások > API tokenek menüpontra.
  3. Hozzon létre egy új API tokent: Hozzon létre egy új tokent, és adjon neki egy leíró nevet (pl. "MCP Server").
  4. Konfigurálja a hatóköröket: Adja meg a token számára a szükséges jogosultságokat (hatóköröket). Az alapszintű hozzáféréshez a következő hatóköröket érdemes használni: stations:read, users:read, tables:read, machines:read, apps:read, urls:sign.
  5. Hitelesítési adatok másolása: Másolja ki a generált API-kulcsot és titkot, és illessze be őket az .env fájlba.

Eszközkiválasztás konfigurációja

Alapértelmezés szerint a kiszolgáló a biztonság kedvéért csak a csak olvasható és a táblázatos eszközöket engedélyezi. Az .env fájlban található ENABLED_TOOLS környezeti változóval testre szabhatja, hogy mely eszközök legyenek elérhetők.

Az ENABLED_TOOLS változó egy vesszővel elválasztott listát fogad el, amely tartalmazhatja a következőket:

  • Egyedi eszköznevek: Speciális eszközök, például listStations.
  • Kategóriák: Biztonsági alapú csoportosítások(csak olvasható, írható, admin).
  • Típusok: Erőforrás-alapú csoportosítások(tábla, gép, felhasználó, alkalmazás, interfész, állomás, állomáscsoport, segédprogram).

Példák:


# Minden olvasási és írási művelet engedélyezése

ENABLED\_TOOLS=read-only,write

# A táblázatokhoz és állomásokhoz kapcsolódó összes eszköz engedélyezése

ENABLED\_TOOLS=table,station

# Speciális eszközök engedélyezése

ENABLED\_TOOLS=listStations,addRecord

# Ajánlott vegyes megközelítés

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

# Engedélyezzen mindent (óvatosan, mert ez lehetővé teszi az adatok törlését/archiválását).

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

**Kapcsolódó cikkek**

* [Tulip API beállítása](/r230/docs/set-up-a-tulip-api)