MCP-Server für KI-Assistenten

Frag Claude, ChatGPT oder Cursor direkt nach deinem Urlaubsplan. Der urlaub-smart.de MCP-Server liefert Feiertage, Brückentage und den optimalen Plan als Werkzeug für jeden Assistenten, der das Model Context Protocol spricht.

Endpunkt (Streamable HTTP, ohne Anmeldung)

https://urlaub-smart.de/api/mcp

Werkzeuge

plan_vacation: Optimaler Jahresplan für Region, Jahr, Urlaubstage, Schulferien-Modus und Strategie, optional mit Resturlaub bis 31.3., betriebsfreien Tagen und Schichtrhythmus (z. B. 4 Tage Dienst, 2 frei). Liefert die Blöcke mit Buchungstagen, Faktor und Link zum interaktiven Plan.
best_bridge_days: Die sechs besten Hebel des Jahres: Brückentage und Feiertags-Cluster.
public_and_school_holidays: Alle gesetzlichen Feiertage mit Wochentag und Geltung sowie die Schulferien.
childcare_gap: Für Eltern: Wie viele Schulferientage auf Werktage fallen, wie viele zwei Urlaubskonten davon decken und welche Wochen offen bleiben. Rund 60 Betreuungstage stehen 30 Urlaubstagen gegenüber.
list_regions: Alle unterstützten Länder und Regionen mit Codes und Slugs.

Einrichtung

Claude (claude.ai und Desktop)

Einstellungen → Connectors → „Benutzerdefinierten Connector hinzufügen“, dann die Endpunkt-URL einsetzen. In der JSON-Konfiguration von Claude Desktop funktioniert ein reiner URL-Eintrag nicht, dafür gibt es den stdio-Weg unten.

Claude Code

Ein Befehl im Terminal, oder der Eintrag in .mcp.json im Projekt. Wichtig ist „type“: „http“ — ohne das lehnt Claude Code die Konfiguration ab.

claude mcp add --transport http urlaub-smart https://urlaub-smart.de/api/mcp

{
  "mcpServers": {
    "urlaub-smart": {
      "type": "http",
      "url": "https://urlaub-smart.de/api/mcp"
    }
  }
}

Cursor, Windsurf, VS Code

Diese Clients erkennen den Endpunkt an der URL allein:

{
  "mcpServers": {
    "urlaub-smart": {
      "url": "https://urlaub-smart.de/api/mcp"
    }
  }
}

Clients, die nur stdio sprechen

Dazu gehört die JSON-Konfiguration von Claude Desktop. mcp-remote übersetzt zwischen stdio und HTTP:

{
  "mcpServers": {
    "urlaub-smart": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://urlaub-smart.de/api/mcp"
      ]
    }
  }
}

Beispielfrage

„Ich arbeite in Bayern, habe 2027 30 Urlaubstage und Kinder in der Schule. Wie lege ich meinen Urlaub?“

Kostenlos, ohne Schlüssel, 60 Anfragen pro Minute je Client. Daten: OpenHolidaysAPI. Kein Tracking, keine Speicherung von IP-Adressen.