ClaudeとJedifyを連携する方法 — セマンティック層への接続とロール別ツール

ClaudeからJedifyのデータに質問するには、Claudeのコネクタ一覧でJedifyを探して接続し、組織のJedifyアカウントでサインインします。インストールも設定ファイルの編集も要りません。

Jedifyは、指標・用語・業務ルール・接続元システムをひとつの「コンテキストグラフ」にまとめ、AIエージェントが正しい業務上の意味でデータを扱えるようにする製品です。Claudeのコネクタディレクトリでは「Data & analytics」「Productivity」「Sales & marketing」に分類され、サインインが必須です。この記事では、接続手順、ロールで決まるモード、質問系ツールの使い分け、APIキーで接続する場面、Claude Codeでの権限設定を順に扱います。

ClaudeのコネクタからJedifyに接続する

接続先のMCPサーバーURLは https://be.jedify.com/mcp です。EUでホストされている組織は、be.jedify.com の部分を be-eu.jedify.com に読み替えます。

TeamとEnterpriseでは、ワークスペースの管理者が組織に向けて一度有効にすると、全ユーザーに「接続済み」の状態で表示されます。接続したコネクタはWebアプリ、Claude Desktop、Claude Codeのどれでも使えます。Claude Codeでは /mcp を実行すると一覧に出ます。

コネクタ全般の仕組みはClaudeのコネクタとはにまとめています。

使えるモードは自分のロールで決まる

Jedify MCPには3つのモードがあります。接続時に選ぶ設定はなく、Jedify上のロールで自動的に決まります。

• Asker: 平易な言葉で質問し、データを返してもらう
• Editor: セマンティックレイヤーの変更をエージェントに作らせ、検証し、確認したうえで公開する
• Builder: セマンティック関数を使ってデータアプリやダッシュボードを作らせる

ロールはJedifyのSettings → Usersで管理されます。EditorやBuilderのツールが見えないときは、管理者にロールの確認を頼んでください。

Claudeのコネクタ経由では、モードを絞る設定はできません。得られるのは自分のロールのモードそのままです。

質問系のツールは目的別に使い分ける

コネクタのページには、次の16個のツールが載っています。Asker向けのツール群にあたり、役割ごとに分けると選びやすくなります。

wait_for_completion は、約3分で in_progress を返します。その場合、Claudeは同じIDでもう一度呼んで待ち続けます。長い調査が途中で止まったように見えても、異常とは限りません。

run_sql_query は、Claudeに「まれにしか使わないよう」指示されているツールです。主たる入口はあくまでセマンティック層で、素のSQLが必要な場面に限った抜け道という位置づけになります。

質問の仕方で呼ばれるツールが変わる

Jedifyのドキュメントは、プロンプトとツールの対応を次のように示しています。

「なぜ変わったのか」を掘る調査では ask_a_research_question が使われます。「調査して」「investigate」と言うと複数ステップの分析が始まる、とドキュメントのコツに書かれています。データソースが複数あるアカウントでは、対象のデータソースを名指しすると、Claudeが data_source_id として渡します。

共有リンクは公開URLではありません。開くには同じアカウントのJedifyログインが要ります。

Editorモードは公開の前に必ず確認が入る

DataとAnalyticsのチームに効くのはEditorモードです。新しい指標、関係、ディメンションを自然文で頼むと、Claudeが検証済みの保留中の変更を作ります。

Editorの編集は4段階で進みます。

needs_confirmation はエラーではなく、想定どおりの動きです。公開には必ずあなたの明示的な承認が要ります。Context Graph Versioningを有効にしていないアカウントでは、さらにData Expertが編集をJedify側で承認します。その場合、make_edit は status: "processing" を返し、Claudeが sl_get_edit_state をポーリングして各操作が confirmed になるのを待ちます。

APIキーで接続する場面

コネクタを使えないクライアントや、人が画面の前にいない環境では、別の経路があります。

ローカルのプロキシはNode.js 18以上が必要です。設定は次のとおりです。

{
  "mcpServers": {
    "jedify": {
      "command": "npx",
      "args": ["-y", "@jedify/mcp-auth"]
    }
  }
}

ブラウザのログインを省くなら、env に JEDIFY_API_KEY を足します。キーはJedifyのSettings → API Keysで作成し、表示されるのは一度だけです。プロキシがv1.1.0以上である必要があります。

APIキーには、ロールと食い違う仕様が2つあります。

• アプリで作ったキーは、ロールにかかわらずAskerモードで動く
• EditorやBuilderを使うなら、URLに ?mode=editor か ?mode=builder を付ける。ローカルのプロキシでは REMOTE_MCP_URL を https://be.jedify.com/mcp/message?mode=editor のように設定する

プロキシが叩くのは /mcp/message で、/mcp ではありません。ホスト型エージェントの接続先は https://be.jedify.com/mcp です。?mode= は絞るだけで広げられず、Userのアカウントに ?mode=editor を付けてもAskerのツールのままです。

Claude Codeで更新系のツールを止める

Claude Codeは、コネクタを接続済みなら /mcp でJedifyを使えます。JSON設定のプロキシ経路で追加する場合は、同じ内容をコマンドで登録する形も取れます。次は例です。

claude mcp add jedify -- npx -y @jedify/mcp-auth

Data expertやTenant Adminのロールでは、EditorとBuilderのツールも見えます。質問だけをさせたいなら、Claude Codeの権限ルールで公開系を拒否できます。MCPツールは mcp__<サーバー名>__<ツール名> で指定する決まりです。サーバー名は上で付けた jedify です。次は書き方の例です。

{
  "permissions": {
    "deny": [
      "mcp__jedify__publish_change",
      "mcp__jedify__make_edit",
      "mcp__jedify__restore_version"
    ]
  }
}

ここに並べたのはEditorモードのツール名です。Asker専用の運用なら、Jedify側でロールをUserにするか、?mode=asker でプロキシを絞る方が、見えるツール自体を減らせます。ロールの付与はJedifyの管理者の仕事なので、Claude Code側の拒否ルールは「持っている権限を自分の端末では使わない」ための追加の安全弁と考えると整理しやすくなります。

つながらないときの切り分け

Jedifyのトラブルシューティングが挙げる症状を、原因別に並べます。

• ツールが一覧に出ない: Settings → ConnectorsにJedifyがあり接続済みかを見る。無ければワークスペース管理者に有効化を頼む
• ブラウザのログインが終わらない: プライベートウィンドウで試す。Jedifyに直接サインインできるかも確かめる
• サインイン画面が開かない: Claudeのコネクタなら、Claudeのポップアップを許可してConnectを押し直す
• APIキーが効かない: JEDIFY_API_KEY が args でなく env の中にあるか、キーの期限切れや無効化がないか、プロキシがv1.1.0以上かを見る
• EditorやBuilderのツールが無い: ロールがUserではないか、古い ?mode=asker が設定に残っていないかを疑う
• versioning系のツールが使えない: list_versions などは、Context Graph Versioningが有効なアカウント限定
• 「データがありません」と返る: データ権限の不足か、Jedifyにデータソースが未接続の可能性。contextualize で何が見えるかを試す

質問が遅いときは、日付範囲やフィルタを具体的に指定し、大きな分析は小さな質問に分けると改善します。

導入前に押さえる点

Claudeが引くのは、Jedify側に定義された指標や用語です。定義の整備はJedify側の作業で、Editorモードはその更新をClaudeに手伝わせる入口にあたります。

dbtのセマンティックレイヤーを使っているチームは、同じ発想のdbt Semantic Layerの使い方と見比べると違いがつかめます。Jedifyはロールでモードが分かれ、質問の自律実行と編集まで同じ接続で扱える点が異なります。データカタログのメタデータを引く用途ならClaudeとDataHubの連携が近い領域です。

コネクタの提供元は、利用者が信頼できる開発者のものだけを使うよう注意しています。Anthropicは各開発者が公開するツールを管理せず、動作や変更を検証できないためです。Jedifyは「Anthropic verified」の表示が付いていますが、権限の範囲は自分のロールで確かめてから使ってください。