concierge-mcp

Lokaler MCP-Server für Concierge — die Discord-native Kundensupport-Plattform.

Verbinden Sie Ihren KI-Agenten (Claude Desktop, Cursor, Cline oder einen beliebigen MCP-kompatiblen Client) mit Ihrem Concierge-Support-Server und steuern Sie den gesamten Support-Stack per natürlicher Sprache. Über 200 Tools decken den Ticket-Lebenszyklus, KI-Konfiguration, Wissensdatenbank, Panels, Automatisierungen, Analysen, Abrechnung, Discord-Kommunikation und mehr ab.

Was Sie tun können

„Richte Concierge für mein SaaS ein – stelle das Panel in #support bereit, gib @Mod und @Admin Agenten-Zugriff und konfiguriere das SLA auf 30 Minuten für Tickets mit hoher Priorität.“

„Zeig mir einen CSAT-Bericht für die letzten 30 Tage und schlage dann eine Antwort für Ticket #142 vor.“

„Schließe alle Tickets, die älter als 7 Tage sind und auf die kein Agent geantwortet hat, und sende dem Kunden ein Transkript per DM.“

„Snooze Ticket #88 bis morgen 9 Uhr ET und markiere den Kunden als VIP.“

Installation

Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Sie sollten „concierge“ in der Liste der MCP-Server sehen, mit allen über 200 verfügbaren Tools.

Cursor

Fügen Sie dies zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Cline / andere MCP-Clients

Verwenden Sie dieselbe command/args/env-Struktur – jeder MCP-Client unterstützt stdio-Server.

Abrufen Ihrer Anmeldedaten

1. Öffnen Sie Ihr Concierge-Dashboard unter conciergetickets.net/dashboard

2. Öffnen Sie ein beliebiges Panel → Advanced → MCP Settings

3. Schalten Sie MCP Enabled auf ON – dies generiert einen API-Schlüssel

4. Kopieren Sie den API-Schlüssel (setzen Sie ihn als CONCIERGE_MCP_KEY)

5. Ihre Guild ID ist die Discord-Server-ID – zu finden in der URL oder per Rechtsklick → Server-ID kopieren (Entwicklermodus erforderlich)

Funktionsweise

Dieses Paket ist ein schlanker stdio-Proxy. Wenn Ihr MCP-Client ihn startet, passiert Folgendes:

1. Verbindung zum Concierge-MCP-Server unter https://api.conciergetickets.net/api/v1/guilds/{GUILD_ID}/mcp

2. Authentifizierung mit Ihrem API-Schlüssel

3. Abrufen des aktuellen Tool-Katalogs (sodass neue, von Concierge veröffentlichte Tools automatisch erscheinen, ohne dass eine Neuinstallation erforderlich ist)

4. Weiterleitung jedes Tool-Aufrufs an den Remote-Server

Die lokale Binärdatei ist klein und zustandslos. Die Daten Ihrer Gilde verbleiben auf der Infrastruktur von Concierge.

Tool-Kategorien

• Tickets — vollständiger Lebenszyklus (beanspruchen, snoozen, wieder öffnen, abschließen, übertragen, sperren, zusammenführen, aufteilen usw.) sowie Massenvorgänge

• KI — Tickets zusammenfassen, Stimmung analysieren, Antworten vorschlagen, Antworten neu generieren, übersetzen

• Wissensdatenbank — vollständiges CRUD + Suche + GitBook-Import

• Kunden — Profile, Notizen, VIP-Umschalter, Blacklist mit optionalem Ablaufdatum

• Panels — erstellen/bereitstellen/erneut bereitstellen mit vollständiger Anpassung der Einbettungen

• Konfiguration — jede Einstellung für TicketPanel und Guild über update_panel_config / update_guild_config

• Discord — Nachrichten senden, DMs, reagieren, Ankündigungen posten, Kanäle/Rollen/Mitglieder nachschlagen

• Webhooks — vollständiges CRUD + Test, erneute Zustellung, Statistiken

• Analysen — Übersicht, Spitzenzeiten, Agenten-Bestenliste, CSV-Export

• CRM — Test, Synchronisierung, Abruf von Salesforce/HubSpot/Zendesk/Freshdesk

• Cron-Trigger — SLA-Scan, automatisches Schließen, Eskalationsprüfung bei Bedarf ausführen

• Team — einladen, entfernen, Arbeitslast/Zeitplan/Status/Fähigkeiten festlegen

Führen Sie npx -y concierge-mcp aus und rufen Sie tools/list auf, um den vollständigen Live-Katalog zu sehen.

Discovery-Endpunkte (für Nicht-MCP-Integrationen)

• GET https://api.conciergetickets.net/api/v1/public/openapi.json — vollständige OpenAPI 3.1-Spezifikation für die REST-API

• GET https://api.conciergetickets.net/api/v1/public/schema.json — geparstes Prisma-Schema (jedes Modell, Feld, Enum)

Links

• Concierge: https://conciergetickets.net

• Dokumentation: https://conciergetickets.net/docs

• Model Context Protocol: https://modelcontextprotocol.io

Lizenz

MIT