Automatisch MCP Server

Conecta asistentes de IA a Automatisch para la automatización de flujos de trabajo.

Documentación

Automatisch MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona a los asistentes de IA acceso a las capacidades de automatización de flujos de trabajo de Automatisch.

Descripción general

Este servidor MCP permite a los asistentes de IA interactuar con Automatisch, una alternativa de código abierto a Zapier para la automatización de flujos de trabajo. Proporciona herramientas para gestionar flujos de trabajo, conexiones, ejecuciones e integraciones de aplicaciones.

Características

Herramientas disponibles

Gestión de flujos de trabajo: Crear, leer, actualizar, eliminar y probar flujos de trabajo
Gestión de conexiones: Gestionar conexiones de aplicaciones y credenciales
Monitoreo de ejecuciones: Ver el historial y el estado de las ejecuciones de flujos de trabajo
Descubrimiento de aplicaciones: Explorar las aplicaciones disponibles y sus capacidades
Pruebas: Probar flujos de trabajo con datos de muestra

Recursos proporcionados

Resumen de flujos de trabajo con estado general
Listado de conexiones de aplicaciones
Catálogo de aplicaciones disponibles
Registro de ejecuciones recientes

Requisitos previos

Node.js 18+
Instancia de Automatisch en ejecución
Acceso a la API de Automatisch (se recomienda clave de API)

Instalación

Clona o descarga el código del servidor MCP
Instala las dependencias:
```
npm install
```
Compila el proyecto:
```
npm run build
```

Configuración

Establece las variables de entorno:

# Automatisch instance URL (default: http://localhost:3001)
export AUTOMATISCH_BASE_URL="http://your-automatisch-instance:3001"

# API key for authentication (optional but recommended)
export AUTOMATISCH_API_KEY="your-api-key"

Uso

Integración con Claude Desktop

Añade a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "automatisch": {
      "command": "npx",
      "args": ["-y", "automatisch-mcp-server"],
      "env": {
        "AUTOMATISCH_BASE_URL": "http://localhost:3001",
        "AUTOMATISCH_API_KEY": "your-api-key"
      }
    }
  }
}

Uso independiente

npm start

Herramientas disponibles

Gestión de flujos de trabajo

list_workflows - Lista todos los flujos de trabajo con filtrado opcional
get_workflow - Obtiene información detallada del flujo de trabajo
create_workflow - Crea un nuevo flujo de trabajo
update_workflow - Actualiza un flujo de trabajo existente
delete_workflow - Elimina un flujo de trabajo
test_workflow - Prueba el flujo de trabajo con datos de muestra

Gestión de conexiones

list_connections - Lista las conexiones de aplicaciones
create_connection - Crea una nueva conexión de aplicación

Monitoreo y descubrimiento

list_executions - Ver el historial de ejecuciones de flujos de trabajo
get_available_apps - Explorar las aplicaciones e integraciones disponibles

Ejemplo de uso con asistente de IA

# List all active workflows
"Show me all active workflows"

# Create a new workflow
"Create a workflow named 'Email Notifications' that sends emails when new GitHub issues are created"

# Check recent executions
"Show me the recent workflow executions and their status"

# Get workflow details
"Tell me about the workflow with ID 'abc123'"

# List available apps
"What apps are available for integration?"

Endpoints de API

El servidor interactúa con estos endpoints de la API de Automatisch:

GET /api/flows - Lista flujos de trabajo
POST /api/flows - Crea un flujo de trabajo
PATCH /api/flows/:id - Actualiza un flujo de trabajo
DELETE /api/flows/:id - Elimina un flujo de trabajo
GET /api/connections - Lista conexiones
POST /api/connections - Crea una conexión
GET /api/executions - Lista ejecuciones
GET /api/apps - Lista las aplicaciones disponibles

Desarrollo

Ejecución en modo de desarrollo

npm run dev

Compilación

npm run build

Limpieza de archivos de compilación

npm run clean

Manejo de errores

El servidor incluye un manejo integral de errores:

Problemas de conectividad de red con Automatisch
Respuestas de API no válidas
Parámetros obligatorios faltantes
Fallos de autenticación

Los errores se registran y se devuelven como respuestas estructuradas al asistente de IA.

Consideraciones de seguridad

Usa claves de API para la autenticación cuando estén disponibles
Asegúrate de que la instancia de Automatisch esté debidamente protegida
Limita el acceso de red a fuentes de confianza
Actualiza las dependencias con regularidad

Solución de problemas

Problemas comunes

Conexión fallida: Verifica que AUTOMATISCH_BASE_URL sea correcto y accesible
Error de autenticación: Comprueba que AUTOMATISCH_API_KEY sea válido
Herramienta no encontrada: Asegúrate de que el servidor MCP esté correctamente registrado con Claude Desktop
Errores de API: Revisa los registros de Automatisch para obtener información detallada de errores

Modo de depuración

Habilita el registro de depuración estableciendo:

export NODE_ENV=development

Contribuciones

Haz un fork del repositorio
Crea una rama de características
Realiza tus cambios
Añade pruebas si corresponde
Envía una solicitud de extracción (pull request)

Licencia

Este proyecto está licenciado bajo la Licencia MIT.

Proyectos relacionados

Automatisch - Automatización de flujos de trabajo de código abierto
Model Context Protocol - Especificación del protocolo
MCP SDK - SDK de TypeScript

Soporte

Para problemas relacionados con:

Problemas específicos de la integración del servidor MCP o de este repositorio: Abre un problema aquí
Automatisch: Visita Problemas de GitHub de Automatisch
Protocolo MCP: Consulta la Documentación de MCP