Odoo (MCP server) über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Odoo (MCP server) klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Odoo (MCP server) + Cursor

Verbinde Claude, ChatGPT oder Copilot über Odoos eigenen MCP-Server (Odoo AI, Odoo Online saas-19.4 und Odoo 20) mit Odoo: jedes Modell durchsuchen, Datensätze gruppieren und summieren, Modelle und Felder auflisten und, wenn dein Admin es erlaubt, Datensätze anlegen und ändern. Gesteuert über den Odoo-Benutzer und die AI Tools, die dein Admin freigibt.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

ODOO_URL, ODOO_MCP_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst eine Odoo-Datenbank mit Odoos eigenem MCP-Server: Odoo Online ab Version saas-19.4 oder Odoo 20, jeweils mit installierter AI-App. Deine Version steht unten in den Settings, und eine Datenbank mit MCP-Server bietet beim Anlegen eines API-Schlüssels den Scope MCP an.

1. Klicke in Odoo auf deinen Avatar und öffne My Preferences (oder My Profile) → Security → Add API Key. Bestätige dein Passwort und gib dem Schlüssel einen Namen.
2. Setze Scope auf MCP und wähle unter Expires, wie lange der Schlüssel gilt. Odoo zeigt den Schlüssel nur einmal, also kopiere ihn sofort. Lege ihn für einen eigenen Odoo-Benutzer an, dessen Zugriffsrechte zu dem passen, was der Assistent sehen darf: Der Schlüssel handelt als dieser Benutzer.
3. Füge den Schlüssel in ODOO_MCP_API_KEY ein. Er besteht aus 40 kleingeschriebenen Hexadezimalzeichen; das Wort Bearer gehört nicht dazu.
4. Trag in ODOO_URL die Adresse ein, unter der du Odoo öffnest, bis zum Host, zum Beispiel https://mycompany.odoo.com. Lass /odoo, /web, /mcp und den Schrägstrich am Ende weg: /mcp hängt der Connector selbst an.
5. Installiere den Connector und rufe odoo_mcp_ai_tool_mcp_retrieve_initial_context auf: Es zeigt den angemeldeten Benutzer, seine Zeitzone, das aktive Unternehmen und alle Unternehmen, zu denen er wechseln kann.

Welcher Odoo-Connector? Dieser ist für Datenbanken mit Odoos eigenem MCP-Server, bei denen dein Odoo-Admin bestimmt, welche Tools es gibt und welche Änderungen erlaubt sind. Für Odoo 19.0 (das keinen MCP-Server hat), für Odoo.sh oder deinen eigenen Server ohne MCP-Server oder wenn du feste Tools für Partner, Verkaufsaufträge, Rechnungen und Produkte willst, nimm den Connector Odoo (JSON-2-API, Odoo 19 und neuer). Für Odoo 14 bis 18 nimm Odoo 14-18 (JSON-RPC).

Die Tools kommen aus deiner Datenbank: Bei der Installation fragt AnythingMCP den MCP-Server von Odoo, welche Tools er anbietet. Standardmäßig sind das Get Models, Get Fields, Search, Read group und MCP Retrieve initial context, alle nur lesend, und Odoo führt sie mit den Rechten des Benutzers aus, dem der Schlüssel gehört. Ein Admin kann im Entwicklermodus unter Settings → Technical → Server Actions weitere freigeben (Create Records, Update Records, Menüs, Website- und Bild-Tools), indem er auf dem Reiter Usage des Tools Available in MCP anhakt. Danach öffnest du hier den Connector und klickst auf Discover tools. Bildgenerierung verbraucht Odoo-AI-Credits.

Was er liest: jedes Modell, das der Odoo-Benutzer öffnen darf, etwa Kontakte, Verkaufsaufträge, Rechnungen oder Produkte. odoo_mcp_ai_tool_get_models findet das passende Modell, odoo_mcp_ai_tool_get_fields listet seine Felder, odoo_mcp_ai_tool_search sucht Datensätze mit einer Odoo-Domain, und odoo_mcp_ai_tool_read_group gruppiert und summiert sie nach Tag, Woche, Monat, Quartal oder Jahr: Umsatz pro Monat, Rechnungen pro Kunde, Leads pro Phase.

Fragt vor jeder Änderung: Bei der Installation ist kein schreibendes Tool aktiv. Schaltet ein Administrator das Anlegen oder Ändern von Datensätzen ein, zeigt dir die KI die Datensätze und die genauen Werte und wartet auf dein Ja, bevor sie etwas schreibt.

Bei der Installation deaktiviert: odoo_mcp_ai_tool_create_records und odoo_mcp_ai_tool_update_records. Odoo verbirgt sie, bis ein Admin sie für MCP freigibt, und hier werden sie zusätzlich ausgeschaltet installiert, weil sie Datensätze anlegen oder Feldwerte an allen Datensätzen ändern, die zu einer Domain passen. Schalte sie pro Tool nur ein, wenn der Assistent Odoo wirklich ändern soll.

Limits: Search liefert standardmäßig 50 Datensätze und höchstens 200 pro Aufruf. Bei größeren Ergebnissen blättert die KI deshalb weiter oder nimmt Read group für Summen, statt Tausende Zeilen zu laden. Der API-Schlüssel läuft an dem Datum ab, das du unter Expires gewählt hast: Dann legst du einen neuen an und trägst ihn ein.

Häufige Fehler: 401 heißt, dass der Schlüssel falsch oder abgelaufen ist oder ohne MCP-Scope angelegt wurde. 404 bei /mcp heißt, dass die Datenbank keinen MCP-Server hat (sie ist älter als saas-19.4, oder die AI-App ist nicht installiert): Nimm dann den Connector Odoo oder Odoo 14-18 (JSON-RPC). Odoo veröffentlicht Get Fields ohne Parameter, das Tool scheitert aber ohne model_name und include_description. Die KI übergibt deshalb immer beide.

Der Connector fügt keine Tools hinzu, die dein Odoo nicht anbietet, geht nicht über die Zugriffsrechte des Odoo-Benutzers hinter dem Schlüssel hinaus und funktioniert nicht mit Datenbanken ohne Odoo-MCP-Server.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Odoo (MCP server)-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie hoch war unser bestätigter Umsatz pro Monat in diesem Jahr? Gib mir für jeden Monat die Summe.“
• „Welche Kunden haben überfällige offene Rechnungen, und wie viel schuldet uns jeder davon?“
• „Such den Kontakt Müller Bau GmbH und zeig mir E-Mail, Telefonnummer und zuständigen Verkäufer.“
• „Welche zehn Produkte haben wir im letzten Quartal mengenmäßig am meisten verkauft?“
• „Ändere die E-Mail des Kontakts Anna Weber auf [email protected]. Zeig mir den Datensatz, bevor du ihn änderst.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden