Claude Code, Cursor और GitHub Copilot के साथ Oracle CPQ MCP server इस्तेमाल करें
अपने AI agent को hosted CPQ DevKit™ Oracle MCP server से connect करें, ताकि वह आपकी Oracle CPQ site से BML functions, data tables, commerce setup और बहुत कुछ पढ़ सके।
इस पेज पर
CPQ DevKit™ Oracle MCP server एक hosted Model Context Protocol server है, जो https://app.cpqdevkit.com/mcp/oracle पर उपलब्ध है। यह AI agent को आपकी Oracle CPQ site की जानकारी देखने के लिए tools देता है: BML util library functions, data tables, commerce processes और documents, parts, files, users, migration packages और बहुत कुछ। यह guide Claude Code, Cursor और VS Code में GitHub Copilot के लिए है।
शुरू करने से पहले
- REST API access वाली Oracle CPQ Cloud site (standalone BigMachines या Fusion Applications)। BML library tools के लिए REST v19 ज़रूरी है।
- एक Oracle CPQ user, जो REST API के ज़रिए वह data पढ़ सके जो आप agent को दिखाना चाहते हैं। इसके लिए एक अलग integration user रखना अच्छा रहता है।
- एक free CPQ DevKit™ account। आप इसे Oracle extension से या app.cpqdevkit.com पर बना सकते हैं।
- वह AI tool जो आप इस्तेमाल करना चाहते हैं: GitHub Copilot के साथ VS Code 1.109 या उससे नया, Claude Code, या Cursor।
सबसे आसान तरीका: VS Code
अगर आप VS Code में काम करते हैं, तो आपको कुछ भी हाथ से configure करने की ज़रूरत नहीं है:
- VS Code Marketplace से CPQ DevKit™ for Oracle install करें।
- Command Palette से Sign In चलाएँ। Sign in करने पर आपकी CPQ DevKit™ API key बनती है और VS Code secret storage में रखी जाती है।
- अपना project set up करें और अपना Oracle CPQ environment जोड़ें। Extension active environment का site address और credentials MCP server को भेजती है।
इसके बाद VS Code में GitHub Copilot के लिए CPQ DevKit™ for Oracle MCP server दिखने लगता है। Server वही environment इस्तेमाल करता है जो उसके start होते समय active था, इसलिए environment बदलने के बाद server को restart करें।
यह automatic setup VS Code के लिए है। Claude Code और Cursor अपनी अलग MCP server lists रखते हैं, इसलिए नीचे बताए तरीके से server को वहाँ एक बार जोड़ें।
API key पाएँ
नीचे दिए गए manual setups के लिए CPQ DevKit™ API key चाहिए:
- app.cpqdevkit.com पर sign in करें।
- एक API key बनाएँ और उसे copy करें। पूरी key सिर्फ़ एक बार दिखाई जाती है, इसलिए उसे किसी सुरक्षित जगह रखें, जैसे अपने password manager में।
- Key को source control से बाहर रखें। नीचे के examples key को एक environment variable से पढ़ते हैं।
Server को क्या चाहिए
Server ये HTTP headers पढ़ता है:
| Header | Value |
|---|---|
X-API-Key | आपकी CPQ DevKit™ API key |
X-Oracle-CPQ-Base-URL | आपकी site का address, उदाहरण के लिए https://yoursite.bigmachines.com |
X-Oracle-CPQ-Username | Oracle CPQ user name (X-Oracle-CPQ-Password के साथ) |
X-Oracle-CPQ-Password | Oracle CPQ password |
X-Oracle-CPQ-Access-Token | Optional: user name और password की जगह Oracle CPQ OAuth access token |
X-Oracle-CPQ-Rest-Base-Path | Optional: REST base path, अगर आपकी site default path इस्तेमाल नहीं करती |
X-Oracle-CPQ-Api-Version | Optional: REST API version, default रूप से v19 |
Server हर request में आए site address और credentials से, उसी request के लिए आपकी Oracle CPQ site को call करता है। नीचे के examples ये environment variables इस्तेमाल करते हैं। इन्हें अपने shell profile में set करें और फिर अपना editor या terminal restart करें:
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
एक ही command से server जोड़ें। इसे अपने project folder में चलाएँ:
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"
आपका shell values भर देता है, और Claude Code उन्हें सिर्फ़ इसी project के लिए अपनी settings में save करता है। हर project में server इस्तेमाल करने के लिए --scope user जोड़ें।
Secrets share किए बिना अपनी team के साथ setup share करने के लिए, इसकी जगह project root में एक .mcp.json file जोड़ें। Claude Code हर व्यक्ति के अपने environment variables से values पढ़ता है:
{
"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}"
}
}
}
}
Server connected है या नहीं, यह जाँचने के लिए claude mcp list चलाएँ, या Claude Code session में /mcp टाइप करें। Project की .mcp.json में दिए गए servers के लिए Claude Code पहली बार आपसे approval माँगता है।
Cursor
अपने project में .cursor/mcp.json बनाएँ, या हर project में server इस्तेमाल करने के लिए अपने home folder में ~/.cursor/mcp.json बनाएँ:
{
"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 ${env:…} को आपके environment से भरता है, इसलिए variables अपने shell profile में set करें और Cursor restart करें। फिर Cursor Settings खोलें, MCP section ढूँढें और देखें कि cpq-devkit-oracle अपने tools दिखा रहा है।
VS Code में GitHub Copilot
ज़्यादातर VS Code users को इस section की ज़रूरत नहीं है: जैसा ऊपर “सबसे आसान तरीका: VS Code” में बताया गया है, extension आपके लिए server set up कर देती है। अगर आप extension install नहीं करना चाहते, या extension के active environment के बजाय किसी दूसरी site से connect करना चाहते हैं, तो manual setup इस्तेमाल करें।
अपने workspace root में .mcp.json बनाएँ:
{
"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": ["*"]
}
}
}
ऐसे setup के लिए जो हर workspace पर लागू हो, वही mcpServers entry ~/.copilot/mcp-config.json में रखें। VS Code ${NAME} values उस environment से पढ़ता है जिसमें VS Code start हुआ था, इसलिए पहले variables set करें और फिर VS Code start करें। पुराने setups में servers key के साथ .vscode/mcp.json इस्तेमाल होती थी; अब VS Code नई configurations के लिए .mcp.json की सलाह देता है।
Server जाँचने के लिए Chat view में tools picker खोलें और पक्का करें कि server और उसके tools selected हैं।
Prompts के उदाहरण
ये prompts read tools इस्तेमाल करते हैं, जो Free plan पर काम करते हैं:
- "मेरी Oracle CPQ site की data tables की list बनाएँ।"
- "
PartPricingdata table की वे rows दिखाएँ जिनके part number मेंSRVहै।" - "मेरी site पर कौन-सी price books set up हैं?"
ये prompts agent tools इस्तेमाल करते हैं, जिनके लिए Pro plan चाहिए:
- "मेरी Oracle CPQ site के BML util library functions की list बनाएँ, folder के हिसाब से group करके।"
- "Util function
calculateDiscountलाएँ और review करें कि कहीं loops के अंदर BMQL queries या ऐसे functions के calls तो नहीं हैं जो मौजूद ही नहीं हैं।"
Function और table के नाम अपनी site के नामों से बदल दें। पहले connection जाँचना हो तो agent से अपनी data tables की list माँगें: अगर जवाब में आपकी site की tables आती हैं, तो server connected है। Pro plan पर आप यह भी पूछ सकते हैं: "CPQ DevKit MCP server किस Oracle CPQ site से connected है?" Agent जवाब में site address और sign-in method बताता है, passwords या tokens कभी नहीं।
किन चीज़ों के लिए Pro चाहिए
Read tools, जैसे data tables, parts, price books, commerce setup और users वाले tools, एक monthly limit तक free हैं: Free plan पर हर महीने 100 calls और Pro पर 10,000। आपका agent जो भी tool चलाता है, वह एक call गिना जाता है; connect करना और tools की list लेना नहीं गिना जाता।
इन tools के लिए Pro plan चाहिए:
- Write 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 - Agent tools:
describe_environment,list_bml_functions,get_bml_function,list_bml_folders,list_integrations,review_bml। इनसे आपका agent BML functions browse और review कर सकता है और connected site की जानकारी दे सकता है।
Free plan पर server इन tools के जवाब में यह message देता है कि Pro ज़रूरी है, और आपकी site पर कुछ भी नहीं भेजा जाता। Write tools आपकी Oracle CPQ site में बदलाव करते हैं, इसलिए किसी call को approve करने से पहले देख लें कि agent क्या करने वाला है।
समस्याएँ और समाधान
- "Please provide an API key":
X-API-Keyheader नहीं मिला। जाँचें कि environment variable उस environment में set है जिससे आपका editor या terminal start हुआ था। - "Missing required Oracle CPQ headers":
X-Oracle-CPQ-Base-URLजोड़ें, और साथ में या तो user name और password, या access token। - "The provided API key is invalid or expired": app.cpqdevkit.com पर नई key बनाएँ और अपना environment variable update करें।
- "Monthly usage limit reached": आप अपने plan के इस महीने के calls इस्तेमाल कर चुके हैं।
कोई सवाल या समस्या? sales@cpqdevkit.com पर लिखें। हम data को कैसे संभालते हैं, यह जानने के लिए privacy policy देखें।