Einrichtung MCP-Server für PROAD

Mit dem everii MCP-Server verbinden Sie KI-Clients wie Claude Desktop oder die ChatGPT
Desktop App direkt mit Ihren PROAD-Daten. Die Einrichtung dauert nur wenige Minuten.

1. Das benötigen Sie

• Server-URL: https://general-mcp.everii.io/mcp
• Ihren PROAD API-Key
• Die URL Ihrer PROAD-API, in der Regel https://login.proadsoftware.com/api/v5
• Claude Desktop oder die ChatGPT Desktop App. Für Claude Desktop zusätzlich Node.js,
da der Wrapper „mcp-remote“ über npx gestartet wird.
Bei jeder Anfrage muss Ihr Client drei HTTP-Header mitsenden:

Wichtig:
Claude im Web (claude.ai) unterstützt bei Connectors nur OAuth oder einen
einzelnen Bearer-Token, aber keine eigenen Header. Die Verbindung funktioniert dort
deshalb nicht. Claude meldet in diesem Fall, dass x-mcp-provider kein genehmigter Header
ist. Nutzen Sie stattdessen Claude Desktop oder die ChatGPT Desktop App.


2. Einrichtung in Claude Desktop

Claude Desktop verbindet sich nicht direkt mit Remote-MCP-Servern, deshalb nutzen Sie denWrapper mcp-remote.

1. Konfigurationsdatei öffnen: Gehen Sie zu Einstellungen → Developer → Edit Config. Die Datei claude_desktop_config.json öffnet sich am richtigen Ort. Alternativ finden Sie sie hier:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Inhalt prüfen: Ist die Datei leer oder enthält nur {}, können Sie den Codeblock aus Schritt 3 komplett einfügen. Enthält sie bereits Einstellungen, fügen Sie „mcpServers“ als neuen Schlüssel auf oberster Ebene hinzu. Existiert „mcpServers“ schon, ergänzen Sie nur den Eintrag „proad“ darin. Legen Sie keinen zweiten mcpServers-Schlüssel an.

3. Eintrag einfügen: Tragen Sie folgenden Block ein:

4. API-Key eintragen: Ersetzen Sie IHR_PROAD_API_KEY durch Ihren echten Schlüssel.
Die Anführungszeichen bleiben stehen. Passen Sie bei Bedarf die PROAD-API-URL an.


5. Neu starten: Speichern Sie die Datei und beenden Sie Claude Desktop vollständig (nicht
nur das Fenster schließen). Starten Sie die App danach neu.

Tipp: JSON ist bei Kommas und Klammern streng. Prüfen Sie die Datei vor dem Speichern
mit einem JSON-Validator (z. B. jsonlint.com) oder öffnen Sie sie in einem Editor mit
Syntax-Highlighting.

3. Einrichtung in der ChatGPT Desktop App
Die ChatGPT Desktop App verbindet sich direkt per HTTP. Ein Zusatz-Tool benötigen Sie nicht.

1. Öffnen Sie Einstellungen → Plugins und wechseln Sie in den Tab MCPs.

2. Klicken Sie oben rechts auf Add server.

3. Tragen Sie bei URL https://general-mcp.everii.io/mcp ein. Lassen Sie
„Bearer token env var“ leer.

4. Fügen Sie unter Headers per „+ Add header“ je eine Zeile hinzu:

5. Lassen Sie „Headers from environment variables“ leer, sofern Sie die Werte nicht lieber
aus Umgebungsvariablen beziehen möchten.

6. Klicken Sie auf Save. Der Server erscheint unter „Servers“ und lässt sich per Schalter
aktivieren

4. Fehlerbehebung

Behandeln Sie Ihren API-Key wie ein Passwort: Geben Sie ihn nicht weiter und speichern Sie
ihn nicht in geteilten Dokumenten.

Dazu auch Artikel: https://proad-helpcenter.everii.io/mcp-server