Oracle CPQ MCP サーバーを Claude Code、Cursor、GitHub Copilot で使う
AI エージェントをホスト型の CPQ DevKit™ Oracle MCP サーバーに接続し、Oracle CPQ サイトの BML 関数、データテーブル、コマース設定などを読み取れるようにします。
このページの内容
CPQ DevKit™ Oracle MCP サーバーは、https://app.cpqdevkit.com/mcp/oracle で提供されるホスト型の Model Context Protocol サーバーです。AI エージェントに、Oracle CPQ サイトを参照するためのツールを提供します。対象は BML ユーティリティライブラリ関数、データテーブル、コマースプロセスとドキュメント、パーツ、ファイル、ユーザー、移行パッケージなどです。このガイドでは、Claude Code、Cursor、および VS Code の GitHub Copilot での設定方法を説明します。
始める前に
- REST API にアクセスできる Oracle CPQ Cloud サイト(スタンドアロンの BigMachines または Fusion Applications)。BML ライブラリのツールには REST v19 が必要です。
- エージェントに参照させたいデータを REST API 経由で読み取れる Oracle CPQ ユーザー。専用の連携用ユーザーを用意することをおすすめします。
- 無料の CPQ DevKit™ アカウント。Oracle 拡張機能から、または app.cpqdevkit.com で作成できます。
- 使用する AI ツール: VS Code 1.109 以降と GitHub Copilot、Claude Code、または Cursor。
いちばん簡単な方法: VS Code
VS Code を使っている場合は、手動で設定する必要はありません。
- VS Code Marketplace から CPQ DevKit™ for Oracle をインストールします。
- コマンド パレットから Sign In を実行します。サインインすると CPQ DevKit™ の API キーが作成され、VS Code のシークレット ストレージに保存されます。
- プロジェクトをセットアップし、Oracle CPQ 環境を追加します。拡張機能が、アクティブな環境のサイトアドレスと認証情報を MCP サーバーに渡します。
これで VS Code に、GitHub Copilot 用の MCP サーバーとして CPQ DevKit™ for Oracle が表示されます。サーバーは起動時にアクティブだった環境を使用するため、環境を切り替えたらサーバーを再起動してください。
この自動セットアップは VS Code 向けです。Claude Code と Cursor はそれぞれ独自の MCP サーバー一覧を持っているため、以下の手順でサーバーを一度追加してください。
API キーを取得する
以下の手動セットアップには CPQ DevKit™ の API キーが必要です。
- app.cpqdevkit.com にサインインします。
- API キーを作成してコピーします。キー全体が表示されるのは一度だけなので、パスワード マネージャーなどの安全な場所に保管してください。
- キーはソース管理に含めないでください。以下の例では、キーを環境変数から読み込みます。
サーバーに必要な情報
サーバーは次の HTTP ヘッダーを読み取ります。
| ヘッダー | 値 |
|---|---|
X-API-Key | CPQ DevKit™ の API キー |
X-Oracle-CPQ-Base-URL | サイトのアドレス(例: https://yoursite.bigmachines.com) |
X-Oracle-CPQ-Username | Oracle CPQ のユーザー名(X-Oracle-CPQ-Password と組み合わせて使用) |
X-Oracle-CPQ-Password | Oracle CPQ のパスワード |
X-Oracle-CPQ-Access-Token | 任意: ユーザー名とパスワードの代わりに使う Oracle CPQ の OAuth アクセストークン |
X-Oracle-CPQ-Rest-Base-Path | 任意: サイトが既定以外の REST ベースパスを使う場合のベースパス |
X-Oracle-CPQ-Api-Version | 任意: REST API のバージョン(既定は v19) |
サーバーは、各リクエストに含まれるサイトアドレスと認証情報を使って、そのリクエストの処理のために Oracle CPQ サイトを呼び出します。以下の例では次の環境変数を使用します。シェルのプロファイルで設定し、その後エディターまたはターミナルを再起動してください。
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
コマンド 1 つでサーバーを追加できます。プロジェクト フォルダーで実行してください。
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"
値はシェルによって展開され、Claude Code はそれをこのプロジェクト専用の設定として保存します。すべてのプロジェクトでサーバーを使うには --scope user を追加します。
シークレットを共有せずにチームで設定を共有したい場合は、代わりにプロジェクトのルートに .mcp.json ファイルを追加します。Claude Code は各メンバーの環境変数から値を読み込みます。
{
"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}"
}
}
}
}
サーバーが接続されているかどうかは、claude mcp list を実行するか、Claude Code のセッションで /mcp と入力して確認できます。プロジェクトの .mcp.json に定義されたサーバーについては、初回に Claude Code から承認を求められます。
Cursor
プロジェクトに .cursor/mcp.json を作成します。すべてのプロジェクトでサーバーを使う場合は、ホーム フォルダーに ~/.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:…} を環境から展開するため、シェルのプロファイルで変数を設定してから Cursor を再起動してください。その後 Cursor Settings を開き、MCP セクションで cpq-devkit-oracle のツールが表示されていることを確認します。
VS Code の GitHub Copilot
ほとんどの VS Code ユーザーには、このセクションは必要ありません。上記の「いちばん簡単な方法: VS Code」で説明したとおり、拡張機能がサーバーを自動で設定します。拡張機能をインストールしたくない場合や、拡張機能のアクティブな環境とは別のサイトに接続したい場合は、手動で設定してください。
ワークスペースのルートに .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": ["*"]
}
}
}
すべてのワークスペースに適用する場合は、同じ mcpServers エントリを ~/.copilot/mcp-config.json に記述します。VS Code は ${NAME} の値を VS Code が起動された環境から読み込むため、先に変数を設定してから VS Code を起動してください。以前のセットアップでは servers キーを持つ .vscode/mcp.json が使われていましたが、現在 VS Code は新しい構成には .mcp.json を推奨しています。
サーバーを確認するには、チャット ビューでツール ピッカーを開き、サーバーとそのツールが選択されていることを確認します。
プロンプトの例
次のプロンプトは読み取りツールを使用するため、Free プランで利用できます。
- 「Oracle CPQ サイトのデータテーブルを一覧表示してください。」
- 「
PartPricingデータテーブルから、部品番号にSRVを含む行を表示してください。」 - 「サイトにはどの価格表が設定されていますか?」
次のプロンプトはエージェントツールを使用するため、Pro プランが必要です。
- 「Oracle CPQ サイトの BML ユーティリティライブラリ関数を、フォルダーごとにまとめて一覧表示してください。」
- 「ユーティリティ関数
calculateDiscountを取得し、ループ内の BMQL クエリや、存在しない関数の呼び出しがないかレビューしてください。」
関数名とテーブル名は、ご自身のサイトのものに置き換えてください。先に接続を確認したい場合は、データテーブルの一覧を表示するようエージェントに依頼してください。サイトのテーブルが返ってくれば、サーバーは接続されています。Pro プランでは、「CPQ DevKit MCP サーバーはどの Oracle CPQ サイトに接続されていますか?」と尋ねることもできます。エージェントはサイトアドレスとサインイン方法を回答し、パスワードやトークンを返すことはありません。
Pro が必要な機能
データテーブル、パーツ、価格表、コマース設定、ユーザーなどの読み取りツールは、月間の上限内であれば無料で使えます。上限は Free プランで月 100 コール、Pro で月 10,000 コールです。エージェントがツールを 1 回実行するごとに 1 コールとカウントされます。接続とツール一覧の取得はカウントされません。
次のツールには Pro プランが必要です。
- 書き込みツール:
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 - 一括ツール:
get_all_data_table_data,get_all_endpoint_data,get_openapi_spec,get_performance_logs,get_performance_log - エージェントツール:
describe_environment,list_bml_functions,get_bml_function,list_bml_folders,list_integrations,review_bml。エージェントが BML 関数を参照・レビューし、接続先サイトの情報を確認できます。
Free プランでは、これらのツールに対してサーバーは Pro が必要である旨のメッセージを返し、サイトには何も送信されません。書き込みツールは Oracle CPQ サイトに変更を加えるため、呼び出しを承認する前に、エージェントが何をしようとしているかを確認してください。
トラブルシューティング
- "Please provide an API key":
X-API-Keyヘッダーがありません。エディターまたはターミナルを起動した環境で、環境変数が設定されているか確認してください。 - "Missing required Oracle CPQ headers":
X-Oracle-CPQ-Base-URLに加えて、ユーザー名とパスワード、またはアクセストークンのいずれかを追加してください。 - "The provided API key is invalid or expired": app.cpqdevkit.com で新しいキーを作成し、環境変数を更新してください。
- "Monthly usage limit reached": ご利用のプランの今月のコール数を使い切りました。
ご質問や問題がありましたら、sales@cpqdevkit.com までご連絡ください。データの取り扱いについては、プライバシーポリシーをご覧ください。