Servidor MCP de Workato. ¡Bienvenido a tu kit de herramientas de integración con la API de Workato, diseñado como un servidor de Protocolo de Contexto de Modelo (MCP) para Cursor o Claude! Este proyecto proporciona una interacción fluida con la API de Workato mediante herramientas de IA personalizadas.

✨ Características 🔄 Gestión de recetas

Enumerar, crear, iniciar y detener recetas
Supervisar trabajos de ejecución de recetas
Administrar carpetas de recetas y proyectos

🔌 Gestión de conexiones

Enumerar y crear conexiones
Ver detalles y estado de la conexión
Administrar configuraciones de conexión

🔍 Descubrimiento de conectores

Enumere los conectores disponibles y sus capacidades
Ver metadatos del conector y operaciones admitidas
Explorar todos los conectores de plataforma

📂 Organización de carpetas y proyectos

Crear y administrar carpetas
Organizar recetas y conexiones
Manejar configuraciones a nivel de proyecto

📊 Registros de actividad

Realice un seguimiento de todas las actividades dentro de su espacio de trabajo
Filtrar registros por rango de tiempo, usuarios y tipos de eventos
Supervisar los cambios de recursos y las acciones de los usuarios
Soporte para múltiples entornos (desarrollo, sandbox, producción, etc.)
Filtrado avanzado por tipos de recursos y eventos

🔖 Gestión de etiquetas

Crear, actualizar y eliminar etiquetas en su espacio de trabajo
Enumere y recupere las etiquetas disponibles con opciones de filtrado avanzadas
Aplicar o eliminar etiquetas de activos (recetas y conexiones)
Admite operaciones por lotes para múltiples activos y etiquetas
Filtrar etiquetas por título, descripción, autor y uso
Ordenar las etiquetas según varios criterios (título, número de uso, etc.)
Personalice la apariencia de la etiqueta con opciones de color

🚀 Primeros pasos 2. Instalación

npm install
# or
yarn install

Construir el servidor

npm run build

Añadir a Cursor. Este proyecto está diseñado para usarse como servidor MCP en Cursor. Aquí te explicamos cómo configurarlo:
Cursor abierto
Vaya a Configuración del cursor > Funciones > MCP
Haga clic en + Agregar nuevo servidor MCP
Rellene el formulario:
- Nombre: Servidor Workato MCP
- Tipo: stdio
- Comando: nodo /ruta/a/su/proyecto/dist/server.js
- Variables de entorno:
  - Haga clic en "Agregar variable de entorno"
  - Nombre: WORKATO_API_TOKEN
  - Valor: your_token_here

📘 Consejo profesional: utiliza la ruta completa al archivo server.js creado en tu proyecto.

Configuración alternativa: también puede configurar el servidor MCP usando un archivo .cursor/mcp.json en su proyecto:

{
  "mcpServers": {
    "workato-tools": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "WORKATO_API_TOKEN": "your_token_here"
      }
    }
  }
}

Uso con Claude Desktop: si utiliza Claude Desktop en lugar de Cursor, puede configurar el servidor MCP editando la configuración de Claude Desktop:

Abra o cree el archivo de configuración:

# On macOS
~/Library/Application Support/Claude/claude_desktop_config.json
# On Windows
%APPDATA%\Claude\claude_desktop_config.json
# On Linux
~/.config/Claude/claude_desktop_config.json

Agregue la configuración de su servidor MCP:

{
  "mcp_servers": {
    "workato-tools": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "WORKATO_API_TOKEN": "your_token_here"
      }
    }
  }
}

Guarde el archivo y reinicie Claude Desktop para que los cambios surtan efecto.

Este método le permite:

Control de versiones de su configuración de MCP
Incluir variables de entorno directamente en la configuración
Compartir la misma configuración entre los miembros del equipo (excluyendo valores confidenciales)
Cargar automáticamente el servidor al abrir el proyecto en Cursor

🛠️ Herramientas disponibles

Gestión de recetas:

list-recipes: Lista todas las recetas con opciones de filtrado
create-recipe: Crea una nueva receta
start-recipe: Iniciar una receta específica
stop-recipe: Detener una receta en ejecución

Gestión de conexión:

list-connections: Lista todas las conexiones
create-connection: Crea una nueva conexión

Herramientas de conector:

list-connectors: Obtener metadatos para conectores específicos
list-all-connectors: enumera todos los conectores disponibles

Herramientas de organización:

list-folders: Lista todas las carpetas
create-folder: Crea una nueva carpeta
update-folder: Modificar las propiedades de la carpeta
list-projects: Lista todos los proyectos
update-project: Actualizar los detalles del proyecto

Gestión de API:

list-api-endpoints: enumera todos los puntos finales de API con filtrado opcional por colección

Monitoreo de actividad:

list-activity-logs: recupera registros de actividad detallados con opciones de filtrado avanzadas
- Filtrar por rango de tiempo, usuarios y tipos de eventos
- Incluir o excluir tipos de recursos específicos
- Seguimiento de cambios en diferentes entornos
- Supervisar las acciones del usuario y los eventos del sistema

Gestión de etiquetas:

list-tags: Enumere y filtre las etiquetas disponibles en su espacio de trabajo con opciones de consulta avanzadas
create-tag: crea una nueva etiqueta con título, descripción y color personalizados
update-tag: Modificar las propiedades de una etiqueta existente
delete-tag: elimina una etiqueta de tu espacio de trabajo
Manage-tags: Aplicar o eliminar etiquetas de recetas y conexiones

Gestión de trabajos: