Configurar Tulip MCP

Nuevo
  • Publicado el Aug 7, 2025
  • 4 minuto(s) leído(s)
  • Pete Hartnett
 Prev Next

¿Cómo se configura Tulip MCP?

La documentación detallada de configuración para el Tulip MCP está disponible en el repositorio oficial: https://github.com/tulip/tulip-mcp/tree/master

La configuración de Tulip MCP se ha simplificado. El nuevo proceso implica tres pasos clave:

  1. Configurar tus credenciales
  2. Ejecutar el servidor
  3. Conectarse a un cliente MCP

Requisitos previos

Antes de empezar, asegúrese de que tiene Node.js instalado en su sistema. Esto es necesario para ejecutar el servidor.

Comprobando tu versión de npm y Node.jsEjecutalos siguientes comandos en tu terminal/Windows Terminal (Command Prompt, PowerShell):

node -vnpm -vSiobtienes un nombre de versión entonces estás listo, y puedes continuar con el paso 1.Si no, dirígete a node.js e instala la última versión para tu sistema operativo.

Configura tus credenciales API de Tulip

Para conectarte a Tulip vía API, necesitas crear un archivo .env que almacene de forma segura tus credenciales API.

1. Crear una carpeta de configuración

Elige o crea una carpeta donde quieras almacenar tu archivo de configuración de entorno.

Guía: Crear un archivo .env

Este archivo almacenará sus credenciales de Tulip. Un ejemplo de archivo . env está disponible aquí.

Usuarios de Mac:

  1. Abre Terminal y ejecuta los siguientes comandos

bashtouch .envnano .env2. Pega la plantilla de credenciales (en el siguiente paso) en el nuevo archivo.3. Después de añadir tus credenciales, sigue las instrucciones para guardar que aparecen a continuación.

Usuarios de Windows:

  1. Abra el Bloc de notas.
  2. Pegue la plantilla de credenciales (en el paso siguiente) en el nuevo archivo.
  3. Después de añadir sus credenciales, siga las instrucciones de guardado que aparecen a continuación.

2. Añada sus credenciales Tulip

Copia y pega lo siguiente en el archivo .env, sustituyendo los valores del marcador de posición por tus credenciales reales:

TULIP_API_KEY=tu_clave_api_aquíTULIP_API_SECRET=tu_secreto_api_aquíTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

  • TULIP_BASE_URL: Esta es la URL que utilizas para acceder a Tulip.
    Ejemplo: https://my-company.tulip.co
  • TULIP_WORKSPACE_ID: Se encuentra en tu URL de Tulip después de /w/.
    Ejemplo: En https://my-company.tulip.co/w/DEFAULT, el ID del espacio de trabajo es DEFAULT.

:::(Advertencia) (Importante) Sólo incluye TULIP_WORKSPACE_ID si estás utilizando una Clave API de Cuenta (desde Configuración de Cuenta).

Si utiliza una clave de API de espacio de trabajo (desde Configuración del espacio de trabajo), puede dejar este field en blanco.
:::
Guarde su archivo, y asegúrese de que el archivo se encuentra en la carpeta que ha especificado.

3. Ejecutar el servidor

Una vez configurado el archivo .env, puede iniciar el servidor.

Abra su terminal o símbolo del sistema, navegue hasta la carpeta que contiene su archivo .env y ejecute el siguiente comando:

bashnpx @tulip/mcp-serverElcomando descargará la última versión del servidor Tulip MCP y lo iniciará. El servidor ya está funcionando y listo para conectarse a un cliente MCP.

4. Conectarse al Tulip MCP

Cuando un cliente MCP ejecuta el servidor, puede que no esté en el mismo directorio que tu archivo .env, por lo que no encontrará las credenciales automáticamente. Para solucionarlo, debes proporcionar la ruta completa a tu archivo .env utilizando el indicador --env en la configuración del cliente.

Guía: Cómo encontrar la ruta de su archivo .env

  1. Navegue hasta la carpeta donde creó su archivo .env.
  2. En Windows: Haga clic con el botón derecho en el archivo . env mientras mantiene pulsada la tecla Mayús y, a continuación, seleccione "Copiar como ruta".
  3. En macOS: Haga clic con el botón derecho en el archivo . env, mantenga pulsada la tecla Opción y seleccione "Copiar .env como ruta".
  4. Esta ruta copiada se utilizará en la configuración del cliente.

Guía: Claude Desktop

  1. En la barra de menú de Claude Desktop, seleccione Configuración... > Desarrollador > Editar configuración.
  2. Esto abrirá el archivo claude_desktop_config.json.
  3. Añada la configuración del servidor dentro del objeto mcpServers. Debes reemplazar "C:\path\\to\your\.env" por la ruta real que copiaste. json { " mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\path\\to\your\\.env" ] } } }
  4. Guarde el archivo y reinicie Claude Desktop.

Para más detalles, consulte la guía oficial Claude Desktop MCP Quickstart.

Cursor

Para la configuración más fácil, haga clic en el botón de abajo. Esto pre-llenará el comando en Cursor.

Conectarse a Cursor

Después de hacer clic en el botón, debe reemplazar el texto del marcador de posición(REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) con la ruta completa a su archivo .env que copió anteriormente.

Configuración avanzada

Obtención de credenciales de la API de Tulip

Puedes crear credenciales API (Tokens) desde tu configuración en Tulip instance.

  1. Inicia sesión: Accede a tu Tulip instance.
  2. Navega hasta API Tokens: Vaya a Configuración > Tokens de API.
  3. Cree un nuevo token de API: Genere un nuevo token, dándole un nombre descriptivo (por ejemplo, "Servidor MCP").
  4. Configure los ámbitos: Conceda al token los permisos necesarios (ámbitos). Un buen conjunto inicial de ámbitos para el acceso básico es: stations:read, users:read, tables:read, machines:read, apps:read, urls:sign
  5. Copie las credenciales: Copie la Clave API y el Secreto generados y péguelos en su archivo .env.

Configuración de la selección de herramientas

Por defecto, por seguridad, el servidor sólo habilita las herramientas de sólo lectura y de tablas. Puede personalizar qué herramientas están disponibles utilizando la variable de entorno ENABLED_TOOLS en su archivo .env.

La variable ENABLED_TOOLS acepta una lista separada por comas que puede incluir:

  • Nombres de herramientas individuales: Herramientas específicas como listStations.
  • Categorías: Agrupaciones basadas en seguridad(sólo lectura, escritura, admin).
  • Tipos: Agrupaciones basadas en recursos(tabla, máquina, usuario, app, interfaz, estación, grupo de estaciones, utilidad).

Ejemplos:


# Habilitar todas las operaciones de lectura y escritura

ENABLED\_TOOLS=sólo lectura,escritura

# Habilitar todas las herramientas relacionadas con tablas y estaciones

ENABLED\_TOOLS=tabla,estación

# Habilitar herramientas específicas

ENABLED\_TOOLS=listStations,addRecord

# Un enfoque mixto recomendado

ENABLED\_TOOLS=sólo lectura,interfaz,estación,usuario

# Habilitar todo (utilícelo con precaución, ya que permite borrar/archivar datos)

ENABLED\_TOOLS=sólo lectura,escritura,admin```

**Artículos relacionados**

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