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で構築された、自律的なチケットオーケストレーションのためのModel Context Protocol (MCP) 実装。

Version TypeScript Supabase Compliance Architecture

1. エグゼクティブサマリー

vidal-helpdeskは、テクニカルサポートを自律的な運用へと変革するために設計された、本番環境グレードのAIネイティブインフラストラクチャです。このサーバーにより、Claude Desktopがサポートオーケストレーターとして機能し、自然言語で直接インシデントのライフサイクルを管理できるようになります。

絶対的なデータ主権を必要とする企業向けに構築されており、システムはローカルのstdioトランスポートとSupabase（チューリッヒなどのスイスリージョンを推奨）の永続化レイヤーを使用し、データプレーンがオペレーターの管理下に留まることを保証します。

ビジネス価値:

  • MTTR（平均復旧時間）: 自動トリアージと即時の解決策提案により、劇的に削減します。

  • データの局所性: **連邦データ保護法（revDSG）**にネイティブ準拠しています。

  • 会話型BI: 自然言語を使用してインフラストラクチャの健全性メトリクスを照会する機能を提供します。

Related MCP server: Supabase MCP Server

2. システムアーキテクチャ

このサーバーはクリーンアーキテクチャパターンを実装しており、トランスポートプロトコルをビジネスロジックおよびデータレイヤーから分離しています。

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