Configurazione di Tulip MCP

Nuovo
  • Pubblicato il: Aug 7, 2025
  • 4 minuto/i letto/i
  • Pete Hartnett
 Prev Next

Come si configura Tulip MCP?

La documentazione dettagliata per la configurazione di Tulip MCP è disponibile nel repository ufficiale: https://github.com/tulip/tulip-mcp/tree/master.

La configurazione di Tulip MCP è stata semplificata. Il nuovo processo prevede tre passaggi chiave:

  1. Configurare le credenziali
  2. Eseguire il server
  3. Connettersi a un client MCP

Prerequisiti

Prima di iniziare, assicuratevi di avere installato Node.js sul vostro sistema. Questo è necessario per eseguire il server.

Verifica della versione di npm e Node.jsEseguitei seguenti comandi nel vostro terminale/Windows Terminal (Prompt dei comandi, PowerShell):

node -vnpm -vSesi ottiene il nome della versione, allora si è a posto e si può continuare con il passo 1. In caso contrario, andare su node.js e installare la versione più recente per il proprio sistema operativo.

Configurare le credenziali API di Tulip

Per connettersi a Tulip tramite API, è necessario creare un file .env che memorizzi in modo sicuro le credenziali API.

1. Creare una cartella di configurazione

Scegliere o creare una cartella in cui memorizzare il file di configurazione dell'ambiente.

Guida: Creare un file .env

Questo file memorizzerà le credenziali di Tulip. Un esempio di file .env è disponibile qui.

Utenti Mac:

  1. Aprire il Terminale ed eseguire i seguenti comandi:

bashtouch .envnano .env2. Incollare il modello di credenziali (nel passaggio successivo) nel nuovo file.3. Dopo aver aggiunto le credenziali, seguire le istruzioni di salvataggio riportate di seguito.

Utenti Windows:

  1. Aprire il Blocco note.
  2. Incollare il modello di credenziali (nel passaggio successivo) nel nuovo file.
  3. Dopo aver aggiunto le credenziali, seguire le istruzioni di salvataggio riportate di seguito.

2. Aggiungere le credenziali di Tulip

Copiare e incollare quanto segue nel file .env, sostituendo i valori segnaposto con le credenziali effettive:

TULIP_API_KEY=tua_chiave_api_quiTULIP_API_SECRET=tua_api_secret_quiTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

  • TULIP_BASE_URL: È l'URL che si utilizza per accedere a Tulip.
    Esempio: https://my-company.tulip.co
  • TULIP_WORKSPACE_ID: si trova nell'URL di Tulip dopo /w/.
    Esempio: In https://my-company.tulip.co/w/DEFAULT, l'ID dello spazio di lavoro è DEFAULT.

:::(Attenzione) (Importante) Includere TULIP_WORKSPACE_ID solo se si utilizza una chiave API dell'account (da Impostazioni account).

Se si utilizza una chiave API dello spazio di lavoro (da Impostazioni spazio di lavoro), è possibile lasciare vuoto questo field.
:::
Salvare il file e assicurarsi che si trovi nella cartella specificata.

3. Eseguire il server

Una volta configurato il file .env, è possibile avviare il server.

Aprire il terminale o il prompt dei comandi, navigare nella cartella contenente il file .env ed eseguire il seguente comando:

bashnpx @tulip/mcp-serverIlcomando scaricherà l'ultima versione del server MCP Tulip e lo avvierà. Il server è ora in funzione e pronto per essere collegato a un client MCP.

4. Connettersi a Tulip MCP

Quando un client MCP esegue il server, potrebbe non trovarsi nella stessa directory del file .env, quindi non troverà automaticamente le credenziali. Per risolvere questo problema, è necessario fornire il percorso completo del file .env utilizzando il flag --env nella configurazione del client.

Guida: Trovare il percorso del file .env

  1. Navigare nella cartella in cui è stato creato il file .env.
  2. In Windows: Fare clic con il tasto destro del mouse sul file .env tenendo premuto il tasto Shift, quindi selezionare "Copia come percorso".
  3. Su macOS: Fare clic con il pulsante destro del mouse sul file .env, tenere premuto il tasto Opzione e selezionare "Copia .env come percorso".
  4. Il percorso copiato verrà utilizzato nella configurazione del client riportata di seguito.

Guida: Claude Desktop

  1. Dalla barra dei menu di Claude Desktop, selezionare Impostazioni... > Sviluppatore > Modifica configurazione.
  2. Si aprirà il file claude_desktop_config.json.
  3. Aggiungere la configurazione del server all'interno dell'oggetto mcpServers. È necessario sostituire "C:\path\to\your\.env" con il percorso effettivo copiato. json {" mcpServers": {"tulip-mcp": {"command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\path\to\your\\.env" ] } } }
  4. Salvare il file e riavviare Claude Desktop.

Per ulteriori dettagli, consultare il manuale ufficiale Claude Desktop MCP Quickstart.

Cursore

Per la configurazione più semplice, fare clic sul pulsante sottostante. Il comando verrà precompilato in Cursor.

Connettersi a Cursor

Dopo aver fatto clic sul pulsante, è necessario sostituire il testo segnaposto(REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) con il percorso completo del file .env copiato in precedenza.

Configurazione avanzata

Ottenere le credenziali API di Tulip

È possibile creare le credenziali API (Token) dalle impostazioni di Tulip instance.

  1. Accedere: Accedere al proprio sito Tulip instance.
  2. Andare su Token API: Andare su Impostazioni > Token API.
  3. Creare un nuovo token API: Generare un nuovo token, assegnandogli un nome descrittivo (ad esempio, "MCP Server").
  4. Configurare gli ambiti: Assegnare al token le autorizzazioni necessarie (scope). Un buon set iniziale di scope per l'accesso di base è: stations:read, users:read, tables:read, machines:read, apps:read, urls:sign.
  5. Copiare le credenziali: Copiare la chiave e il segreto API generati e incollarli nel file .env.

Configurazione della selezione degli strumenti

Per impostazione predefinita, per sicurezza, il server abilita solo gli strumenti di sola lettura e le tabelle. È possibile personalizzare gli strumenti disponibili utilizzando la variabile d'ambiente ENABLED_TOOLS nel file .env.

La variabile ENABLED_TOOLS accetta un elenco separato da virgole che può includere:

  • Nomi di strumenti individuali: Strumenti specifici come listStations.
  • Categorie: Raggruppamenti basati sulla sicurezza(sola lettura, scrittura, amministrazione).
  • Tipi: Raggruppamenti basati sulle risorse(tabella, macchina, utente, app, interfaccia, stazione, gruppo di stazioni, utilità).

Esempi:


# Abilita tutte le operazioni di lettura e scrittura

ENABLED\_TOOLS=solo lettura,scrittura

# Abilita tutti gli strumenti relativi a tabelle e stazioni

ENABLED\_TOOLS=tabella,stazione

# Abilitare strumenti specifici

ENABLED\_TOOLS=listStations,addRecord

# Un approccio misto consigliato

ENABLED\_TOOLS=solo lettura,interfaccia,stazione,utente

# Abilitazione di tutto (da usare con cautela, in quanto consente la cancellazione/archiviazione dei dati)

ENABLED\_TOOLS=solo lettura,scrittura,admin```

**Articoli correlati**

* [Configurare un'API Tulip](/r230/docs/set-up-a-tulip-api)