Konfiguracja Tulip MCP

  • Opublikowane dnia Aug 7, 2025
  • 3 minuty czytania
  • Pete Hartnett
 Prev Next

Jak skonfigurować Tulip MCP?

Szczegółowa dokumentacja konfiguracji Tulip MCP jest dostępna w oficjalnym repozytorium: https://github.com/tulip/tulip-mcp/tree/master.

Konfiguracja Tulip MCP została usprawniona. Nowy proces obejmuje trzy kluczowe kroki:

  1. Konfiguracja poświadczeń
  2. Uruchomienie serwera
  3. Połączenie z klientem MCP

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz zainstalowany Node.js w swoim systemie. Jest to wymagane do uruchomienia serwera.

Sprawdzenie wersji npm i Node.jsUruchomnastępujące polecenia w terminalu/Windows Terminal (Command Prompt, PowerShell):

node -vnpm -vJeśliotrzymasz nazwę wersji, możesz kontynuować krok 1. Jeśli nie, przejdź do node.js i zainstaluj najnowszą wersję dla swojego systemu operacyjnego.

Konfiguracja poświadczeń API Tulip

Aby połączyć się z Tulip przez API, należy utworzyć plik .env, który bezpiecznie przechowuje dane uwierzytelniające API.

1. Utwórz folder konfiguracji

Wybierz lub utwórz folder, w którym chcesz przechowywać plik konfiguracyjny środowiska.

Przewodnik: Tworzenie pliku .env

Ten plik będzie przechowywał dane uwierzytelniające Tulip. Przykładowy plik . env jest dostępny tutaj.

Użytkownicy komputerów Mac:

  1. Otwórz Terminal i uruchom następujące polecenia:

bashtouch .envnano .env2. Wklej szablon poświadczeń (w następnym kroku) do nowego pliku.3. Po dodaniu poświadczeń postępuj zgodnie z instrukcjami zapisywania poniżej.

Użytkownicy systemu Windows:

  1. Otwórz Notatnik.
  2. Wklej szablon poświadczeń (w następnym kroku) do nowego pliku.
  3. Po dodaniu poświadczeń postępuj zgodnie z poniższymi instrukcjami zapisu.

2. Dodaj swoje poświadczenia Tulip

Skopiuj i wklej poniższe dane do pliku .env, zastępując wartości zastępcze rzeczywistymi danymi uwierzytelniającymi:

TULIP_API_KEY=your_api_key_hereTULIP_API_SECRET=your_api_secret_hereTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

  • TULIP_BASE_URL: Jest to adres URL używany do uzyskania dostępu do Tulip.
    Przykład: https://my-company.tulip.co
  • TULIP_WORKSPACE_ID: Znajduje się w adresie URL Tulip po /w/.
    Przykład: W https://my-company.tulip.co/w /DEFAULT identyfikator przestrzeni roboczej to DEFAULT.

::::(Ostrzeżenie) (Ważne) Dołącz TULIP_WORKSPACE_ID tylko wtedy, gdy używasz klucza API konta (z ustawień konta).

Jeśli używasz klucza API obszaru roboczego (w ustawieniach obszaru roboczego), możesz pozostawić to field puste.
:::
Zapisz plik i upewnij się, że znajduje się on w określonym folderze.

3. Uruchom serwer

Po skonfigurowaniu pliku .env można uruchomić serwer.

Otwórz terminal lub wiersz polecenia, przejdź do folderu zawierającego plik .env i uruchom następujące polecenie:

bashnpx @tulip/mcp-serverPoleceniepobierze najnowszą wersję serwera Tulip MCP i uruchomi go. Serwer jest teraz uruchomiony i gotowy do połączenia z klientem MCP.

4. Połączenie z Tulip MCP

Gdy klient MCP uruchamia serwer, może on nie znajdować się w tym samym katalogu co plik .env, więc nie znajdzie poświadczeń automatycznie. Aby to naprawić, należy podać pełną ścieżkę do pliku .env za pomocą flagi --env w konfiguracji klienta.

Przewodnik: Znajdowanie ścieżki do pliku .env

  1. Przejdź do folderu, w którym utworzyłeś plik . env.
  2. W systemie Windows: Kliknij prawym przyciskiem myszy plik . env, przytrzymując klawisz Shift, a następnie wybierz opcję "Kopiuj jako ścieżkę".
  3. W systemie macOS: Kliknij prawym przyciskiem myszy plik . env, przytrzymaj klawisz Option, a następnie wybierz opcję "Kopiuj .env jako ścieżkę".
  4. Skopiowana ścieżka zostanie użyta w poniższej konfiguracji klienta.

Przewodnik: Claude Desktop

  1. Z paska menu Claude Desktop wybierz Settings... > Developer > Edit Config.
  2. Spowoduje to otwarcie pliku claude_desktop_config.json.
  3. Dodaj konfigurację serwera wewnątrz obiektu mcpServers. Musisz zastąpić "C:\\path\\to\\your\\.env" rzeczywistą ścieżką, którą skopiowałeś . json { " mcpServers": { "tulip-mcp": { "command": "npx", "args": ["@tulip/mcp-server", "--env", "C:\\path\\to\\\your\\.env" ] } } }
  4. Zapisz plik i uruchom ponownie Claude Desktop.

Aby uzyskać więcej informacji, zobacz oficjalny przewodnik Szybki start Claude Desktop MCP.

Kursor

Aby uzyskać najprostszą konfigurację, kliknij poniższy przycisk. Spowoduje to wstępne wypełnienie polecenia w aplikacji Cursor.

Połącz z Cursor

Po kliknięciu przycisku należy zastąpić tekst zastępczy(REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) pełną ścieżką do skopiowanego wcześniej pliku .env.

Zaawansowana konfiguracja

Pobieranie poświadczeń API Tulip

Poświadczenia API (Tokeny) można utworzyć w ustawieniach Tulip instance.

  1. Zaloguj się: Wejdź na swoją stronę Tulip instance.
  2. Przejdź do API Tokens: Przejdź do Ustawienia > Tokeny API.
  3. Utwórz nowy token API: Wygeneruj nowy token, nadając mu opisową nazwę (np. "MCP Server").
  4. Skonfiguruj zakresy: Nadaj tokenowi niezbędne uprawnienia (zakresy). Dobry początkowy zestaw zakresów dla podstawowego dostępu to: stations:read, users:read, tables:read, machines:read, apps:read, urls:sign
  5. Kopiowanie poświadczeń: Skopiuj wygenerowane API Key i Secret i wklej je do pliku .env.

Konfiguracja wyboru narzędzia

Domyślnie, ze względów bezpieczeństwa, serwer włącza tylko narzędzia tylko do odczytu i tabele. Można dostosować, które narzędzia są dostępne za pomocą zmiennej środowiskowej ENABLED_TOOLS w pliku .env.

Zmienna ENABLED_TOOLS akceptuje listę oddzieloną przecinkami, która może zawierać:

  • Poszczególne nazwy narzędzi: Konkretne narzędzia, takie jak listStations.
  • Kategorie: Grupy oparte na zabezpieczeniach(tylko do odczytu, do zapisu, admin).
  • Typy: Grupy oparte na zasobach(tabela, maszyna, użytkownik, aplikacja, interfejs, stacja, grupa stacji, narzędzie).

Przykłady:

``env

# Włączenie wszystkich operacji odczytu i zapisu

ENABLED_TOOLS=tylko do odczytu,tylko do zapisu

# Włączenie wszystkich narzędzi związanych z tabelami i stacjami

ENABLED_TOOLS=table,station

# Włącz określone narzędzia

ENABLED_TOOLS=listStations,addRecord

# Zalecane podejście mieszane

ENABLED_TOOLS=tylko do odczytu,interfejs,stacja,użytkownik

# Włącz wszystko (używaj ostrożnie, ponieważ pozwala to na usuwanie/archiwizowanie danych)

ENABLED_TOOLS=read-only,write,admin```

Powiązane artykuły