Skip to content
VS Code にインストール

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 を使っている場合は、手動で設定する必要はありません。

  1. VS Code Marketplace から CPQ DevKit™ for Oracle をインストールします。
  2. コマンド パレットから Sign In を実行します。サインインすると CPQ DevKit™ の API キーが作成され、VS Code のシークレット ストレージに保存されます。
  3. プロジェクトをセットアップし、Oracle CPQ 環境を追加します。拡張機能が、アクティブな環境のサイトアドレスと認証情報を MCP サーバーに渡します。

これで VS Code に、GitHub Copilot 用の MCP サーバーとして CPQ DevKit™ for Oracle が表示されます。サーバーは起動時にアクティブだった環境を使用するため、環境を切り替えたらサーバーを再起動してください。

この自動セットアップは VS Code 向けです。Claude Code と Cursor はそれぞれ独自の MCP サーバー一覧を持っているため、以下の手順でサーバーを一度追加してください。

API キーを取得する

以下の手動セットアップには CPQ DevKit™ の API キーが必要です。

  1. app.cpqdevkit.com にサインインします。
  2. API キーを作成してコピーします。キー全体が表示されるのは一度だけなので、パスワード マネージャーなどの安全な場所に保管してください。
  3. キーはソース管理に含めないでください。以下の例では、キーを環境変数から読み込みます。

サーバーに必要な情報

サーバーは次の HTTP ヘッダーを読み取ります。

ヘッダー値
X-API-KeyCPQ DevKit™ の API キー
X-Oracle-CPQ-Base-URLサイトのアドレス(例: https://yoursite.bigmachines.com)
X-Oracle-CPQ-UsernameOracle CPQ のユーザー名(X-Oracle-CPQ-Password と組み合わせて使用)
X-Oracle-CPQ-PasswordOracle 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 プランで利用できます。

  1. 「Oracle CPQ サイトのデータテーブルを一覧表示してください。」
  2. 「PartPricing データテーブルから、部品番号に SRV を含む行を表示してください。」
  3. 「サイトにはどの価格表が設定されていますか?」

次のプロンプトはエージェントツールを使用するため、Pro プランが必要です。

  1. 「Oracle CPQ サイトの BML ユーティリティライブラリ関数を、フォルダーごとにまとめて一覧表示してください。」
  2. 「ユーティリティ関数 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 までご連絡ください。データの取り扱いについては、プライバシーポリシーをご覧ください。