Skip to content
In VS Code installieren

Den Oracle CPQ MCP-Server mit Claude Code, Cursor und GitHub Copilot nutzen

Verbinden Sie Ihren KI-Agenten mit dem gehosteten CPQ DevKit™ Oracle MCP-Server, damit er BML-Funktionen, Datentabellen, die Commerce-Konfiguration und mehr aus Ihrer Oracle CPQ-Site lesen kann.

Auf dieser Seite

Der CPQ DevKit™ Oracle MCP-Server ist ein gehosteter Model Context Protocol-Server unter https://app.cpqdevkit.com/mcp/oracle. Er stellt einem KI-Agenten Tools bereit, mit denen er Ihre Oracle CPQ-Site abfragen kann: Funktionen der BML-Util-Library, Datentabellen, Commerce-Prozesse und -Dokumente, Parts, Dateien, Benutzer, Migrationspakete und mehr. Diese Anleitung behandelt Claude Code, Cursor und GitHub Copilot in VS Code.

Bevor Sie beginnen

  • Eine Oracle CPQ Cloud-Site mit Zugriff auf die REST-API (eigenständiges BigMachines oder Fusion Applications). Die Tools für die BML-Library benötigen REST v19.
  • Einen Oracle CPQ-Benutzer, der über die REST-API die Daten lesen darf, die der Agent sehen soll. Ein eigener Integrationsbenutzer ist empfehlenswert.
  • Ein kostenloses CPQ DevKit™-Konto. Sie können es in der Oracle-Erweiterung oder unter app.cpqdevkit.com anlegen.
  • Das KI-Tool, das Sie verwenden möchten: VS Code 1.109 oder neuer mit GitHub Copilot, Claude Code oder Cursor.

Der einfachste Weg: VS Code

Wenn Sie in VS Code arbeiten, müssen Sie nichts von Hand konfigurieren:

  1. Installieren Sie CPQ DevKit™ for Oracle aus dem VS Code Marketplace.
  2. Führen Sie Sign In über die Befehlspalette aus. Bei der Anmeldung wird Ihr CPQ DevKit™-API-Schlüssel erstellt und im Secret Storage von VS Code gespeichert.
  3. Richten Sie Ihr Projekt ein und fügen Sie Ihre Oracle CPQ-Umgebung hinzu. Die Erweiterung übergibt die Site-Adresse und die Zugangsdaten der aktiven Umgebung an den MCP-Server.

Anschließend führt VS Code den MCP-Server CPQ DevKit™ for Oracle für GitHub Copilot auf. Der Server verwendet die Umgebung, die bei seinem Start aktiv ist. Starten Sie ihn daher neu, nachdem Sie die Umgebung gewechselt haben.

Diese automatische Einrichtung ist für VS Code gedacht. Claude Code und Cursor führen eigene Listen von MCP-Servern. Fügen Sie den Server dort einmalig hinzu, wie unten beschrieben.

API-Schlüssel erstellen

Für die manuellen Einrichtungen unten benötigen Sie einen CPQ DevKit™-API-Schlüssel:

  1. Melden Sie sich unter app.cpqdevkit.com an.
  2. Erstellen Sie einen API-Schlüssel und kopieren Sie ihn. Der vollständige Schlüssel wird nur einmal angezeigt. Bewahren Sie ihn daher an einem sicheren Ort auf, zum Beispiel in Ihrem Passwortmanager.
  3. Checken Sie den Schlüssel nicht in die Versionsverwaltung ein. Die Beispiele unten lesen ihn aus einer Umgebungsvariablen.

Was der Server benötigt

Der Server liest diese HTTP-Header:

HeaderWert
X-API-KeyIhr CPQ DevKit™-API-Schlüssel
X-Oracle-CPQ-Base-URLDie Adresse Ihrer Site, zum Beispiel https://yoursite.bigmachines.com
X-Oracle-CPQ-UsernameOracle CPQ-Benutzername (zusammen mit X-Oracle-CPQ-Password)
X-Oracle-CPQ-PasswordOracle CPQ-Passwort
X-Oracle-CPQ-Access-TokenOptional: ein OAuth-Zugriffstoken für Oracle CPQ anstelle von Benutzername und Passwort
X-Oracle-CPQ-Rest-Base-PathOptional: der REST-Basispfad, falls Ihre Site nicht den Standardpfad verwendet
X-Oracle-CPQ-Api-VersionOptional: Version der REST-API, standardmäßig v19

Der Server ruft Ihre Oracle CPQ-Site für jede Anfrage mit der Site-Adresse und den Zugangsdaten auf, die in genau dieser Anfrage enthalten sind. Die Beispiele unten verwenden diese Umgebungsvariablen. Setzen Sie sie in Ihrem Shell-Profil und starten Sie anschließend Ihren Editor oder Ihr Terminal neu:

export CPQDEVKIT_API_KEY="cpqdk_..."
export ORACLE_CPQ_BASE_URL="https://yoursite.bigmachines.com"
export ORACLE_CPQ_USERNAME="integration.user"
export ORACLE_CPQ_PASSWORD="..."

Claude Code

Fügen Sie den Server mit einem einzigen Befehl hinzu. Führen Sie ihn in Ihrem Projektordner aus:

claude mcp add --transport http cpq-devkit-oracle https://app.cpqdevkit.com/mcp/oracle \
  --header "X-API-Key: $CPQDEVKIT_API_KEY" \
  --header "X-Oracle-CPQ-Base-URL: $ORACLE_CPQ_BASE_URL" \
  --header "X-Oracle-CPQ-Username: $ORACLE_CPQ_USERNAME" \
  --header "X-Oracle-CPQ-Password: $ORACLE_CPQ_PASSWORD"

Ihre Shell setzt die Werte ein, und Claude Code speichert sie in seinen eigenen Einstellungen, und zwar nur für dieses Projekt. Mit --scope user steht der Server in allen Projekten zur Verfügung.

Wenn Sie die Einrichtung mit Ihrem Team teilen möchten, ohne Secrets weiterzugeben, legen Sie stattdessen eine Datei .mcp.json im Stammverzeichnis des Projekts an. Claude Code liest die Werte aus den Umgebungsvariablen der jeweiligen Person:

{
  "mcpServers": {
    "cpq-devkit-oracle": {
      "type": "http",
      "url": "https://app.cpqdevkit.com/mcp/oracle",
      "headers": {
        "X-API-Key": "${CPQDEVKIT_API_KEY}",
        "X-Oracle-CPQ-Base-URL": "${ORACLE_CPQ_BASE_URL}",
        "X-Oracle-CPQ-Username": "${ORACLE_CPQ_USERNAME}",
        "X-Oracle-CPQ-Password": "${ORACLE_CPQ_PASSWORD}"
      }
    }
  }
}

Führen Sie claude mcp list aus, um zu prüfen, ob der Server verbunden ist, oder geben Sie in einer Claude Code-Sitzung /mcp ein. Server aus der .mcp.json eines Projekts müssen Sie in Claude Code beim ersten Mal freigeben.

Cursor

Legen Sie .cursor/mcp.json in Ihrem Projekt an, oder ~/.cursor/mcp.json in Ihrem Home-Verzeichnis, um den Server in allen Projekten zu nutzen:

{
  "mcpServers": {
    "cpq-devkit-oracle": {
      "url": "https://app.cpqdevkit.com/mcp/oracle",
      "headers": {
        "X-API-Key": "${env:CPQDEVKIT_API_KEY}",
        "X-Oracle-CPQ-Base-URL": "${env:ORACLE_CPQ_BASE_URL}",
        "X-Oracle-CPQ-Username": "${env:ORACLE_CPQ_USERNAME}",
        "X-Oracle-CPQ-Password": "${env:ORACLE_CPQ_PASSWORD}"
      }
    }
  }
}

Cursor setzt ${env:…} aus Ihrer Umgebung ein. Setzen Sie die Variablen daher in Ihrem Shell-Profil und starten Sie Cursor neu. Öffnen Sie dann die Cursor Settings, suchen Sie den Bereich MCP und prüfen Sie, ob cpq-devkit-oracle seine Tools anzeigt.

GitHub Copilot in VS Code

Die meisten VS Code-Nutzer benötigen diesen Abschnitt nicht: Die Erweiterung richtet den Server für Sie ein, wie oben unter „Der einfachste Weg: VS Code“ beschrieben. Verwenden Sie eine manuelle Einrichtung, wenn Sie die Erweiterung nicht installieren möchten oder sich mit einer anderen Site als der aktiven Umgebung der Erweiterung verbinden wollen.

Legen Sie .mcp.json im Stammverzeichnis Ihres Workspace an:

{
  "mcpServers": {
    "cpq-devkit-oracle": {
      "type": "http",
      "url": "https://app.cpqdevkit.com/mcp/oracle",
      "headers": {
        "X-API-Key": "${CPQDEVKIT_API_KEY}",
        "X-Oracle-CPQ-Base-URL": "${ORACLE_CPQ_BASE_URL}",
        "X-Oracle-CPQ-Username": "${ORACLE_CPQ_USERNAME}",
        "X-Oracle-CPQ-Password": "${ORACLE_CPQ_PASSWORD}"
      },
      "tools": ["*"]
    }
  }
}

Für eine Einrichtung, die in allen Workspaces gilt, tragen Sie denselben mcpServers-Eintrag in ~/.copilot/mcp-config.json ein. VS Code liest ${NAME}-Werte aus der Umgebung, in der VS Code gestartet wurde. Setzen Sie also zuerst die Variablen und starten Sie dann VS Code. Ältere Einrichtungen verwendeten .vscode/mcp.json mit einem servers-Schlüssel; für neue Konfigurationen empfiehlt VS Code inzwischen .mcp.json.

Um den Server zu prüfen, öffnen Sie in der Chat-Ansicht die Tool-Auswahl und stellen Sie sicher, dass der Server und seine Tools ausgewählt sind.

Beispiel-Prompts

Diese Prompts verwenden Lese-Tools, die im Free-Plan funktionieren:

  1. "Listen Sie die Datentabellen auf meiner Oracle CPQ-Site auf."
  2. "Zeigen Sie die Zeilen der Datentabelle PartPricing, deren Teilenummer SRV enthält."
  3. "Welche Preisbücher sind auf meiner Site eingerichtet?"

Diese Prompts verwenden Agenten-Tools, die einen Pro-Plan erfordern:

  1. "Listen Sie die Funktionen der BML-Util-Library auf meiner Oracle CPQ-Site auf, gruppiert nach Ordner."
  2. "Rufen Sie die Util-Funktion calculateDiscount ab und prüfen Sie sie auf BMQL-Abfragen innerhalb von Schleifen und auf Aufrufe von Funktionen, die nicht existieren."

Ersetzen Sie die Funktions- und Tabellennamen durch Namen aus Ihrer Site. Um zuerst die Verbindung zu prüfen, bitten Sie den Agenten, Ihre Datentabellen aufzulisten: Antwortet er mit Tabellen aus Ihrer Site, ist der Server verbunden. Mit einem Pro-Plan können Sie außerdem fragen: "Mit welcher Oracle CPQ-Site ist der CPQ DevKit MCP-Server verbunden?" Der Agent antwortet mit der Site-Adresse und der Anmeldemethode, niemals mit Passwörtern oder Tokens.

Was Pro erfordert

Lese-Tools, zum Beispiel für Datentabellen, Parts, Preisbücher, die Commerce-Konfiguration und Benutzer, sind innerhalb eines monatlichen Limits kostenlos: 100 Aufrufe pro Monat im Free-Plan und 10.000 im Pro-Plan. Jedes Tool, das Ihr Agent ausführt, zählt als ein Aufruf; das Verbinden und das Auflisten der Tools werden nicht gezählt.

Diese Tools erfordern einen Pro-Plan:

  • Schreib-Tools: create_transaction, perform_action, bulk_transaction_actions, generate_document, create_migration_package, export_migration_package, copy_migration_package, version_migration_package, migrate_package, create_snapshot, revert_to_snapshot, rollback_migration, create_full_backup, create_full_snapshot
  • Bulk-Tools: get_all_data_table_data, get_all_endpoint_data, get_openapi_spec, get_performance_logs, get_performance_log
  • Agenten-Tools: describe_environment, list_bml_functions, get_bml_function, list_bml_folders, list_integrations, review_bml. Damit kann Ihr Agent BML-Funktionen durchsuchen und prüfen und die verbundene Site beschreiben.

Im Free-Plan beantwortet der Server diese Tools mit dem Hinweis, dass Pro erforderlich ist, und es wird nichts an Ihre Site gesendet. Schreib-Tools ändern Ihre Oracle CPQ-Site. Prüfen Sie daher, was der Agent vorhat, bevor Sie einen Aufruf freigeben.

Fehlerbehebung

  • "Please provide an API key": Der Header X-API-Key fehlt. Prüfen Sie, ob die Umgebungsvariable in der Umgebung gesetzt ist, aus der Ihr Editor oder Terminal gestartet wurde.
  • "Missing required Oracle CPQ headers": Fügen Sie X-Oracle-CPQ-Base-URL sowie entweder Benutzername und Passwort oder ein Zugriffstoken hinzu.
  • "The provided API key is invalid or expired": Erstellen Sie unter app.cpqdevkit.com einen neuen Schlüssel und aktualisieren Sie Ihre Umgebungsvariable.
  • "Monthly usage limit reached": Sie haben die Aufrufe Ihres Plans für diesen Monat aufgebraucht.

Fragen oder Probleme? Schreiben Sie an sales@cpqdevkit.com. Wie wir mit Daten umgehen, erfahren Sie in der Datenschutzerklärung.