Configurar el Tulip MCP

¿Cómo se configura el Tulip MCP?

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

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

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

Requisitos previos

Antes de empezar, asegúrate de tener Node.js instalado en tu sistema. Es necesario para ejecutar el servidor.

Comprobación de la versión de npm y Node.js: ejecutalos siguientes comandos en tu terminal o en la Terminal de Windows (Símbolo del sistema, PowerShell):

node -vnpm -vSiaparece el nombre de la versión, ya estás listo y puedes continuar con el paso 1. Si no es así, ve a node.js e instala la última versión para tu sistema operativo.

Configurar las credenciales de la API de Tulip

Para conectarte a Tulip a través de la API, debes crear un archivo .env que almacene de forma segura tus credenciales de la API.

1. Crea una carpeta de configuración

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

Guía: Crear un archivo .env

Este archivo almacenará tus credenciales de Tulip. Aquí tienes un ejemplo de archivo .env.

Usuarios de Mac:

1. Abre el Terminal y ejecuta los siguientes comandos:

bashtouch .envnano .env2. Pega la plantilla de credenciales (del siguiente paso) en el nuevo archivo.3. Tras añadir tus credenciales, sigue las instrucciones de guardado que se indican a continuación.

Usuarios de Windows:

1. Abre el Bloc de notas.
2. Pega la plantilla de credenciales (del siguiente paso) en el nuevo archivo.
3. Una vez añadidas tus credenciales, sigue las instrucciones de guardado que se indican a continuación.

2. Añade tus credenciales de Tulip

Copia y pega lo siguiente en el archivo .env, sustituyendo los valores de los marcadores 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=tu_id_de_espacio_de_trabajo_aquí_si_utilizas_una_clave_API_de_cuenta

• 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)
Incluye TULIP_WORKSPACE_ID únicamente si utilizas una clave API de la cuenta (de la configuración de la cuenta).

Si utilizas una clave API del espacio de trabajo (de la configuración del espacio de trabajo), puedes dejar este campo « field » en blanco.
:::
Guarda el archivo y asegúrate de que se encuentra en la carpeta que has especificado.

3. Ejecuta el servidor

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

Abre tu terminal o la línea de comandos, navega hasta la carpeta que contiene tu archivo .env y ejecuta el siguiente comando:

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

4. Conéctate a Tulip MCP

Cuando un cliente MCP ejecuta el servidor, es posible que este no se encuentre en el mismo directorio que tu archivo .env, por lo que no encontrará las credenciales automáticamente. Para solucionar esto, debes indicar 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 tu archivo .env

1. Ve a la carpeta donde creaste tu archivo .env.
2. En Windows: haz clic con el botón derecho del ratón sobre el archivo .env mientras mantienes pulsada la tecla Mayús y, a continuación, selecciona «Copiar como ruta».
3. En macOS: haz clic con el botón derecho del ratón sobre el archivo .env, mantén pulsada la tecla Opción y, a continuación, selecciona «Copiar .env como ruta».
4. Utilizarás esta ruta copiada en la configuración del cliente que se indica a continuación.

Guía: Claude Desktop

1. En la barra de menús de Claude Desktop, selecciona Ajustes... > Desarrollador > Editar configuración.
2. Esto abrirá el archivo claude_desktop_config.json.
3. Añade la configuración del servidor dentro del objeto mcpServers. Debes sustituir «C:\\path\\to\\your\\.env» por la ruta real que hayas copiado. json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\ruta\\a\\tu\\.env" ] } } }
4. Guarda el archivo y reinicia Claude Desktop.

Para obtener más detalles, consulta la guía oficial de inicio rápido de Claude Desktop MCP.

Cursor

Para una configuración más sencilla, haz clic en el botón de abajo. Esto rellenará automáticamente el comando en Cursor.

Conéctate a Cursor

Tras hacer clic en el botón, debes sustituir el texto de marcador de posición (REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) por la ruta completa a tu archivo .env que copiaste anteriormente.

Configuración avanzada

Obtener credenciales de la API de Tulip

Puedes crear credenciales de la API (cuentas de servicio) desde la configuración de Tulip instance.

1. Inicia sesión: Accede a tu Tulip instance.
2. Accede a la API de Tulip: Ve a Configuración > API de Tulip.
3. Crear una nueva cuenta de servicio: Genera una nueva cuenta de servicio y asígnale un nombre descriptivo (por ejemplo, «Servidor MCP»).
4. Configurar ámbitos: Otorga a la cuenta de servicio 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. Copia las credenciales: copia la clave API y el secreto generados y pégalos en tu archivo .env.

Configuración de la selección de herramientas

Por defecto, por motivos de seguridad, el servidor solo habilita las herramientas de solo lectura y las de tablas. Puedes personalizar qué herramientas están disponibles utilizando la variable de entorno ENABLED_TOOLS en tu archivo .env.

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

• Nombres de herramientas individuales: herramientas específicas como listStations.
• Categorías: agrupaciones basadas en la seguridad (solo lectura, escritura, administrador).
• Tipos: agrupaciones basadas en recursos (tabla, máquina, usuario, aplicación, interfaz, estación, grupo de estaciones, utilidad).

Ejemplos:

# Habilitar todas las operaciones de lectura y escritura

ENABLED\_TOOLS=solo lectura,escritura

# Habilitar todas las herramientas relacionadas con tablas y estaciones

ENABLED\_TOOLS=table,station

# Habilitar herramientas específicas

ENABLED\_TOOLS=listStations,addRecord

# Un enfoque mixto recomendado

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

# Habilitar todo (utilizar con precaución, ya que esto permite la eliminación o el archivado de datos)

ENABLED\_TOOLS=solo lectura,escritura,admin```

**Artículos relacionados**

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