Skip to main content
Glama
deenesjakoruzh
vidal-renao

vidal-helpdesk-mcp

by vidal-renao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

🇨🇭 Vidal Helpdesk MCP 서버

스위스 중소기업을 위한 엔터프라이즈급 AI 기반 SaaS 인프라 스위스 revDSG 표준에 따라 Supabase 및 Anthropic Claude AI로 구축된 자율 티켓 오케스트레이션을 위한 MCP(Model Context Protocol) 구현체.

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