# Anleitung: Claude Desktop per MCP mit Dolibarr verbinden (REST-API)

**URL:** <https://forum.dolibarr.de/forum/t/anleitung-claude-desktop-per-mcp-mit-dolibarr-verbinden-rest-api/10342>\
**Category:** Dolibarr anwenden\
**Created:** [29. Oktober 2026 um 07:35 UTC](https://forum.dolibarr.de/forum/t/anleitung-claude-desktop-per-mcp-mit-dolibarr-verbinden-rest-api/10342 "2026-10-29T07:35:21Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Gerhard](https://forum.dolibarr.de/forum/user_avatar/forum.dolibarr.de/gerhard/32/481_2.png) [@Gerhard](https://forum.dolibarr.de/forum/u/Gerhard)\
**Post date:** [29. Oktober 2026 um 07:35 UTC](https://forum.dolibarr.de/forum/t/anleitung-claude-desktop-per-mcp-mit-dolibarr-verbinden-rest-api/10342/1 "2026-10-29T07:35:21Z")

</div>

Hallo zusammen,

ich möchte meine getestete Konfiguration für die Anbindung von **Claude Desktop** an Dolibarr über das **Model Context Protocol (MCP)** mit euch teilen. Damit ist es möglich, per natürlicher Sprache auf Kunden, Angebote oder Rechnungen zuzugreifen, ohne die API manuell anzusprechen.

Die Anleitung richtet sich an macOS-Nutzer, die Grundlagen sind aber auch auf andere Systeme übertragbar. Bitte beachtet die Sicherheitshinweise am Ende – besonders die Rechtevergabe des API-Benutzers.

**Getestete Umgebung:**

- Dolibarr (Installation im Unterordner `/dolibarr`)
- Claude Desktop (macOS)
- Node.js ≥ 18
- Paket: `mcp-server-dolibarr` via `npx`

* * *

**1. Voraussetzungen prüfen**

Öffnet das Terminal und prüft, ob Node.js in einer kompatiblen Version installiert ist:

```auto
node -v
npx -v
```

Die Ausgabe muss eine Versionsnummer zeigen. Node.js muss **Version 18 oder höher** haben.

**2. API-Erreichbarkeit testen**

Bevor ihr Claude konfiguriert, testet die Dolibarr-API direkt. Ersetzt die Platzhalter durch eure Werte:

```auto
curl -s -o /dev/null -w "%{http_code}\n" \
  -H "DOLAPIKEY: DEIN_API_SCHLUESSEL" \
  "https://DEINE-DOMAIN.tld/dolibarr/api/index.php/explorer"
```

**Erwartete Ausgabe:** `200`

- `404` → Pfad stimmt nicht. Achtet darauf, ob Dolibarr im Unterordner liegt (dann `/dolibarr/api/index.php`).
- `401` → API-Schlüssel ungültig oder der Benutzer hat keine Berechtigung.

**3. Claude Desktop konfigurieren**

Öffnet die Konfigurationsdatei:

```auto
open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

Ersetzt den `mcpServers`-Block (oder fügt ihn ein, falls noch keiner existiert). Wichtig: Die URL muss exakt auf `/dolibarr/api/index.php` enden – ohne abschließenden Schrägstrich.

```auto
"mcpServers": {
  "dolibarr": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-server-dolibarr"
    ],
    "env": {
      "DOLIBARR_URL": "https://DEINE-DOMAIN.tld/dolibarr/api/index.php",
      "DOLIBARR_API_KEY": "DEIN_API_SCHLUESSEL"
    }
  }
}
```

Speichert die Datei (`Cmd + S`) und schließt den Editor.

**4. Claude Desktop neu starten**

Beendet Claude Desktop vollständig (`Cmd + Q`), wartet ein paar Sekunden und startet es neu. Falls eine alte Verbindung hängt, könnt ihr im Terminal prüfen, ob noch `npx`-Prozesse laufen:

```auto
ps aux | grep npx
```

Gefundene Prozesse mit `kill <PID>` beenden.

**5. Verbindung prüfen**

Öffnet einen neuen Chat in Claude Desktop. Unten im Eingabefeld sollte ein **Stecker-Symbol (🔌)** erscheinen. Klickt darauf – in der Liste sollte `dolibarr` mit seinen Tools auftauchen.

Testet mit einer einfachen Frage:

```auto
Liste mir die letzten 5 Kunden aus Dolibarr auf.
```

Wenn Claude Daten zurückgibt, die der API-Benutzer sehen darf, funktioniert die Verbindung.

**Vollständige Konfiguration (Referenz)**

Zur Kontrolle hier der komplette `mcpServers`-Block:

```auto
{
  "mcpServers": {
    "dolibarr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-dolibarr"
      ],
      "env": {
        "DOLIBARR_URL": "https://DEINE-DOMAIN.tld/dolibarr/api/index.php",
        "DOLIBARR_API_KEY": "DEIN_API_SCHLUESSEL"
      }
    }
  }
}
```

* * *

**Fehlerbehebung (kurz)**

- **404 Not Found:** Prüft den Unterordner in der URL (`/dolibarr/api/index.php`). Testet den `curl`-Befehl aus Schritt 2.
- **401 Unauthorized:** API-Schlüssel falsch oder der Benutzer hat keine Modulberechtigung. In Dolibarr prüfen und ggf. neuen Schlüssel generieren.
- **Stecker-Symbol fehlt:** JSON-Syntax der Config prüfen (Komma, Klammern). Claude komplett beenden und neu starten. Prüfen, ob `npx` im Terminal läuft.

**Logs** findet ihr unter:

```auto
~/Library/Logs/Claude/
```

* * *

**Sicherheitshinweise (wichtig)**

- **Separater API-Benutzer:** Legt für jeden KI-Zugang einen **eigenen Dolibarr-Benutzer** an. Teilt keine Schlüssel zwischen Personen.
- **Minimale Rechte:** Gebt dem Benutzer nur die Module, die wirklich benötigt werden (z. B. nur lesend auf Kunden/Rechnungen).
- **Schlüssel geheim halten:** Postet keine echten API-Keys in Foren. Bei Verdacht auf Kompromittierung sofort in Dolibarr rotieren.

* * *

_Bereitgestellt von ITSS Gerhard Peilstöcker – [https://dolicare.de](https://dolicare.de)_  
_Feedback und Ergänzungen willkommen._

* * *