【Code Assist MCP】PingOne × Claude Code 連携ガイド | AI でデータを徹底活用
Claude Code は、AI を活用したコマンドラインツールで、エージェント型のコーディングワークフローを実現します。MCP に対応しているため、ターミナルからローカルツールやエンタープライズデータソースに直接接続でき、コンテキストを切り替えることなくライブシステムと自然言語でやりとりできます。
Model Context Protocol(MCP)は、LLM クライアントを外部サービスに接続するためのオープンスタンダードです。MCP サーバーは、スキーマの検出やリアルタイムクエリなどの機能を提供し、AI エージェントがリアルタイムデータを安全かつ一貫した方法で取得・分析できるようにします。
この記事では、CData Code Assist MCP for PingOne のインストール、PingOne への接続設定、Code Assist MCP アドオンと Claude Code の連携、そしてターミナルからリアルタイムの PingOne のデータ をクエリする方法を順を追って解説します。
ステップ1:CData Code Assist MCP for PingOne のダウンロードとインストール
- まず、CData Code Assist MCP for PingOne をダウンロードします。
- ダウンロードしたインストーラーをダブルクリックして実行します。
- 画面の指示に従ってインストールを完了させます。
インストールが完了したら、PingOne への接続を設定して Code Assist MCP アドオンを構成していきましょう。
ステップ2:PingOne への接続を設定
- インストール完了後、CData Code Assist MCP for PingOne の設定ウィザードを開きます。
NOTE: ウィザードが自動的に起動しない場合は、Windows の検索バーで「CData Code Assist MCP for PingOne」を検索してアプリケーションを開いてください。
- MCP Configuration > Configuration Name で、既存の構成を選択するか、
を選んで新しい構成を作成します。
- 構成名を入力(例:「cdata_pingone」)し、OK をクリックします。
-
設定ウィザードで適切な接続プロパティを入力します。
PingOne に接続するには以下のプロパティを設定します。
- Region:自身のPingOne 組織のデータがホスティングされている地域。
- AuthScheme:PingOne に接続する際に使用する認証の種類。
- WorkerAppEnvironmentId (デフォルトのPingOne ドメインを使用する場合に必要)、またはAuthorizationServerURL のいずれかで、下で説明するように設定します。
WorkerAppEnvironmentId の設定
WorkerAppEnvironmentId は、Worker アプリケーションが存在するPingOne 環境のID です。 このパラメータは、環境がデフォルトのPingOne ドメイン(auth.pingone)を利用している場合のみ使用されます。 これは、ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、PingOne への認証に使用するカスタムOAuth アプリケーションを作成した後に設定します。
はじめに、このプロパティの値を見つけます。
- 自身のPingOne 組織のホームページからナビゲーションサイドバーに移動し、Environments をクリックします。
- OAuth / Worker のカスタムアプリケーションを作成した環境(通常はAdministrators)を見つけ、Manage Environment をクリックします。 環境のホームページが表示されます。
- 環境のホームページのナビゲーションサイドバーで、Applications をクリックします。
- リストから、OAuth またはWorker アプリケーションの詳細を見つけます。
-
Environment ID フィールドの値をコピーします。
以下の例に似たものになるはずです:
WorkerAppEnvironmentId='11e96fc7-aa4d-4a60-8196-9acf91424eca'
次に、WorkerAppEnvironmentId をEnvironment ID フィールドの値に設定します。
AuthorizationServerURL の設定
AuthorizationServerURL は、お使いのアプリケーションが配置されている環境のPingOne 認可サーバーのベースURL です。 このプロパティは、PingOne プラットフォームAPI ドキュメントで説明されているように、環境にカスタムドメインを設定した場合にのみ使用されます。 Custom Domains を参照してください。
OAuth でのPingOne への認証
PingOne はOAuth とOAuthClient 認証の両方をサポートしています。 上述の設定手順に加え、OAuth またはOAuthCliet 認証をサポートするために、さらに2つの手順を完了する必要があります。
- ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、カスタムOAuth アプリケーションを作成して設定します。
- ドライバーがデータモデル内のエンティティにアクセスできるようにするには、ヘルプドキュメントのAdministrator Roles での説明のとおり、使用するアドミンユーザー / ワーカーアプリケーションに対して正しいロールを設定していることを確認してください。
- 以下のサブセクションで説明されているように、選択した認証スキームと認証フローに適切なプロパティを設定します。
OAuth(認可コードグラント)
AuthScheme をOAuth に設定します。
デスクトップアプリケーション
OAuth アクセストークンの取得およびリフレッシュ
以下を設定して、接続してください。
- InitiateOAuth:GETANDREFRESH。繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要をなくすには、InitiateOAuth を使用します。
- OAuthClientId:カスタムOAuth アプリケーションを作成した際に取得したClient ID。
- OAuthClientSecret:カスタムOAuth アプリケーションを作成した際に取得したClient Secret。
- CallbackURL:カスタムOAuth アプリケーションの登録時に定義したリダイレクトURI。例:https://localhost:3333
接続すると、CData 製品 はデフォルトブラウザでPingOne のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。 ドライバーはこれでOAuth プロセスを完了します。
- ドライバーはPingOne からアクセストークンを取得し、それを使ってデータをリクエストします。
- OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。
ドライバーはアクセストークンの期限が切れると自動的にリフレッシュします。
Web アプリケーションやヘッドレスマシン、クライアントクレデンシャルグラントを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。
- Connect をクリックして、OAuth 経由で PingOne の認証を行います。
- 続いて、Save Configuration をクリックして Code Assist MCP アドオンの設定を保存します。
この操作により、Claude Code が Code Assist MCP アドオンの起動時に参照する .mcp 構成ファイルが作成されます。これで Code Assist MCP アドオンの設定が完了したので、次は Claude Code との連携を設定していきましょう。
ステップ3:Code Assist MCP アドオンを Claude Code に接続
- ターミナルを使って Claude Code CLI をインストールします。
- Claude Code の設定ファイル ~/.config/claude-code/config.json(または初期化後に表示されるパス)を開きます。
方法1:MCP 構成を手動で追加する
- お使いのエディターで mcp.json ファイルを開きます。
- 以下のコードを追加します。
{
"mcpServers" : {
"cdata_pingone" : {
"type" : "stdio",
"command" : "C:\Program Files\CData\CData Code Assist MCP for PingOne\jre\bin\java.exe",
"args" : [ "-Dfile.encoding=UTF-8", "-jar", "C:\Program Files\CData\CData Code Assist MCP for PingOne/lib/cdata.mcp.pingone.jar", "cdata_pingone" ],
"env" : {}
}
}
}
NOTE: command の値には、Java 17 以上の java.exe 実行ファイルのパスを指定してください。また、JAR のパスにはインストール済みの CData Code Assist MCP アドオンの .jar ファイルを指定します。最後の引数は、CData 設定ウィザードで保存した MCP 構成名(例:「cdata_pingone」)と一致させる必要があります。
方法2:CData Code Assist MCP for PingOne の UI から MCP 構成をコピーする
- 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。
- AI MCP Tool ドロップダウンから Claude Code を選択します。
- Copy JSON をクリックして、生成された MCP 構成をクリップボードにコピーします。
- コピーした JSON を mcp.json ファイルに貼り付けます。
ステップ4:Claude Code で接続を確認
Claude Code には、アプリケーションの構築を開始する前に接続が有効であることを確認するためのツールが用意されています。
- ターミナルを開いてプロジェクトディレクトリに移動し、claude mcp list コマンドを実行します。
- 構成名が Connected ステータスで表示されていることを確認します。
- claude を実行して Claude Code を起動します。
- Claude Code セッション内で /mcp と入力して、アクティブなサーバーを確認します。
ステップ5:Claude Code でリアルタイムの PingOne のデータ をクエリ
接続が確認できたら、自然言語のプロンプトを使ってリアルタイムの PingOne のデータ をクエリしたり操作したりできます。
- まず、Claude Code に MCP 接続の手順を確認するようプロンプトを入力し、コード生成時に適切なコンテキストが参照されるようにします。
- あとは自然言語のプロンプトで開発を進めるだけです。例えば:
For my project, data from the [CData].[Administrators].Users is very important. Pull data from the most important columns like Id and Username.
Claude Code は MCP アドオンを通じて PingOne に接続し、リクエストされたデータを取得して、ターミナル上に直接結果を表示します。
Code Assist MCP で構築。CData Drivers で本番運用。
Code Assist MCP を無料でダウンロードして、開発中にリアルタイムの PingOne のデータ へのスキーマ対応アクセスを AI ツールに提供しましょう。本番環境への移行時には、CData PingOne Drivers が同じ SQL ベースのアクセスをエンタープライズグレードのパフォーマンス、セキュリティ、信頼性で実現します。
CData コミュニティにアクセスして、インサイトの共有や質問、MCP を活用した AI ワークフローの可能性を探索しましょう。