Skip to main content
Glama
deenesjakoruzh
vidal-renao

vidal-helpdesk-mcp

by vidal-renao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

🇨🇭 Vidal Helpdesk MCP-Server

KI-gestützte SaaS-Infrastruktur auf Unternehmensniveau für Schweizer KMU Model Context Protocol (MCP)-Implementierung für autonome Ticket-Orchestrierung, entwickelt mit Supabase und Anthropic Claude AI unter Einhaltung der Schweizer revDSG-Standards.

Version TypeScript Supabase Compliance Architecture

1. Zusammenfassung

vidal-helpdesk ist eine KI-native Infrastruktur auf Produktionsniveau, die darauf ausgelegt ist, den technischen Support in einen autonomen Betrieb zu verwandeln. Dieser Server ermöglicht es Claude Desktop, als Support-Orchestrator zu fungieren und den Lebenszyklus von Vorfällen direkt in natürlicher Sprache zu verwalten.

Das System wurde für Unternehmen entwickelt, die absolute Datensouveränität benötigen. Es nutzt den lokalen stdio-Transport und eine Persistenzschicht in Supabase (vorzugsweise in Schweizer Regionen wie Zürich), um sicherzustellen, dass die Datenebene unter der Kontrolle des Betreibers bleibt.

Geschäftswert:

  • MTTR (Mean Time To Repair): Drastische Reduzierung durch automatische Triage und sofortige Lösungsvorschläge.

  • Datenlokalität: Native Einhaltung des Bundesgesetzes über den Datenschutz (revDSG).

  • Konversationelle BI: Fähigkeit, Metriken zur Infrastrukturgesundheit mittels natürlicher Sprache abzufragen.

Related MCP server: Supabase MCP Server

2. Systemarchitektur

Der Server implementiert ein Clean Architecture-Muster, das das Transportprotokoll von der Geschäftslogik und der Datenebene isoliert.

┌──────────────────────────┐          JSON-RPC          ┌──────────────────────────┐
│     Claude Desktop       │   ◄────────────────────►   │    Vidal MCP Server      │
│      (MCP Client)        │           stdio            │      (Node.ts 20)        │
└──────────────────────────┘                            └────────────┬─────────────┘
                                                                     │ service_role
                                                                     ▼
                                       ┌───────────────────────────────────────────┐
                                       │         Supabase Postgres Cluster         │
                                       │   (Isolated Schema: 'helpdesk' + RLS)     │
                                       └──────────────┬────────────────────┬───────┘
                                                      │                    │
                                       ┌──────────────┴──────┐      ┌──────┴───────┐
                                       │  Anthropic API      │      │  Audit Log   │
                                       │  (Triage & NLU)     │      │  (Traceable) │
                                       └─────────────────────┘      └──────────────┘

                                       


                                       3. Tool Inventory (Enterprise v1.2.1)ToolCapabilityAccessLogiccreate_ticketAI-Driven TriageWriteClasificación P1-P4 + SLA Calculation.list_ticketsContext AwarenessReadFiltrado avanzado sobre esquema aislado.get_ticket_statusSLA MonitoringReadEvaluación de Breaches en tiempo real.prioritize_incidentRecursive ReasoningWriteAjuste dinámico de criticidad según contexto.suggest_solutionResolution EngineReadSugerencias multilingües (ES/DE/EN).count_ticketsOperational BIReadAgregación de datos y analítica de carga.generate_reportExecutive AuditReadHealth Score de infraestructura y métricas SLA.


                                       4. Engineering Battle — Real Deployment Lessons (Windows)
Documentación de fricciones técnicas resueltas durante el despliegue en entornos Windows 11:

4.1 Claude Sandbox (Microsoft Store)
La versión MSIX corre en un AppContainer. La configuración debe residir en:
%LOCALAPPDATA%\Packages\Anthropic.ClaudeForWindows_...\LocalCache\Roaming\Claude\claude_desktop_config.json

4.2 JSON Path Escaping
Los paths en el config deben usar doble backslash (\\) o forward slash (/) según RFC 8259 para evitar errores de parseo:
"args": ["C:/Users/Vidal/Projects/vidal-helpdesk/dist/index.js"]

4.3 Gestión de Procesos Huérfanos
Al cerrar la ventana, Claude permanece en el tray y mantiene el proceso node vivo. Para aplicar cambios de código, es imperativo matar el proceso manualmente:
Stop-Process -Name "node" -Force

5. Compliance Notes (revDSG / Swiss)
Data Residency: Todo el contenido reside en Supabase. Se recomienda la región eu-central-2 (Zúrich).

AI Disclosure: Las herramientas de IA deben declararse en el aviso de privacidad como "procesamiento automatizado mediante Anthropic".

Audit Trail: Las columnas created_at / updated_at junto con el ai_summary garantizan la trazabilidad exigida por el principio de transparencia.

6. License & Contact
Proprietary — © 2026 Vidal Reñao Lopelo.
Fullstack Developer | AI-Powered SaaS Infrastructure Specialist
Basel, Switzerland · vidal-pro-portfolio.vercel.app

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers