CData Connect AI 経由で Claude Code と Paylocity のデータを統合

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData Connect AI を活用して、Claude Code からPaylocity のデータにセキュアにアクセスし、アシステッドコーディングや自動化開発ワークフロー内でアクションを実行できるようにします。

Claude Code は、インテリジェントなコード生成、自動化、インタラクティブな推論をワークフローに直接もたらす AI 搭載の開発環境です。CData Connect AI と統合することで、Claude Code から標準化された MCP ツールインターフェースを通じて、Paylocity などのライブエンタープライズデータにセキュアにアクセス、クエリ、操作できるようになります。

CData Connect AI は、Model Context Protocol（MCP）を通じてエンタープライズデータソースを公開するマネージド MCP プラットフォームです。これにより Claude Code は、ETL パイプラインやカスタム統合コードを必要とせずに、350 以上のデータソースからカタログ、スキーマ、テーブル、メタデータ、SQL 対応のデータアクセスを操作できます。

この記事では、Claude Code に CData Connect AI MCP エンドポイントを登録し、Paylocity やその他のデータソース接続を設定し、コーディング環境から直接リアルタイムデータクエリを発行する方法を説明します。Claude Code が getCatalogs、getSchemas、getTables、queryData などの組み込み MCP ツールを使用して、ライブPaylocity のデータをセキュアかつインタラクティブに活用しながらコードの作成、デバッグ、開発ワークフローの自動化を支援する方法を探ります。

前提条件

ステップ 1：Claude Code 用に Paylocity への接続を設定

Claude Code が Paylocity にアクセスするには、CData Connect AI で Paylocity への接続を作成します。この接続は Remote MCP Server を介して Claude Code に公開されます。

  1. Connect AI にログインし、Sources をクリック、次に + Add Connection をクリック
  2. 利用可能なデータソースから Paylocity を選択
  3. Paylocity に接続するために必要な認証プロパティを入力します。

    Paylocity への接続を確立するには以下を設定します。

    • RSAPublicKey：Paylocity アカウントでRSA 暗号化が有効になっている場合は、Paylocity に関連付けられたRSA キーを設定。

      このプロパティは、Insert およびUpdate ステートメントを実行するために必須です。この機能が無効になっている場合は必須ではありません。

    • UseSandbox：サンドボックスアカウントを使用する場合はTrue に設定。
    • CustomFieldsCategory：Customfields カテゴリに設定。これは、IncludeCustomFields がtrue に設定されている場合は必須です。デフォルト値はPayrollAndHR です。
    • Key：Paylocity の公開鍵で暗号化されたAES 共通鍵（base 64 エンコード）。これはコンテンツを暗号化するためのキーです。

      Paylocity は、RSA 復号化を使用してAES 鍵を復号化します。
      これはオプションのプロパティで、IV の値が指定されていない場合、ドライバーは内部でキーを生成します。

    • IV：コンテンツを暗号化するときに使用するAES IV（base 64 エンコード）。これはオプションのプロパティで、Key の値が指定されていない場合、ドライバーは内部でIV を生成します。

    OAuth

    OAuth を使用してPaylocity で認証する必要があります。OAuth では認証するユーザーにブラウザでPaylocity との通信を要求します。詳しくは、ヘルプドキュメントのOAuth セクションを参照してください。

    Pay Entry API

    Pay Entry API はPaylocity API の他の部分と完全に分離されています。個別のクライアントID とシークレットを使用し、アカウントへのアクセスを許可するにはPaylocity から明示的にリクエストする必要があります。 Pay Entry API を使用すると、個々の従業員の給与情報を自動的に送信できます。 Pay Entry API によって提供されるものの性質が非常に限られているため、CData では個別のスキーマを提供しないことを選択しましたが、UsePayEntryAPI 接続プロパティを介して有効にできます。

    UsePayEntryAPI をtrue に設定する場合は、CreatePayEntryImportBatch、MergePayEntryImportBatch、Input_TimeEntry、およびOAuth ストアドプロシージャのみ利用できることに注意してください。 製品のその他の機能を使用しようとするとエラーが発生します。また、OAuthAccessToken を個別に保存する必要があります。これは、この接続プロパティを使用するときに異なるOAuthSettingsLocation を設定することを意味します。

  4. 「Save & Test」をクリック
  5. 認証が完了したら、Paylocity 接続の Permissions タブを開き、必要に応じてユーザーベースのアクセス許可を設定します。

Personal Access Token（PAT）の生成

Claude Code はアカウントのメールアドレスと Personal Access Token（PAT） を使用して Connect AI に認証します。アクセス制御の粒度を維持するために、統合ごとに個別の PAT を作成することをお勧めします。

  1. Connect AI で、右上の 歯車アイコン を選択して Settings を開きます。
  2. Access Tokens で Create PAT を選択します。
  3. トークンの説明的な名前を入力し、Create を選択します。
  4. トークンをコピーして安全に保存します。PAT は作成時にのみ表示されます。

Paylocity 接続と PAT が設定できたので、Claude Code は CData MCP サーバー経由でPaylocity のデータに接続する準備が整いました。

ステップ 2：Claude Code をインストール

Claude Code は npm パッケージとして配布されています。グローバルにインストールできます。

システムに Claude Code をインストールするには、PowerShell、ターミナル、または CMD を 管理者として 開き、以下を実行します:

npm install -g @anthropic-ai/claude-code

以下のコマンドでインストールを確認します:

npm list -g @anthropic-ai/claude-code

期待される出力:

C:\Users\User\AppData\Roaming
pm
`-- @anthropic-ai/[email protected]

ステップ 3：Claude Code を Claude.ai で認証

ローカルの Claude Code 環境を Claude.ai アカウントにリンクしてセキュアなアクセスを有効にします。ターミナルで以下を実行:

claude login

Claude Code は以下のような URL を出力します:

Please visit https://claude.ai/login?code=

以下のステップに従います:

  1. URL をクリックするか、ブラウザに貼り付けます。
  2. Claude.ai にログインします。
  3. Claude.ai に verification code が表示されます。
  4. ターミナルに戻り、プロンプトが表示されたら提供された verification code を入力/貼り付けます。

確認が完了したら、authentication code を使用して Claude Code で認証する必要があります。完了すると、ターミナルに以下が表示されます:

You're all set up for Claude Code.

Claude Code が Claude.ai アカウントにリンクされました。

ステップ 4：Claude Code プロジェクトを作成

Claude Code が MCP 設定ファイルを保存できるワークスペースを設定するには、まず新しいディレクトリを作成します:

mkdir ClaudeCode
cd ClaudeCode

次に、Visual Studio Code で開きます:

code .

ステップ 5：Claude Code を起動して CData Connect AI MCP サーバーを登録

Claude Code が Paylocity とやりとりする前に、CData Connect AI MCP エンドポイントを登録する必要があります。Claude Code はこの Remote MCP Server を使用して、メタデータ、スキーマ、テーブル、ライブクエリ結果にセキュアにアクセスします。

Claude Code プロジェクトディレクトリで以下のコマンドを実行して、CData Connect AI MCP サーバーを登録します:

claude mcp add connectmcp https://mcp.cloud.cdata.com/mcp \
  --transport http \
  --header "Authorization: Basic base64encoded(EMAIL:PAT)" \
  --header "Content-Type: application/json"

追加後、Claude が MCP サーバーを認識していることを確認します:

claude mcp list

成功すると、以下が表示されます:

connectmcp: https://mcp.cloud.cdata.com/mcp (HTTP) - ✓ OK

Claude Code アシスタントを起動し、MCP サーバーを検出していることを確認します。実行するには以下のコマンドを使用:

claude

Claude Code がロードされると、以下が表示されます:

Loaded MCP Server: connectmcp

これで Claude Code が CData Connect AI インスタンスに接続されました。

ステップ 6：Paylocity メタデータを探索

Claude Code の自然言語インターフェースを使用して、Paylocity のカタログ、スキーマ、テーブルを一覧表示できます。Claude に質問してみましょう:

List all Paylocity catalogs using getCatalogs.

リクエストを発行すると、Claude は自動的に適切な MCP ツールを呼び出します。

追加のクエリも試してみてください:

  • 「利用可能なスキーマを表示して」
  • 「Paylocity 接続のすべてのテーブルを一覧表示して」
  • 「Account テーブルから上位 10 件のレコードを取得して」

Claude Code は以下の MCP ツールを使用して Paylocity とリアルタイムでやりとりします:

  • getCatalogs
  • getSchemas
  • getTables
  • queryData

これらのツールにより、Claude Code はメタデータの取得とライブPaylocity のデータのクエリが可能になります。

ステップ 7：コードと自動化ワークフローを生成

実際の Paylocity メタデータを使用して、IDE 内で直接動作するスクリプトを構築します。

プロンプトの例:

Write a Python script that queries Salesforce Contacts where LastName starts with 'A' using the MCP queryData tool.

Claude Code が正確なコードを記述できる理由:

  • Paylocity スキーマへの直接アクセス
  • ライブクエリテスト
  • メタデータイントロスペクション

すべて CData Connect AI を通じて提供されます。

ステップ 8：データ駆動型開発ワークフローを構築

Claude Code を使用して、CData Connect AI でPaylocity のデータを操作するコードを生成、改善、自動化します。

CData Connect AI 統合が設定されたので、Claude Code はPaylocity のデータに依存する開発ワークフローの構築を支援できます。Claude Code には組み込みのリアルタイムデータ接続は含まれていませんが、CData Connect AI を通じた MCP 接続設定により、リクエストに対するメタデータとクエリ結果へのアクセスが提供されます。

Claude Code を使用して以下のようなタスクを自動化できます:

  • データ探索用スクリプトの生成
  • 統合テストスキャフォールディングの作成
  • Paylocity スキーマに対するクエリの検証
  • データ抽出や変換ワークフロー用のコード生成

このセットアップでは、Claude Code は CData Connect AI からのライブPaylocity のデータを使用して、データ駆動型ロジックの作成と改善を支援するインテリジェントなコーディングアシスタントとして機能します。

オプション：MCP 統合を管理

プロジェクト内の MCP サーバーを追加、削除、検査します。

以下のコマンドで MCP サーバーを一覧表示:

claude mcp list

削除するには:

claude mcp remove connectmcp

設定を変更するには以下を編集:

.claude/mcp.json

CData Connect AI を入手

クラウドアプリケーションから直接 300 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを取得するには、CData Connect AI をお試しください。

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル お問い合わせ

この記事の内容

関連記事