MCP Server

Der SupDesk MCP-Server (Model Context Protocol) bietet programmgesteuerten Zugriff auf Feedback-Daten über eine standardisierte Schnittstelle, die KI-Assistenten und andere LLM-gestützte Tools nutzen können.

Endpunkt

Der MCP-Server ist verfügbar unter: https://mcp.supdesk.app/mcp

Authentifizierung

Die Authentifizierung erfolgt über einen API-Schlüssel, der als Bearer-Token im Authorization-Header übergeben wird:


Authorization: Bearer <dein-api-schlüssel>

API-Schlüssel können im SupDesk-Dashboard unter Workspace-Einstellungen → API-Schlüssel erstellt werden.

Verfügbare Tools

Der MCP-Server stellt 5 Tools zur Verwaltung von Feedback bereit:

list_feedback

Liste Feedback-Elemente mit optionaler Filterung und Paginierung auf.

Parameter:

project_id (string, erforderlich): UUID des Projekts
status (string, optional): Filter nach Status (open, planned, in_progress, done)
limit (integer, optional): Seitengröße (1-100, Standard: 20)
offset (integer, optional): Anzahl der zu überspringenden Elemente (Standard: 0)

Rückgabe:

data: Array von Feedback-Objekten
pagination: Objekt mit limit, offset, count und has_more Eigenschaften

get_feedback

Ruft ein einzelnes Feedback-Element anhand seiner ID ab.

Parameter:

project_id (string, erforderlich): UUID des Projekts
id (string, erforderlich): UUID des Feedback-Elements

Rückgabe:

data: Feedback-Objekt

create_feedback

Erstellt ein neues Feedback-Element.

Parameter:

project_id (string, erforderlich): UUID des Projekts
title (string, erforderlich): Kurze Zusammenfassung des Feedbacks
email (string, erforderlich): E-Mail-Adresse des Absenders
name (string, optional): Anzeigename des Absenders
body (string, optional): Detaillierte Beschreibung

Rückgabe:

data: Erstelltes Feedback-Objekt

update_feedback

Aktualisiert ein vorhandenes Feedback-Element.

Parameter:

project_id (string, erforderlich): UUID des Projekts
id (string, erforderlich): UUID des zu aktualisierenden Feedback-Elements
status (string, optional): Neuer Status (open, planned, in_progress, done)
title (string, optional): Neuer Titel
body (string, optional): Neuer Inhalt

Rückgabe:

data: Aktualisiertes Feedback-Objekt

delete_feedback

Löscht ein Feedback-Element.

Parameter:

project_id (string, erforderlich): UUID des Projekts
id (string, erforderlich): UUID des zu löschenden Feedback-Elements

Rückgabe:

success: Boolean, der angibt, ob die Löschung erfolgreich war

Nutzungsbeispiele

Konfiguration mit Claude Desktop

Um den SupDesk MCP-Server mit Claude Desktop zu verwenden, füge die folgende Konfiguration zu deiner Claude Desktop-Konfigurationsdatei (~/Library/Application Support/Claude/claude_desktop_config.json) hinzu:


{
  "mcpServers": {
    "sup-desk-feedback": {
      "command": "npx",
      "args": [
        "-y",
        "@sup-desk/mcp-server",
        "--url",
        "https://mcp.supdesk.app/mcp",
        "--api-key",
        "dein-api-schlüssel-hier"
      ]
    }
  }
}

Beispiel-Workflow


// Liste offenes Feedback für ein Projekt
const feedbackList = await mcpClient.callTool("list_feedback", {
  project_id: "123e4567-e89b-12d3-a456-426614174000",
  status: "open",
  limit: 10
});
 
// Erstelle neues Feedback
const newFeedback = await mcpClient.callTool("create_feedback", {
  project_id: "123e4567-e89b-12d3-a456-426614174000",
  title: "Anfrage nach Dark Mode",
  email: "user@example.com",
  name: "Alex User",
  body: "Ich würde gerne eine Dark-Mode-Option für das Dashboard sehen."
});

Ratenlimits

Der MCP-Server verwendet dieselben Ratenlimits wie die REST-API:

120 Anfragen pro 60 Sekunden pro Projekt
Schreiboperationen (Erstellen, Aktualisieren, Löschen) erfordern einen kostenpflichtigen Tarif

Fehlerantworten

Alle Tools geben standardisierte Fehlerantworten mit folgendem Format zurück:


{
  "error": {
    "code": "error-code",
    "message": "Menschenlesbare Fehlermeldung"
  }
}

Häufige Fehlercodes:

unauthorized: Fehlender oder ungültiger API-Schlüssel
not_found: Angeforderte Ressource existiert nicht
invalid_request: Fehlende oder ungültige Parameter
internal_error: Unerwarteter Serverfehler