Skonfiguruj Tulip MCP

Jak skonfigurować Tulip MCP?

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

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

1. Skonfiguruj swoje dane uwierzytelniające
2. Uruchom serwer
3. Połącz się z klientem MCP

Wymagania wstępne

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

Sprawdzanie wersji npm i Node.js Uruchomnastępujące polecenia w terminalu/terminalu Windows (wiersz poleceń, PowerShell):

node -v npm -v Jeśliwyświetli się nazwa wersji, wszystko jest w porządku i możesz przejść do kroku 1. Jeśli nie, przejdź na stronę node.js i zainstaluj najnowszą wersję dla swojego systemu operacyjnego.

Skonfiguruj dane uwierzytelniające do API Tulip

Aby połączyć się z Tulipem za pośrednictwem API, musisz utworzyć plik .env, w którym będą bezpiecznie przechowywane Twoje dane uwierzytelniające API.

1. Utwórz folder konfiguracyjny

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

Poradnik: Utwórz plik .env

W tym pliku będą przechowywane dane uwierzytelniające do serwisu 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 danych uwierzytelniających (z następnego kroku) do nowego pliku.3. Po dodaniu danych uwierzytelniających postępuj zgodnie z poniższymi instrukcjami dotyczącymi zapisywania.

Użytkownicy systemu Windows:

1. Otwórz Notatnik.
2. Wklej szablon danych uwierzytelniających (z następnego kroku) do nowego pliku.
3. Po dodaniu danych uwierzytelniających postępuj zgodnie z poniższymi instrukcjami dotyczącymi zapisywania.

2. Dodaj swoje dane uwierzytelniające do serwisu Tulip

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

TULIP_API_KEY=twój_klucz_api_tutajTULIP_API_SECRET=twój_sekret_api_tutajTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=twój_identyfikator_przestrzeni_roboczej_tutaj_jeśli_używasz_klucza_API_konta

• TULIP_BASE_URL: Jest to adres URL, którego używasz, aby uzyskać dostęp do Tulip.
  Przykład: https://my-company.tulip.co
• TULIP_WORKSPACE_ID: Znajduje się w adresie URL serwisu Tulip po znaku /w/.
  Przykład: W adresie https://my-company.tulip.co/w/DEFAULT identyfikator obszaru roboczego to DEFAULT.

:::(Ostrzeżenie) (Ważne)
Pole TULIP_WORKSPACE_ID należy wypełnić tylko wtedy, gdy korzystasz z klucza API konta (z ustawień konta).

Jeśli korzystasz z klucza API obszaru roboczego (z ustawień obszaru roboczego), możesz pozostawić to pole „ field ” puste.
:::
Zapisz plik i upewnij się, że znajduje się on w określonym folderze.

3. Uruchom serwer

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

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

bashnpx @tulip/mcp-serverPolecenie to spowoduje pobranie najnowszej wersji serwera Tulip MCP i jego uruchomienie. Serwer działa teraz i jest gotowy do połączenia z klientem MCP.

4. Połącz się 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 on automatycznie danych uwierzytelniających. Aby to naprawić, należy podać pełną ścieżkę do pliku .env, używając flagi --env w konfiguracji klienta.

Poradnik: Znajdowanie ścieżki do pliku .env

1. Przejdź do folderu, w którym utworzono 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. Skopiowaną ścieżkę wykorzystasz w poniższej konfiguracji klienta.

Poradnik: Claude Desktop

1. Z paska menu Claude Desktop wybierz Ustawienia... > Programista > Edytuj konfigurację.
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:\\ścieżka\\do\\twojego\\.env" ] } } }
4. Zapisz plik i uruchom ponownie aplikację Claude Desktop.

Więcej szczegółów znajdziesz w oficjalnym przewodniku szybkiego startu Claude Desktop MCP.

Cursor

Aby jak najłatwiej skonfigurować program, kliknij przycisk poniżej. Spowoduje to wstępne wypełnienie polecenia w programie Cursor.

Połącz się z Cursorem

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

Konfiguracja zaawansowana

Pobieranie poświadczeń API serwisu Tulip

Dane uwierzytelniające API (konta usługowe) można utworzyć w ustawieniach serwisu Tulip instance.

1. Zaloguj się: Wejdź na stronę Tulip instance.
2. Przejdź do Tulip API: Przejdź do Ustawienia > Tulip API.
3. Utwórz nowe konto usługowe: Wygeneruj nowe konto usługowe, nadając mu opisową nazwę (np. „Serwer MCP”).
4. Skonfiguruj zakresy: Przyznaj kontu usługowemu niezbędne uprawnienia (zakresy). Dobrym zestawem początkowym zakresów zapewniających podstawowy dostęp jest: stations:read, users:read, tables:read, machines:read, apps:read, urls:sign
5. Skopiuj dane uwierzytelniające: Skopiuj wygenerowany klucz API i sekret, a następnie wklej je do pliku .env.

Konfiguracja wyboru narzędzi

Domyślnie, ze względów bezpieczeństwa, serwer włącza tylko narzędzia do odczytu i narzędzia do pracy z tabelami. Możesz dostosować, które narzędzia są dostępne, używając zmiennej środowiskowej ENABLED_TOOLS w pliku .env.

Zmienna ENABLED_TOOLS przyjmuje listę elementów rozdzielonych przecinkami, która może zawierać:

• Nazwy poszczególnych narzędzi: konkretne narzędzia, takie jak listStations.
• Kategorie: Grupy oparte na zabezpieczeniach (tylko do odczytu, zapisu, administratora).
• Typy: pogrupowania oparte na zasobach (tabela, maszyna, użytkownik, aplikacja, interfejs, stacja, grupa stacji, narzędzie).

Przykłady:

# Włącz wszystkie operacje odczytu i zapisu

ENABLED\_TOOLS=tylko do odczytu,zapis

# Włącz wszystkie narzędzia związane z tabelami i stacjami

ENABLED\_TOOLS=table,station

# Włącz określone narzędzia

ENABLED\_TOOLS=listStations,addRecord

# Zalecane podejście mieszane

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

# Włącz wszystko (należy zachować ostrożność, ponieważ umożliwia to usuwanie/archiwizację danych)

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

**Powiązane artykuły**

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