ClaudeとVisierを連携する方法 — 人事データ分析の始め方
VisierのConnectorは、人事データ分析機能「Vee」への質問をClaudeから取り次ぐ連携です。2種類のツール群の違いと、Visier管理者側の準備、接続手順をまとめます。
ClaudeとVisierの連携とは — 何ができるか
Visierコネクタは、人事データ分析基盤Visierの会話型分析機能「Vee」に、Claudeから質問を取り次ぐConnectorです。開発元はVisier自身です。Connectorsディレクトリの「Data & analytics」カテゴリーに掲載され、Anthropicの検証を通過したVerifiedの表示が付いています。掲載ページの説明では、業績評価・従業員満足度・離職予測・主要人材の定着率の4つが質問の対象です。
導入前に押さえる点は3つあります。ツールは検索・集計・一覧取得で、掲載ページとVisierのドキュメントにデータを書き換えるツールは載っていません。利用にはVeeのサブスクリプションが必要です。そして接続は、Visier管理者の作業を挟みます。休暇や目標を書き込める人事連携はClaudeとBambooHRの連携です。
Veeツールとデータ照会ツールの違い
claude.comの掲載ページに並ぶツールは8つで、名前はすべて search_ aggregate_ list_ で始まります。一方、Visier側のドキュメントはツールを2系統に分けています。この区別が、回答の質と使い方を左右します。
Visier MCPの2系統のツール
Veeツール
質問の意図を読み、どのデータをどう引くかをVee自身が決めて答えを返します。Vee 2.0では「Ask Vee Agent Question」、従来のVeeでは「Ask Vee AI Assistant」と「Sample Vee Questions」です。ほとんどの利用者と用途にはこちらが向くと、Visierは説明しています。
データ照会ツール
Visierの公開データ照会APIを包んだ構造化ツールで、Veeは使いません。どのツールをどの順で呼び、結果をどう解釈するかをClaude側のAIが引き受けます。回答の質はClaudeの推論と依頼文の出来に左右されます。
データ照会ツールはVisierのドキュメント上は9つあり、検索・集計系に加えてGet Object Reference Graphが載っています。claude.comの掲載にある8つには、これに当たる名前が並びません。Veeツールも掲載ページの一覧には出てきません。
Visierによると、Claudeがデータ照会ツールで答えるのは、Veeが答えられない質問、利用者がVeeの使用を止めた場合、複数のツールを要する複雑な業務質問のときです。多くの質問はVeeツールが受けます。8つのツール名だけを見て、Claudeが集計手順を組み立てていると捉えると、実態とずれます。
ツールの有効・無効はVisier管理者が設定できます。既定は全クライアント共通のグローバル設定で、クライアントごとの上書きもできます。
Visierのドキュメントでは、設定の場所はModel > Settings > MCP Serverです。「Enable Data Query tools」「Enable Vee tools」「Enable MCP Apps」「Include underlying data」の4項目が並びます。「Enable Data Query tools」は、クライアントがVisierの公開データ照会APIに直接アクセスしてVeeを迂回することを許す設定です。データ照会ツールをVeeだけに絞りたいときは、この項目が操作の場所です。
つまずきを避ける接続の流れ
通常のディレクトリConnectorなら、claude.aiの「Customize」→「Connectors」でVisierを選んで接続し、サインインして権限を許可するだけです。Visierの場合は、その前にVisier管理者とClaudeのOwnerの作業が要ります。順番に並べると次のとおりです。
Visier側の準備からClaudeでの利用まで
- 1
Visier管理者が前提を整える
Visierのテナントにデータが読み込まれ、組織がAI機能にオプトインし、Veeが使える状態にします。AIエージェントごとに、OAuth 2.0のクライアントIDとシークレットを登録します。IDとシークレットを持つconfidential clientに対応したエージェントが条件です。
- 2
リダイレクトURIとサーバーURLを用意する
Claude側のコールバックURLは2つあります。
https://claude.ai/api/mcp/auth_callbackと、https://claude.com/api/mcp/auth_callbackです。サーバーURLはテナント名(vanity name)を使ったhttps://{vanity_name}.app.visier.com/visier-query-mcpの形です。 - 3
ClaudeのOwnerが組織にコネクタを追加する
Claudeの「Organization settings > Connectors」でVisierを選び、「Connect for your team」を押します。Visierの手順には、Admin settingsのConnectorsで「Add to your team」を押すと書かれています。サーバーURL、クライアントID、クライアントシークレットを入力して「Continue」で完了です。
- 4
Visier管理者がユーザーに権限を割り当てる
利用者のアカウントに、Query MCP Serverのケーパビリティを含む権限と、照会するデータへのアクセス権を付けます。Veeツールを使うなら、Vee CoreまたはVee 2.0も必要です。
- 5
メンバーが自分のアカウントで接続する
メンバーは「Customize」→「Connectors」でVisierを選んで接続し、Visierにサインインして許可します。
認証にはOAuth 2.0が使われます。アクセストークンの有効期間は60分で、クライアントが更新トークンで自動的に取り直します。更新トークンが期限切れになると再認証が必要です。更新トークンの有効期間はVisierのクライアント登録で決まります。アクセストークンの60分は変えられません。
Claude Codeから使うときは、Visierのドキュメントにある登録コマンドを使います。コールバックは http://localhost:{port}/callback の形で、ポートはVisier側に登録したものと合わせます。
claude mcp add --transport http \
--client-id {登録したクライアントID} --client-secret \
--callback-port {登録したポート} \
visier-query-mcp-server https://{vanity_name}.app.visier.com/visier-query-mcpシークレットは実行後に対話で入力します。その後 claude を起動し、/mcp から visier-query-mcp-server を選んで「Authenticate」を押すと接続できます。成功すると「Authentication successful. Connected to visier-query-mcp-server」と表示されます。
契約プランと権限の食い違いに注意する
ここまでで、条件が複数の場所に分かれていることが分かります。状況ごとに、どこがボトルネックになるかを切り分けると次のとおりです。
| 状況 | 起きること | 動く相手 |
|---|---|---|
| Teamのメンバーで、コネクタが組織に未追加 | 起きること「Connect」の代わりに「Request」が出る | 動く相手ClaudeのOwner |
| 組織には追加済みで、Visierの権限が未付与 | 起きることチャットで認証エラーが返る | 動く相手Visier管理者 |
| Vee subscriptionが無い | 起きることMCPの前提を満たさない | 動く相手Visierの契約窓口 |
Visierのセットアップ手順には、ClaudeでMCPサーバーを使うにはTeamまたはEnterpriseのプランが必要という注記があります。Claude側のディレクトリ文書も、TeamとEnterpriseではOwnerが組織向けにコネクタを追加し、メンバーが各自のアカウントで接続すると説明しています。
認証エラー・ツール実行エラーが出たとき
Visierのトラブルシューティング表には、Claudeでの症状別の対処があります。
- サインイン画面が出ない: VisierとClaudeの障害情報ページを見る
- サインイン後にアクセス拒否が出る: テナントのネットワークアクセス設定が、利用者のIPアドレスを制限していないかを見る
- サインイン画面のスピナーが止まらない: 「Settings > Connectors」で接続済みかを見る。接続済みなら、サインイン画面を閉じてよい
- チャットで認証エラーが返る: 利用者とテナントにMCPの権限があるかを見る。揃っているなら「Disconnect」してから「Connect」し直す
- ツール実行エラーが返る: ツール実行ウィンドウの赤いアイコンにカーソルを合わせると、エラーの中身が出る。パラメーターのエラーなら、Claudeに正しい引数を尋ねて同じ質問をやり直す
Visier側で権限を外したユーザーは、キャッシュの都合で、実際にアクセスを失うまでに最大1時間かかることがあります。
Veeが対応する4つの観点
掲載ページの説明で、Veeが答える観点として挙げられているのは4つです。質問の例を添えると、次のようになります。
| 観点 | 質問例 |
|---|---|
| 業績評価(work performance) | 質問例今四半期、目標達成率が低いチームはどこですか |
| 従業員満足度(employee satisfaction) | 質問例直近のエンゲージメント調査で満足度が下がった部署は |
| 離職予測(attrition predictions) | 質問例今後半年で離職リスクが高いと推定される従業員は何人ですか |
| 主要人材の定着率(retention of key team members) | 質問例ハイパフォーマーの定着率を昨年と比較して教えて |
Visierのドキュメントは別の質問例として、定年が近い人数、成果上位者、人員コストの総額を挙げています。Googleカレンダーのような別のMCPと組み合わせ、成果上位者と下位者との会議時間を比べる例も載っています。
データ照会ツールを使う場合は、Visierが用意した3つのプロンプトも選べます。従業員分析、候補者分析、採用要件(リクエスト)分析の指示文です。ツールと違い、利用者が自分で呼び出す必要があり、プロンプトに未対応のクライアントもあります。
人事データを扱うときのセキュリティ
人事データは機微な情報です。Visierのドキュメントは、セキュリティの注意点にかなりの紙幅を割いています。
核になるのは「致命的な三つ組(lethal trifecta)」です。エージェントが私的データへのアクセス、信頼できない外部コンテンツへの接触、外部への通信の3つを同時に持つと、間接プロンプトインジェクションでデータが流出する恐れがあります。Visierは、1セッションで持たせる能力を2つまでにする「Rule of Two」を挙げています。3つとも要る場合は、人が監督して承認する形にします。
Visier MCPと同じエージェントに、信頼できないMCPサーバーを接続しないことも求められています。ツール同士は文脈を共有するため、別のツール経由で誤った情報を混ぜられると、Visierへの呼び出しが汚染された文脈の影響を受け、不正確なデータを取得する恐れがあるからです。
アクセス範囲について、Visierは「ユーザーはVisier上で本来アクセスできる範囲のデータにしかMCP経由でもアクセスできない」と書いています。Visier本体のロール設計が、そのまま閲覧範囲になります。MCP経由のVeeへの質問は、Veeのログに別のクライアント種別で残り、ほかの経路と見分けられます。
Verified表示は、Anthropicがツールの品質と互換性を検証した印です。ただしセキュリティ監査そのものではなく、開発元がツールを後から変更できる点は変わりません。Communityはスクリーニングのみ、Customは未レビューの自己追加という区分です。
全社のHR KPIと現場の勤怠データ、扱う粒度の違い
Visierが返すのは離職率や人員配置のような全社集計後のHR KPIで、結果は最後にVisierへデータが読み込まれた時点の状態です。さらにAPIのレート制限が適用され、超えた呼び出しは拒否されます。個々の打刻時刻や残業時間をその日のうちに追う用途には、この粒度と更新頻度では合わない可能性があります。
個別の勤怠データを週次で見る仕組みはCoworkで勤怠異常検知を週次自動化する方法で扱っています。同じ「人事データ」でも粒度が違うので、経営層向けのKPIの確認にはVisier、現場の打刻異常のチェックにはCoworkの週次タスクという分担が成り立ちます。
SmartHRやジョブカンのような労務SaaSには公式Connectorが無く、非公式MCPサーバー経由になります。違いはClaude人事労務連携ガイドにまとめました。採用前の候補者データなら、ClaudeとAshbyの連携が別の入口です。
Team・Enterpriseで申請フローを使う場合
Teamプランでコネクタを有効化する権限を持たないメンバーには、「Connect」の代わりに「Request」ボタンが出ます。押すとOwnerに申請が届き、ボタンは「Requested」に変わります。
Ownerは2か所で申請を見られます。1つ目は「Organization settings > Connectors」の「Requested by your team」欄です。2つ目は「Organization settings > Notifications」の「Requests」タブです。どちらからも、有効化か却下を選べます。Ownerは「Connect for your team」で、組織全員向けにコネクタを追加することもできます。
よくあるつまずき
質問しても該当する指標が出てこない
Visier MCPの前提は、データが読み込まれたテナントです。指標や分析対象がVisier側で構築されているかを、Visier管理者に先に尋ねます。
部署名を指定しても集計結果が返らない
データ照会ツールは、LLMが扱いやすいよう、次元のメンバーを上位だけ返す作りだとVisierは説明しています。絞り込みに使う名称は、Visier側に登録された名称に合わせます。掲載ページには search_filter_dimension_members というツールが載っているので、名前から、候補を先に引く使い方が考えられます。
Visierの返答が思った内容と違う
どのツールで答えたかで質が変わります。Veeツールを止めてデータ照会ツールだけにすると、Claudeが推論を担うため、依頼文の工夫が要ります。Veeで足りる質問なら、データ照会ツールを無効にしてVeeに寄せる選択肢があります。
まとめ
Visierコネクタは、導入の手間の大半がVisier側の登録と権限付与に集まる連携です。Claudeでの接続は数クリックですが、ClaudeのOwnerによる追加と、Visier管理者によるクライアント登録・権限付与が揃って初めて動きます。人事データを扱うので、致命的な三つ組を作らない構成かどうかを、ほかのMCPサーバーとの併用を含めて先に点検します。