Tulip MCP Server

Un servidor MCP para la API de Tulip, que permite a los LLMs interactuar con las tablas, registros, máquinas y más de la plataforma de fabricación Tulip.

GitHub
5
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Tulip

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso integral a la API de Tulip, permitiendo que los LLM interactúen con la funcionalidad de la plataforma de manufactura de Tulip, incluyendo tablas, registros, máquinas, estaciones, interfaces, usuarios, y más.

✨ Requisitos previos

Antes de comenzar, asegúrate de tener Node.js instalado en tu sistema. Esto es necesario para ejecutar el servidor.

🚀 Primeros pasos

Esta guía te llevará a través de la ejecución del servidor y su conexión a un cliente MCP como Cursor o Claude Desktop.

1. Configura tus credenciales

Crea un archivo llamado .env en una carpeta de tu elección. Copia y pega lo siguiente, reemplazando los marcadores de posición con tus credenciales reales de Tulip.

  • Tu TULIP_BASE_URL es la URL que usas para acceder a Tulip (por ejemplo, https://my-company.tulip.co).
  • Tu TULIP_WORKSPACE_ID está en tu URL de Tulip después de /w/ (para la mayoría de los usuarios, esto es DEFAULT).
TULIP_API_KEY=your_api_key_here
TULIP_API_SECRET=your_api_secret_here
TULIP_BASE_URL=https://your-instance.tulip.co
TULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

⚠️ Importante: El TULIP_WORKSPACE_ID solo es necesario si estás usando una clave de API de Cuenta (obtenida desde Configuración de Cuenta). Si estás usando una clave de API de Espacio de Trabajo (obtenida desde Configuración de Espacio de Trabajo), puedes dejar este campo vacío.

2. Ejecuta el servidor

Abre tu terminal o símbolo del sistema, navega a la carpeta que contiene tu archivo .env y ejecuta:

npx @tulip/mcp-server

El servidor se iniciará y estará listo para conectarse a un cliente MCP.

🔌 Conexión a un cliente MCP

Al usar un cliente, el servidor se ejecuta en un entorno diferente donde puede que no encuentre tu archivo .env automáticamente. Para resolver esto, debes proporcionar la ruta completa a tu archivo .env usando la bandera --env.

Guía: Cómo encontrar la ruta de tu archivo .env
  1. Navega a la carpeta donde creaste tu archivo .env.
  2. En Windows: Haz clic derecho en el archivo .env mientras mantienes presionada la tecla Shift, luego selecciona "Copiar como ruta".
  3. En macOS: Haz clic derecho en el archivo .env, mantén presionada la tecla Option, luego selecciona "Copiar .env como nombre de ruta".
  4. Usarás esta ruta copiada en la configuración del cliente a continuación.
Guía: Claude Desktop
  1. Desde la barra de menú de Claude Desktop, selecciona Configuración... > Desarrollador > Editar configuración.
  2. Esto abrirá el archivo claude_desktop_config.json.
  3. Agrega la configuración del servidor dentro del objeto mcpServers. Debes reemplazar "C:\\path\\to\\your\\.env" con la ruta real que copiaste. 
    {
  "mcpServers": {
    "tulip-mcp": {
      "command": "npx",
      "args": [
        "@tulip/mcp-server",
        "--env",
        "C:\\path\\to\\your\\.env"
      ]
    }
  }
}
  4. Guarda el archivo y reinicia Claude Desktop.

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

Guía: Cursor

Para la configuración más fácil, haz clic en el botón a continuación. Esto precompletará el comando.

Install MCP Server

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

Plugin de Claude Code

Si usas Claude Code, puedes instalar el servidor como un plugin. Esto agrega las herramientas MCP y un conjunto de habilidades guiadas para flujos de trabajo comunes.

claude plugin marketplace add tulip/tulip-mcp
claude plugin install tulip@tulip-marketplace

Después de instalar, ejecuta la habilidad setup-credentials para colocar tu archivo .env en el directorio de datos persistentes del plugin. El plugin se encarga del resto.

Por defecto, el servidor expone solo las herramientas read-only (30 de las 71). Para usar las herramientas de escritura y administración, establece ENABLED_TOOLS en ese mismo archivo .env — por ejemplo ENABLED_TOOLS=read-only,write — y recarga el plugin. Consulta Configuración de selección de herramientas para todas las opciones.

El plugin lanza el servidor a través de npx @tulip/mcp-server, por lo que no hay nada adicional que instalar. Las credenciales se almacenan fuera del directorio del plugin y sobreviven a las actualizaciones.

Guía para desarrolladores

Esta sección contiene características de configuración más avanzadas.

Configuración de selección de herramientas

Por defecto, el servidor habilita solo las herramientas read-only por seguridad. Puedes personalizar qué herramientas están disponibles usando la variable de entorno ENABLED_TOOLS en tu 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 (read-only, write, admin)
  • Tipos: Agrupaciones basadas en recursos (table, machine, user, app, interface, station, station-group, utility)

Ejemplos

# Enable specific tools only
ENABLED_TOOLS=listTables,getTable,listStations,listInterfaces

# Enable by security category
ENABLED_TOOLS=read-only,write

# Enable by resource type
ENABLED_TOOLS=table,station,interface

# Mixed approach (recommended)
ENABLED_TOOLS=read-only,interface,station,user

# Enable everything (use with caution)
ENABLED_TOOLS=read-only,write,admin

Configuración de múltiples espacios de trabajo (Empresarial)

Si tu organización usa múltiples espacios de trabajo o instancias de Tulip, puedes configurar múltiples servidores MCP para acceder a todos ellos simultáneamente. Esto te permite trabajar con datos de todos tus espacios de trabajo en una sola conversación.

Comprendiendo tus credenciales de API

Antes de comenzar, verifica qué tipo de credenciales de API tienes:

  • Credenciales de API de Espacio de Trabajo: Creadas en Configuración del Espacio de Trabajo → Tokens de API

    • ✅ Ya saben a qué espacio de trabajo pertenecen
    • ✅ NO incluyas TULIP_WORKSPACE_ID en tu archivo .env
    • ✅ Tipo más común para espacios de trabajo individuales

  • Credenciales de API de Cuenta: Creadas en Configuración de Cuenta → Tokens de API

    • ⚠️ Pueden acceder a múltiples espacios de trabajo
    • ⚠️ Debes incluir TULIP_WORKSPACE_ID en tu archivo .env

¿No estás seguro de qué tipo tienes? Verifica dónde creaste tu token de API. Si lo creaste en Configuración del Espacio de Trabajo, tienes credenciales de API de Espacio de Trabajo.

Configuración paso a paso

Paso 1: Crea archivos .env separados para cada espacio de trabajo

Sigue el mismo proceso de la Sección 1: Configura tus credenciales, pero crea archivos separados:

production-workspace.env
development-workspace.env

Paso 2: Configura cada archivo .env

Para cada espacio de trabajo, crea un archivo .env con las credenciales apropiadas:

Si usas Credenciales de API de Espacio de Trabajo:

# production-workspace.env
TULIP_API_KEY=your_production_workspace_api_key
TULIP_API_SECRET=your_production_workspace_secret
TULIP_BASE_URL=https://your-instance.tulip.co
ENABLED_TOOLS=read-only,table,station

Si usas Credenciales de API de Cuenta:

# production-workspace.env
TULIP_API_KEY=your_account_api_key
TULIP_API_SECRET=your_account_secret
TULIP_BASE_URL=https://your-instance.tulip.co
TULIP_WORKSPACE_ID=PRODUCTION_WORKSPACE_ID
ENABLED_TOOLS=read-only,table,station

Paso 3: Conecta múltiples servidores a tu cliente MCP

Agrega cada espacio de trabajo como un servidor separado con un nombre único usando las guías de la Sección: Conexión a un cliente MCP:

Para Claude Desktop:

{
  "mcpServers": {
    "tulip-production": {
      "command": "npx",
      "args": ["@tulip/mcp-server", "--env", "/full/path/to/production-workspace.env"]
    },
    "tulip-qa": {
      "command": "npx", 
      "args": ["@tulip/mcp-server", "--env", "/full/path/to/qa-workspace.env"]
    }
  }
}

Para Cursor: Usa el botón de instalación múltiples veces, una vez por cada archivo .env.

Consejos para el éxito

  • Usa nombres de servidor claros como tulip-production, tulip-qa, tulip-development
  • Prueba cada espacio de trabajo por separado primero para asegurarte de que las credenciales funcionen
  • Solo habilita las herramientas que necesitas. Habilitar demasiadas herramientas (40+) puede confundir a la IA.

Documentación de la API

Para documentación detallada de herramientas, incluyendo listas completas de parámetros, ejemplos y permisos requeridos, genera el archivo TOOLS.md ejecutando npm run docs.

Cómo obtener credenciales de API de Tulip

  1. Inicia sesión en tu instancia de Tulip.
  2. Navega a Configuración > Tokens de API.
  3. Crea un nuevo token de API. Asígnale un nombre (por ejemplo, "Servidor MCP").
  4. Asegúrate de otorgarle los permisos necesarios (alcances). Un buen conjunto inicial para acceso de solo lectura es: stations:read,users:read,tables:read,machines:read,apps:read,urls:sign
  5. Copia la Clave de API y el Secreto y pégalos en tu archivo .env.

⚠️ Importante: El TULIP_WORKSPACE_ID solo es necesario si estás usando una clave de API de Cuenta (obtenida desde Configuración de Cuenta). Si estás usando una clave de API de Espacio de Trabajo (obtenida desde Configuración de Espacio de Trabajo), puedes dejar este campo vacío.