【MCP Server】SmartHR × Claude Code 連携ガイド：CData MCP Server で AI 駆動のアプリ開発

Anusha M B
Anusha M B
Technical Marketing Engineer
CData CData API Driver for MCP Server を使って、Claude Code からリアルタイムの SmartHR のデータを探索し、SmartHR のデータを活用したアプリケーション開発を支援する方法を解説します。



Claude Code は、ターミナル上で動作する AI 搭載のコマンドラインツールで、エージェント型のコーディングワークフローを実現します。MCP に対応しているため、Claude Code はローカルツールやエンタープライズデータソースにターミナルから直接接続でき、コンテキストを切り替えることなくライブシステムと自然言語でやり取りできます。

Model Context Protocol（MCP）は、構造化されたツールインターフェースを通じて LLM クライアントを外部サービスに接続するためのオープンスタンダードです。MCP Server はスキーマの検出やリアルタイムクエリなどの機能を公開し、AI エージェントがリアルタイムデータを安全かつ一貫して取得・分析できるようにします。

この記事では、CData API Driver for MCP Server のインストール、SmartHR への接続設定、Claude Code への MCP Server アドオンの接続、そしてターミナル内からリアルタイムの SmartHR のデータをクエリする方法までをステップバイステップで解説します。

ステップ 1：CData API Driver for MCP Server のダウンロードとインストール

  1. まずは CData API Driver for MCP Server をダウンロードします。
  2. ダウンロードしたインストーラーをダブルクリックして実行します。
  3. 画面の指示に従ってインストールを完了させます。

インストールが完了したら、SmartHR に接続して MCP Server アドオンの設定を行います。

ステップ 2：SmartHR への接続を設定

  1. インストール後、CData API Driver for MCP Server の設定ウィザードを開きます。

    注意：ウィザードが自動的に開かない場合は、Windows の検索バーで「CData API Driver for MCP Server」と検索し、アプリケーションを起動してください。

  2. MCP Configuration > Configuration Name で、既存の構成を選択するか、 を選択して新しい構成を作成します。
  3. 構成名を入力（例：「cdata_api」）し、OK をクリックします。

  4. 設定ウィザードに適切な接続プロパティを入力します。

    SmartHR に接続するには、SmartHR API トークンとTenantId が必要です。API トークンはSmartHR のアプリケーション統合ページで生成できます。トークンを取得したら、ProfileSettings API Key 接続プロパティに指定してください。TenantId は自身のSmartHR ページのURL「https://1234567890.smarthr.jp/」で確認できます（ここでは「1234567890」）。もしSandbox 環境を使用する場合は、接続プロパティにUseSandbox=true を設定してください。

    次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

  5. 接続 をクリックして、OAuth 経由で SmartHR と認証します。
  6. 次に、Save Configuration をクリックして MCP Server アドオンの構成を保存します。

この操作により、Claude Code が MCP Server アドオンを起動する際に参照する .mcp 構成ファイルが作成されます。MCP Server アドオンの設定が完了したら、続いて Claude Code に接続していきましょう。

ステップ 3：MCP Server アドオンを Claude Code に接続

  1. ターミナルから Claude Code CLI をインストールします。
  2. Claude Code の構成ファイル ~/.config/claude-code/config.json（または初期化後に表示されるパス）を開きます。

方法 1：MCP 構成を手動で追加

  1. mcp.json ファイルをお好みのエディタで開きます。
  2. 以下のコードを追加します。
    3. {
"mcpServers" : {
  "cdata_api" : {
    "type" : "stdio",
    "command" : "C:\Program Files\CData\CData API Driver for MCP Server\jre\bin\java.exe",
    "args" : [ "-Dfile.encoding=UTF-8", "-jar", "C:\Program Files\CData\CData API Driver for MCP Server/lib/cdata.mcp.api.jar", "cdata_api" ],  
    "env" : {}
  }
}
}

    注意：command の値は Java 17 以上の java.exe 実行ファイルのパスを、JAR パスにはインストール済みの CData MCP Server アドオンの .jar ファイルのパスを指定してください。最後の引数は、CData 設定ウィザードで保存した MCP 構成名と一致させる必要があります（例：「cdata_api」）。

方法 2：CData API Driver for MCP Server の UI から MCP 構成をコピー

  1. 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。
  2. AI MCP Tool ドロップダウンから Claude Code を選択します。
  3. Copy JSON をクリックして、生成された MCP 構成をクリップボードにコピーします。
  4. コピーした JSON を mcp.json ファイルに貼り付けます。

ステップ 4：Claude Code で接続を確認

Claude Code には、ビルド開始前に接続がアクティブであることを確認するためのツールが用意されています。

  1. ターミナルを開き、プロジェクトディレクトリに移動して claude mcp list コマンドを実行します。
  2. 構成名が Connected ステータスで表示されることを確認します。
  3. claude コマンドを実行して Claude Code を起動します。
  4. Claude Code セッション内で /mcp と入力し、アクティブなサーバーを確認します。

ステップ 5：Claude Code でリアルタイムの SmartHR のデータをクエリ

接続が確認できたら、自然言語のプロンプトを使ってリアルタイムの SmartHR のデータをクエリ・操作できます。

  1. Claude Code に MCP 接続の手順を確認するようプロンプトを入力し、コード記述時に適切なコンテキストが揃っていることを確認します。
  2. 自然言語のプロンプトでビルドを開始しましょう！例えば： 
    プロジェクトでは Departments のデータが非常に重要です。Name や Position などの主要なカラムからデータを取得してください。

Claude Code は MCP アドオンを使用して SmartHR に接続し、リクエストされたデータを取得して、ターミナル上に直接結果を表示します。

AI を業務データにつなげて、業務を圧倒的に効率化！

MCP Server を無料でダウンロードして、AI ツールに開発中のリアルタイム SmartHR のデータへのスキーマ対応アクセスを提供しましょう。本番環境への移行準備が整ったら、CData SmartHR Drivers がエンタープライズグレードのパフォーマンス、セキュリティ、信頼性を備えた同等の SQL ベースアクセスを提供します。

CData コミュニティにアクセスして、洞察を共有したり、質問したり、MCP を活用した AI ワークフローの可能性を一緒に探っていきましょう。

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

API Driver で SmartHR のライブデータに接続

SmartHR に接続

この記事の内容

関連記事