Debeka MCP Server

Ein MCP (Model Context Protocol) Server zur Automatisierung von Debeka Leistungsaufträgen mit Playwright.

Features

• 🌐 Automatisches Öffnen der Debeka Leistungsauftrag-Seite
• 📝 Ausfüllen von Servicenummer und Geburtsdatum
• 📎 Upload von PDF-Dokumenten (Arztrechnungen)
• 📸 Screenshots zur Überprüfung
• ✅ Formular absenden

Installation

Voraussetzungen

• Node.js 18 oder höher
• npm

Installation

cd debeka-mcp-server
npm install
npm run build

Dies installiert auch automatisch den Chromium-Browser für Playwright.

Konfiguration in Claude Desktop / Cowork

Füge folgende Konfiguration zu deiner claude_desktop_config.json hinzu:

macOS

Pfad: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "debeka": {
      "command": "node",
      "args": ["/pfad/zu/debeka-mcp-server/dist/index.js"]
    }
  }
}

Windows

Pfad: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "debeka": {
      "command": "node",
      "args": ["C:\\pfad\\zu\\debeka-mcp-server\\dist\\index.js"]
    }
  }
}

Verwendung

Nach der Konfiguration stehen folgende Tools zur Verfügung:

1. debeka_open_page

Öffnet die Debeka Leistungsauftrag-Seite im Browser.

debeka_open_page(headless=false)  # Mit sichtbarem Browser
debeka_open_page(headless=true)   # Ohne UI (Hintergrund)

2. debeka_fill_credentials

Füllt Servicenummer und Geburtsdatum aus.

debeka_fill_credentials(
  servicenummer="123456789",
  geburtsdatum="15.03.1985"
)

3. debeka_upload_documents

Lädt PDF-Dokumente hoch.

debeka_upload_documents(
  file_paths=["/pfad/zu/rechnung1.pdf", "/pfad/zu/rechnung2.pdf"]
)

4. debeka_screenshot

Macht einen Screenshot der aktuellen Seite.

debeka_screenshot(output_path="/pfad/zum/screenshot.png")

5. debeka_submit

Sendet das Formular ab.

debeka_submit()

6. debeka_close

Schließt den Browser.

debeka_close()

7. debeka_get_page_info

Zeigt Informationen über die Seitenstruktur (für Debugging).

Typischer Workflow

1. Seite öffnen: debeka_open_page(headless=false)
2. Credentials eingeben: debeka_fill_credentials(servicenummer="...", geburtsdatum="...")
3. Dokumente hochladen: debeka_upload_documents(file_paths=[...])
4. Überprüfen: debeka_screenshot()
5. Absenden: debeka_submit()
6. Browser schließen: debeka_close()

Integration mit Paperless-NGX

Der Server kann zusammen mit Paperless-NGX verwendet werden:

1. Arztrechnungen aus Paperless exportieren
2. Mit diesem MCP-Server automatisch bei Debeka einreichen

Fehlerbehebung

Browser startet nicht

• Stelle sicher, dass Chromium installiert ist: npx playwright install chromium

Formularfelder werden nicht gefunden

• Die Debeka-Website könnte ihre Struktur geändert haben
• Nutze debeka_get_page_info um die aktuelle Struktur zu sehen
• Nutze debeka_screenshot um den aktuellen Zustand zu überprüfen

Wartungsarbeiten

• Die Debeka-Website ist manchmal in Wartung
• Versuche es später erneut

Lizenz

MIT