USAGE.md•5.01 kB
# Guía de Uso - MCP N8N Webhook Server
## Resumen
Este servidor MCP permite enviar datos estructurados a un webhook de n8n para almacenamiento e indexación. Es perfecto para guardar conversaciones, documentación y logs de desarrollo.
## Variables de Entorno
| Variable | Descripción | Valor por Defecto | Requerido |
|----------|-------------|-------------------|-----------|
| `N8N_WEBHOOK_URL` | URL base del webhook | `https://grec0-n8n.sytes.net/webhook-test` | No |
| `N8N_WEBHOOK_ID` | ID único del webhook | `f9c6e821-b9d5-4f80-9d82-bdca6255e48d` | No |
| `N8N_API_KEY` | Clave de API para autenticación | `lkmQ3Ppasi7oe7r8V66mks7K8uYL` | No |
| `N8N_INDEX_NAME` | Nombre del índice por defecto | `PROJECT_CONVERSATIONS` | No |
| `N8N_TABLE_CATEGORY` | Categoría de tabla por defecto | `DEVELOPMENT_LOGS` | No |
## Herramientas Disponibles
### 1. `n8n_save_data`
Guarda información estructurada en el webhook de n8n.
#### Parámetros
- **`projectName`** (requerido): Nombre del proyecto
- **`projectCategory`** (requerido): Categoría del proyecto (ej: AI_ML, WEB_DEV, DATA_SCIENCE)
- **`contentType`** (requerido): Tipo de contenido (CONVERSATION, DOCUMENTATION, CODE_REVIEW, MEETING_NOTES)
- **`title`** (requerido): Título del contenido
- **`description`** (requerido): Descripción breve del contenido
- **`text`** (requerido): Texto completo del contenido
- **`tags`** (requerido): Array de etiquetas para categorización
#### Parámetros Opcionales
- **`projectId`**: ID único del proyecto (se genera automáticamente si no se proporciona)
- **`projectStatus`**: Estado del proyecto (default: "ACTIVE")
- **`language`**: Idioma del contenido (default: "es")
- **`indexName`**: Nombre del índice (default: valor de `N8N_INDEX_NAME`)
- **`tableCategory`**: Categoría de tabla (default: valor de `N8N_TABLE_CATEGORY`)
- **`source`**: Fuente de los datos (default: "mcp_assistant")
#### Ejemplo de Uso
```json
{
"projectName": "Sistema de Embeddings",
"projectCategory": "AI_ML",
"contentType": "CONVERSATION",
"title": "Implementación de almacenamiento vectorial",
"description": "Discusión sobre la arquitectura para almacenar embeddings",
"text": "Se está implementando un sistema que permita almacenar fragmentos de información como embeddings para consultas posteriores...",
"tags": ["embeddings", "vectorial", "conversaciones", "historificacion"]
}
```
### 2. `n8n_health_check`
Verifica la conectividad y estado del webhook de n8n.
No requiere parámetros.
## Formato del Payload Enviado
```json
{
"metadata": {
"timestamp": "2025-07-02T10:30:00Z",
"source": "mcp_assistant",
"version": "1.0"
},
"project": {
"id": "proj_sistema_embeddings_1720872600000",
"name": "Sistema de Embeddings",
"category": "AI_ML",
"status": "ACTIVE"
},
"content": {
"type": "CONVERSATION",
"title": "Implementación de almacenamiento vectorial",
"description": "Discusión sobre la arquitectura para almacenar embeddings",
"text": "Se está implementando un sistema que permita almacenar fragmentos de información como embeddings para consultas posteriores. El sistema debe permitir indexación por proyecto y categoría.",
"tags": ["embeddings", "vectorial", "conversaciones", "historificacion"],
"language": "es"
},
"indexing": {
"index_name": "PROJECT_CONVERSATIONS",
"table_category": "DEVELOPMENT_LOGS"
}
}
```
## Configuración en Claude Desktop
Agrega esto a tu configuración de MCP:
```json
{
"mcpServers": {
"n8n-webhook": {
"command": "node",
"args": ["c:/workspaces/mcp_context/mcp-n8n-webhook/dist/index.js"],
"env": {
"N8N_WEBHOOK_URL": "https://grec0-n8n.sytes.net/webhook-test",
"N8N_WEBHOOK_ID": "f9c6e821-b9d5-4f80-9d82-bdca6255e48d",
"N8N_API_KEY": "lkmQ3Ppasi7oe7r8V66mks7K8uYL",
"N8N_INDEX_NAME": "PROJECT_CONVERSATIONS",
"N8N_TABLE_CATEGORY": "DEVELOPMENT_LOGS"
}
}
}
}
```
## Casos de Uso Comunes
1. **Guardar conversaciones de desarrollo**: Para almacenar discusiones técnicas importantes
2. **Documentar decisiones arquitectónicas**: Para mantener un registro de las decisiones del proyecto
3. **Logs de reuniones**: Para guardar notas y conclusiones de reuniones
4. **Fragmentos de código importantes**: Para indexar código relevante con contexto
5. **Ideas y brainstorming**: Para almacenar ideas generadas durante sesiones creativas
## Troubleshooting
### Error de conectividad
- Verificar que las variables de entorno estén configuradas correctamente
- Comprobar que el webhook de n8n esté activo y accesible
- Usar `n8n_health_check` para verificar el estado
### Errores de autenticación
- Verificar que `N8N_API_KEY` tenga el valor correcto
- Comprobar que el webhook acepta el método de autenticación usado
### Errores de formato
- Asegurarse de que todos los parámetros requeridos estén presentes
- Verificar que las etiquetas (`tags`) sean un array de strings