Utiliser le serveur MCP Oracle CPQ avec Claude Code, Cursor et GitHub Copilot
Connectez votre agent d'IA au serveur MCP Oracle hébergé de CPQ DevKit™ pour qu'il puisse lire les fonctions BML, les tables de données, la configuration Commerce et bien plus depuis votre site Oracle CPQ.
Sur cette page
Le serveur MCP Oracle de CPQ DevKit™ est un serveur Model Context Protocol hébergé à l'adresse https://app.cpqdevkit.com/mcp/oracle. Il fournit à un agent d'IA des outils pour consulter votre site Oracle CPQ : fonctions de la bibliothèque util BML, tables de données, processus et documents Commerce, pièces, fichiers, utilisateurs, packages de migration, et plus encore. Ce guide couvre Claude Code, Cursor et GitHub Copilot dans VS Code.
Avant de commencer
- Un site Oracle CPQ Cloud avec accès à l'API REST (BigMachines autonome ou Fusion Applications). Les outils de la bibliothèque BML nécessitent REST v19.
- Un utilisateur Oracle CPQ autorisé à lire, via l'API REST, les données que l'agent doit voir. Un utilisateur d'intégration dédié est recommandé.
- Un compte CPQ DevKit™ gratuit. Vous pouvez le créer depuis l'extension Oracle ou sur app.cpqdevkit.com.
- L'outil d'IA que vous souhaitez utiliser : VS Code 1.109 ou version ultérieure avec GitHub Copilot, Claude Code ou Cursor.
Le plus simple : VS Code
Si vous travaillez dans VS Code, vous n'avez rien à configurer manuellement :
- Installez CPQ DevKit™ for Oracle depuis le VS Code Marketplace.
- Exécutez Sign In depuis la palette de commandes. La connexion crée votre clé API CPQ DevKit™ et la conserve dans le stockage des secrets de VS Code.
- Configurez votre projet et ajoutez votre environnement Oracle CPQ. L'extension transmet au serveur MCP l'adresse du site et les identifiants de l'environnement actif.
VS Code affiche alors le serveur MCP CPQ DevKit™ for Oracle pour GitHub Copilot. Le serveur utilise l'environnement actif au moment de son démarrage : redémarrez-le donc après avoir changé d'environnement.
Cette configuration automatique concerne VS Code. Claude Code et Cursor gèrent leur propre liste de serveurs MCP : ajoutez-y le serveur une fois, comme indiqué ci-dessous.
Obtenir une clé API
Les configurations manuelles ci-dessous nécessitent une clé API CPQ DevKit™ :
- Connectez-vous sur app.cpqdevkit.com.
- Créez une clé API et copiez-la. La clé complète n'est affichée qu'une seule fois : conservez-la en lieu sûr, par exemple dans votre gestionnaire de mots de passe.
- Ne placez pas la clé sous contrôle de version. Les exemples ci-dessous la lisent depuis une variable d'environnement.
Ce dont le serveur a besoin
Le serveur lit les en-têtes HTTP suivants :
| En-tête | Valeur |
|---|---|
X-API-Key | Votre clé API CPQ DevKit™ |
X-Oracle-CPQ-Base-URL | L'adresse de votre site, par exemple https://yoursite.bigmachines.com |
X-Oracle-CPQ-Username | Nom d'utilisateur Oracle CPQ (avec X-Oracle-CPQ-Password) |
X-Oracle-CPQ-Password | Mot de passe Oracle CPQ |
X-Oracle-CPQ-Access-Token | Facultatif : un jeton d'accès OAuth Oracle CPQ, à la place du nom d'utilisateur et du mot de passe |
X-Oracle-CPQ-Rest-Base-Path | Facultatif : le chemin de base REST, si votre site n'utilise pas celui par défaut |
X-Oracle-CPQ-Api-Version | Facultatif : version de l'API REST, v19 par défaut |
Pour chaque requête, le serveur appelle votre site Oracle CPQ avec l'adresse du site et les identifiants contenus dans cette requête. Les exemples ci-dessous utilisent les variables d'environnement suivantes. Définissez-les dans le profil de votre shell, puis redémarrez votre éditeur ou votre terminal :
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
Ajoutez le serveur avec une seule commande, à exécuter dans le dossier de votre projet :
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"
Votre shell remplace les variables par leurs valeurs, et Claude Code les enregistre dans ses propres paramètres, pour ce projet uniquement. Ajoutez --scope user pour utiliser le serveur dans tous vos projets.
Pour partager la configuration avec votre équipe sans partager de secrets, ajoutez plutôt un fichier .mcp.json à la racine du projet. Claude Code lit les valeurs dans les variables d'environnement de chaque personne :
{
"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}"
}
}
}
}
Exécutez claude mcp list pour vérifier que le serveur est connecté, ou tapez /mcp dans une session Claude Code. La première fois, Claude Code vous demande d'approuver les serveurs déclarés dans le fichier .mcp.json d'un projet.
Cursor
Créez .cursor/mcp.json dans votre projet, ou ~/.cursor/mcp.json dans votre dossier personnel pour utiliser le serveur dans tous vos projets :
{
"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 remplace ${env:…} par les valeurs de votre environnement : définissez donc les variables dans le profil de votre shell et redémarrez Cursor. Ouvrez ensuite les Cursor Settings, repérez la section MCP et vérifiez que cpq-devkit-oracle affiche ses outils.
GitHub Copilot dans VS Code
La plupart des utilisateurs de VS Code n'ont pas besoin de cette section : l'extension configure le serveur pour vous, comme décrit plus haut dans « Le plus simple : VS Code ». Optez pour une configuration manuelle si vous ne souhaitez pas installer l'extension, ou pour vous connecter à un autre site que celui de l'environnement actif de l'extension.
Créez .mcp.json à la racine de votre espace de travail :
{
"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": ["*"]
}
}
}
Pour une configuration valable dans tous les espaces de travail, placez la même entrée mcpServers dans ~/.copilot/mcp-config.json. VS Code lit les valeurs ${NAME} dans l'environnement à partir duquel il a été lancé : définissez donc d'abord les variables, puis lancez VS Code. Les anciennes configurations utilisaient .vscode/mcp.json avec une clé servers ; VS Code recommande désormais .mcp.json pour les nouvelles configurations.
Pour vérifier le serveur, ouvrez le sélecteur d'outils dans la vue Chat et assurez-vous que le serveur et ses outils sont sélectionnés.
Exemples de prompts
Ces prompts utilisent des outils de lecture, qui fonctionnent avec le plan Free :
- "Listez les tables de données de mon site Oracle CPQ."
- "Affichez les lignes de la table de données
PartPricingdont le numéro de pièce contientSRV." - "Quels catalogues de prix sont configurés sur mon site ?"
Ces prompts utilisent des outils d'agent, qui nécessitent un plan Pro :
- "Listez les fonctions de la bibliothèque util BML de mon site Oracle CPQ, regroupées par dossier."
- "Récupérez la fonction util
calculateDiscountet vérifiez si elle contient des requêtes BMQL dans des boucles ou des appels à des fonctions qui n'existent pas."
Remplacez les noms de fonction et de table par ceux de votre site. Pour vérifier d'abord la connexion, demandez à l'agent de lister vos tables de données : s'il répond avec des tables de votre site, le serveur est connecté. Avec un plan Pro, vous pouvez aussi demander : "À quel site Oracle CPQ le serveur MCP CPQ DevKit est-il connecté ?" L'agent répond avec l'adresse du site et la méthode de connexion, jamais avec des mots de passe ou des jetons.
Ce qui nécessite Pro
Les outils de lecture, par exemple ceux des tables de données, des pièces, des catalogues de prix, de la configuration Commerce et des utilisateurs, sont gratuits dans la limite d'un quota mensuel : 100 appels par mois avec le plan Free et 10 000 avec Pro. Chaque outil exécuté par votre agent compte pour un appel ; la connexion et l'affichage de la liste des outils ne sont pas comptés.
Ces outils nécessitent un plan Pro :
- Outils d'écriture :
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 - Outils de traitement en masse :
get_all_data_table_data,get_all_endpoint_data,get_openapi_spec,get_performance_logs,get_performance_log - Outils d'agent :
describe_environment,list_bml_functions,get_bml_function,list_bml_folders,list_integrations,review_bml. Ils permettent à votre agent de parcourir et de vérifier les fonctions BML, et de décrire le site connecté.
Avec le plan Free, le serveur répond à ces outils par un message indiquant que Pro est requis, et rien n'est envoyé à votre site. Les outils d'écriture modifient votre site Oracle CPQ : vérifiez donc ce que l'agent prévoit de faire avant d'approuver un appel.
Dépannage
- "Please provide an API key" : l'en-tête
X-API-Keyest absent. Vérifiez que la variable d'environnement est définie dans l'environnement à partir duquel votre éditeur ou votre terminal a été lancé. - "Missing required Oracle CPQ headers" : ajoutez
X-Oracle-CPQ-Base-URLainsi que, soit un nom d'utilisateur et un mot de passe, soit un jeton d'accès. - "The provided API key is invalid or expired" : créez une nouvelle clé sur app.cpqdevkit.com et mettez à jour votre variable d'environnement.
- "Monthly usage limit reached" : vous avez utilisé tous les appels de votre plan pour ce mois-ci.
Des questions ou un problème ? Écrivez à sales@cpqdevkit.com. Consultez la politique de confidentialité pour savoir comment nous traitons les données.