# 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

```bash
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`

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

### Windows
Pfad: `%APPDATA%\Claude\claude_desktop_config.json`

```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