GooseとConnect AI経由でUKG Pro HCM のデータを連携
Goose は、お使いのマシン上でローカルに動作するオープンソースの AI エージェントで、幅広い LLM プロバイダーに対応しています。拡張機能（Extensions）のフレームワークを通じて Model Context Protocol（MCP）をサポートしているため、外部ツールやデータソースを追加して、モデルの学習データを超えたリアルタイムのシステムにエージェントからアクセスできます。
Goose を組み込みの MCP Server 経由で CData Connect AI と連携すると、Goose はガバナンスの効いたリアルタイムのUKG Pro HCM のデータへのアクセスが可能になります。自然言語のプロンプトでUKG Pro HCM のデータのカタログ一覧表示、スキーマ探索、レコードのクエリが行え、すべてのデータアクセスは認可されたソースに対してセキュアに実行されます。
この記事では、Connect AI での UKG Pro HCM 接続設定、必要な Personal Access Token の生成、Goose のインストールとセットアップ、Connect AI MCP Server をカスタム拡張機能として追加する手順、そして Goose のチャットからリアルタイムUKG Pro HCM のデータをクエリして連携を確認する方法をご紹介します。
ステップ 1：Goose 用に UKG Pro HCM への接続を設定
Goose から UKG Pro HCM への接続は、Connect AI の Remote MCP Server を通じて実現されます。Goose からUKG Pro HCM のデータを操作するために、まず Connect AI で UKG Pro HCM のコネクションを作成・設定していきましょう。
- Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
- Add Connection パネルから UKG Pro HCM を選択
-
UKG Pro HCM に接続するために必要な認証プロパティを入力します。
まず、Profile 接続プロパティをディスク上の UKGProHCM プロファイルの場所に設定します（例：C:\profiles\UKGProHCM.apip）。次に、ProfileSettings 接続プロパティを UKGProHCM の接続文字列に設定します（以下を参照）。
UKGProHCM API プロファイル設定
UKG Pro HCM では、Basic 認証とカスタマー API キーを組み合わせて API へのアクセスを認可します。接続には、UKG Pro HCM の認証情報と、UKG が発行したカスタマー API キーが必要です。
認証するには、以下の接続プロパティを設定します。
- AuthScheme：Basic に設定します。
- User：UKG Pro HCM のユーザー名に設定します。
- Password：UKG Pro HCM のパスワードに設定します。
- ProfileSettings：以下の項目をセミコロン区切りで指定します。
- Host：UKG Pro HCM テナントのホスト名（例：yourcompany.ultipro.com）。
- CustomerAPIKey：UKG のカスタマー API キー。各 API 呼び出しで US-CUSTOMER-API-KEY リクエストヘッダーとして渡されます。
カスタマー API キーの入手方法については、UKG Pro HCM の管理者にお問い合わせいただくか、UKG Developer Portal（https://developer.ukg.com）をご参照ください。
- 「Save & Test」をクリック
- Permissions タブに移動し、ユーザーベースの権限を更新
Personal Access Token の追加
Personal Access Token（PAT）は、Goose から Connect AI への接続を認証するために使用します。アクセス制御の粒度を維持するために、連携ごとに個別の PAT を作成することをおすすめします。
- Connect AI アプリ右上の歯車アイコン（）をクリックして Settings を開く
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック
- PAT にわかりやすい名前を付けて Create をクリック
- 表示されたトークンをコピーして安全に保管してください。一度しか表示されません
UKG Pro HCM のコネクションと PAT の設定が完了しました。これで Goose は Connect AI 経由でUKG Pro HCM のデータに接続する準備が整いました。
ステップ 2：Goose をインストールしてセットアップ
次に Goose をインストールし、LLM プロバイダーを選択して、Connect AI Remote MCP Server をカスタム拡張機能として追加します。これで、エージェントが Connect AI 経由でリアルタイムデータのツールを検出・呼び出せるようになります。
- 公式のインストールガイドに従って Goose をダウンロード・インストールし、アプリケーションを起動します
-
Welcome to goose 画面で AI プロバイダーを選択します。ローカルモデルを使う場合は Use Free/Local Providers、OpenAI、Anthropic、Google などのプロバイダーを設定する場合は Connect to a Provider を選択し、必要な API キーを入力します
-
左ナビゲーションで Extensions をクリックし、+ Add custom extension をクリック
-
拡張機能のダイアログで、以下の値を設定します：
- Extension Name： CData MCP、または任意の名前
- Type： Streamable HTTP
- Endpoint： https://mcp.cloud.cdata.com/mcp
-
Request Headers で以下の 2 つのヘッダーを追加し、それぞれ入力後に + Add をクリックします：
- Authorization： Basic your_base64_encoded_email_PAT
- Content-Type： application/json
注意：Goose は Connect AI との通信に Basic 認証を使用します。Connect AI のユーザーメールアドレスと前の手順で作成した PAT を email:PAT の形式で組み合わせ、その文字列を Base64 エンコードして先頭に Basic を付けてください。例えば [email protected]:ABC123...XYZ789 の場合、Authorization ヘッダーの値は Basic dXNlckBkb21haW4uY29tOkFCQzEyMy4uLlhZWjc4OQ== のような値になります
- Save をクリックして設定を保存
-
チャットに戻り、チャット入力欄の下にある拡張機能アイコンをクリックして、設定した MCP が有効になっていることを確認します
MCP サーバーの追加と LLM プロバイダーの設定が完了したので、Goose は Connect AI 経由でリアルタイムUKG Pro HCM のデータをクエリできる状態になりました。
ステップ 3：Goose からリアルタイム UKG Pro HCM のデータ をクエリ
連携設定が完了したら、Goose のチャットから、設定した LLM が処理する自然言語プロンプトでリアルタイムUKG Pro HCM のデータを操作してみましょう。
-
CData MCP 拡張機能を有効にした状態で、チャットにプロンプトを入力します。例：
- CData MCP のカタログを一覧表示して
- UKG Pro HCM で利用可能なスキーマとテーブルを表示して
- UKG Pro HCM のデータ のテーブルから上位 5 件のレコードをクエリして
-
Goose が Connect AI MCP Server を呼び出し、UKG Pro HCM のデータのリアルタイム結果を返します
これで Goose エージェントが Connect AI MCP Server と通信し、チャットから直接 Remote MCP ツールを通じてリアルタイムUKG Pro HCM のデータを取得できるようになりました。
CData Connect AI でビジネスシステムのデータ活用を今すぐスタート
いかがでしたか？Goose から UKG Pro HCM へのデータ連携が思ったより手軽にできたのではないでしょうか。業務に使えそう、と感じてくださった方は、CData Connect AI をぜひお試しください。 14 日間の無償トライアルで、クラウドアプリケーションから数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムアクセスを体験いただけます。ご不明点がございましたら、サポートチームまでお気軽にお問い合わせください。