Skip to main content
Glama
deenesjakoruzh
vidal-renao

vidal-helpdesk-mcp

by vidal-renao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

🇨🇭 Сервер Vidal Helpdesk MCP

Инфраструктура SaaS на базе ИИ корпоративного уровня для швейцарских МСП Реализация Model Context Protocol (MCP) для автономной оркестрации тикетов, созданная с использованием Supabase и Anthropic Claude AI в соответствии со швейцарскими стандартами revDSG.

Version TypeScript Supabase Compliance Architecture

1. Краткий обзор

vidal-helpdesk — это AI-Native инфраструктура промышленного уровня, разработанная для трансформации технической поддержки в автономную операцию. Этот сервер позволяет Claude Desktop выступать в роли оркестратора поддержки, управляя жизненным циклом инцидентов непосредственно на естественном языке.

Созданная для компаний, требующих абсолютного суверенитета данных, система использует локальный транспорт stdio и уровень персистентности в Supabase (предпочтительно в швейцарских регионах, таких как Цюрих), гарантируя, что плоскость данных остается под контролем оператора.

Бизнес-ценность:

  • MTTR (Среднее время восстановления): Радикальное сокращение за счет автоматической сортировки и мгновенных предложений по решению.

  • Локализация данных: Нативное соответствие Федеральному закону о защите данных (revDSG).

  • Разговорная бизнес-аналитика (BI): Возможность запрашивать метрики состояния инфраструктуры с помощью естественного языка.

Related MCP server: Supabase MCP Server

2. Архитектура системы

Сервер реализует шаблон Clean Architecture, изолируя транспортный протокол от бизнес-логики и уровня данных.

┌──────────────────────────┐          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