ClaudeとSigmaを連携する方法 — 接続手順・権限・ワークブック作成の条件
SigmaのMCPサーバーをClaudeに接続する手順です。MCP URLの探し方、OAuthと権限の効き方、ワークブック作成で必要なアカウントタイプ、よくあるエラーの原因を示します。
ClaudeとSigmaを連携する方法 — 接続手順・権限・ワークブック作成の条件
SigmaのコネクタをClaudeに入れると、データの検索、テーブル構造の確認、SQLなしの集計、さらにワークブックの作成までを会話の中で進められます。接続自体は数分で終わります。つまずくのは手前の「Sigma側のアカウントタイプに、MCP用の権限が付いているか」です。
この記事では、接続に必要な情報の集め方、認証と権限の効き方、できることの範囲、ワークブックを作らせるときの条件を順に見ます。同じ「データ基盤を会話で引く」系の連携はSnowflake連携やDatabricks MCPサーバーでも扱っています。Sigmaはそれらと違い、BIツール自身がMCPサーバーを持つ構成です。
先に確かめる3つの前提
Sigma側とClaude側で、それぞれ満たすべき条件があります。
接続前に揃える条件
Sigmaのアカウントタイプ
「Use Sigma MCP with OAuth」の権限が有効なアカウントタイプが割り当てられている必要があります。これが無いとOAuthの段階で進めません。
データへのアクセス権
ドキュメントには「Can view」以上、コネクションには「Can use」以上が必要です。Sigmaの画面で見られないものは、Claudeからも見えません。
Claudeのプラン
個人の画面からは、コネクタディレクトリで「Connect」を押せば進みます。TeamとEnterpriseは、先にOwnerかPrimary Ownerが組織としてSigmaを有効にします。
データ側の権限は、操作ごとに必要なものが変わります。Sigmaのドキュメントは次のように分けています。
| やりたいこと | 必要な権限(Sigma側) |
|---|---|
| 検索・探索・クエリ | 必要な権限(Sigma側)対象に応じて「View connections」「View data models」「View workbooks」のいずれか。加えて、ドキュメントなら「Can view」、コネクションなら「Can use」 |
| Sigmaエージェントの呼び出し | 必要な権限(Sigma側)エージェントを含むワークブックへの「Can view」 |
| ワークブックの作成 | 必要な権限(Sigma側)「Create, edit, and publish workbooks」と「Create, edit, and publish workbooks with Sigma MCP」 |
| 既存ワークブックの編集 | 必要な権限(Sigma側)上の2つに加えて、そのワークブックへの「Can edit」 |
| スクリーンショット | 必要な権限(Sigma側)「Create, edit, and publish workbooks with Sigma MCP」と、ワークブックへの「Can view」 |
読み取りだけなら標準的な閲覧権限で足ります。書き込み系の2つは別の権限なので、管理者に頼む順番を間違えないようにします。
Sigma MCP URLを取り出す
Claudeに渡す接続先は、組織ごとに違うURLです。固定のURLは無く、Sigma上で次の順に開いて取ります。
Sigma MCP URLの取得
- 1
プロフィールを開く
Sigma右上のユーザーアイコン(イニシャル表示のことが多い)を選び、「Profile」に進みます。
- 2
Integrationsを選ぶ
プロフィールのタブから「Integrations」を開きます。
- 3
URLをコピーする
「Connect Sigma to AI tools」の節にある「Sigma MCP URL」をコピーします。
このURLは、後でエラーが出たときにも確かめ直す場所になります。別の組織のURLや古い値を貼ると「Couldn't reach the MCP server」の表示になるためです。
Claudeに接続する手順
SigmaのドキュメントはClaudeについて、コネクタディレクトリで「Sigma」を探して接続する流れを案内しています。コネクタのページには「Anthropic verified」の表示があり、提供元はSigma Computing、サインインは必須、追加は2026年4月と載っています。
- Claudeの「Customize」から「Connectors」を開き、ディレクトリで「Sigma」を探す
- 「Server URL」を求められたら、前の節でコピーしたSigma MCP URLを入れる
- 「Connect」を押す
- Sigmaのログイン画面でサインインし、Claudeへの許可を承認する
認証方式の指定を求められる画面ではOAuthを、トランスポートの指定があればHTTPを選びます。これはSigmaの案内どおりの値です。
TeamとEnterpriseでの追加
組織のOwnerまたはPrimary Ownerは、SigmaのMCPサーバーを組織向けのコネクタとして追加できます。追加しても、全員が自動で使えるようになるわけではありません。各メンバーが自分でSigmaにサインインして初めて使えます。コネクタを有効にしても誰にもアクセスが付与されない点は、Claude側のコネクタ全般の仕様です。全体像はClaudeコネクタの全体像にまとめています。
Claude Codeで使う場合
コネクタはClaude Codeでも使えます。URLを直接渡す場合は、リモートHTTPサーバーを追加するコマンドの形になります。
claude mcp add --transport http sigma <Sigma MCP URL><Sigma MCP URL>は、自分の組織のURLに置き換えます。追加後はClaude Code内の/mcpでOAuthの認証を進める流れです。コマンドの形はClaude Code側のMCP仕様に沿ったもので、Sigmaのドキュメントが示す手順ではありません。SigmaのドキュメントがコマンドラインのMCP追加例を載せているのはCodexとCortex Codeで、Claude Code向けの記載はありません。
認証と権限はどう効くか
認証はOAuthです。ログイン時にSigmaの画面でサインインし、Claudeに許可を与えます。ここで効く原則は2つあります。
- 権限は既存のSigmaアカウントのものがそのまま継承される。追加の設定は要らない
- Sigmaへのログイン方法(SSOかパスワードか)は、AIアシスタントの認証に影響しない
つまり、Claudeが見られるデータは「あなたがSigmaで見られるデータ」と一致します。共有のサービスアカウントを作って広く見せる形にはなりません。部署をまたいだ閲覧制限がSigma側で効いているなら、そのままClaudeにも効きます。
IPアドレスの許可リストをSigmaで有効にしている組織は注意が必要です。ClaudeからのアクセスはAnthropic側のIPから来るため、そのアドレスをScopeを「API」にして許可リストに入れる必要があります。必要なIP一覧はAnthropicのIPアドレスのドキュメントにあります。許可リストが有効な組織では、このアドレスの登録が接続の前提条件です。
書き込み系を絞る
Claude側にも、コネクタのツールごとに権限を絞る仕組みがあります。TeamとEnterpriseでは、Ownerが「Customize」から「Connectors」で対象を選び、「Tool permissions」で読み取り系・書き込み系ごとに「Always allow」「Needs approval」「Blocked」を設定します。組織全体に効き、各ユーザーは上書きできません。
Sigmaのワークブック作成は書き込み操作にあたるため、データ分析だけを許したい部署では、書き込み系を「Needs approval」にしておく運用が考えられます。ここで絞ってもSigma側の権限を超える操作は元から通りません。絞るのはあくまで「さらに狭める」方向です。
使えるツールと、できることの範囲
コネクタのページが載せているツールは5つです。
| ツール | 名前から読める守備範囲 |
|---|---|
begin_session | 名前から読める守備範囲セッションの開始 |
search | 名前から読める守備範囲ドキュメントやデータソースの検索 |
list_documents | 名前から読める守備範囲ドキュメントの一覧 |
describe | 名前から読める守備範囲データソースの構造の確認 |
query | 名前から読める守備範囲データへの問い合わせ |
名前から役割を推測できる範囲を表に書きましたが、各ツールの引数や挙動の細部は、コネクタのページにも書かれていません。
一方でSigmaのドキュメントは、これより広い機能を挙げています。
- 組織全体のデータとドキュメントの検索(名前、種別、所有者、コネクションで絞れる)
- 列名・定義・データ型・主キーなどの探索
- SQLを書かない集計と、フォローアップでの絞り込み
- ワークブックの作成と、既存ワークブックの編集
- ワークブックのページや要素のスクリーンショット
- ワークブック内のSigmaエージェントの一覧表示と呼び出し
ワークブック作成・スクリーンショット・エージェント呼び出しに対応するツール名は、コネクタのページの5つには載っていません。ドキュメントの機能一覧が更新され、ディレクトリのツール表示が追いついていないのか、既存ツールの組み合わせで動くのかは、どちらのページにも説明がありません。実際に使えるかは、自分の組織で試すのが確実です。使えるツールの一覧はClaudeの「Customize」から「Connectors」で、Sigmaの項目を開くと確かめられます。
なおエージェントの呼び出しは、Sigma MCPサーバー経由に限る機能です。ChatGPTとCodex向けのSigmaプラグインでは使えません。
業務での使いどころ
Sigmaのドキュメントにある例を、場面に置き換えます。例題の文面は例示であり、実際の出力は各組織のデータによって変わります。
- データの所在確認: 「Sigmaに地域別の売上実績のデータはある?」と聞くと、関連するワークブック、データモデル、テーブルの名前が返ります。分析を始める前の「どこを見ればいいか」の確認に向きます
- 構造の確認: 「
F_SALESテーブルにどんな列がある?」で、列名とデータ型が返ります。SQLを書く前の下調べを短縮できます - 集計の質問: 「Sigmaで2024年の売上上位10店舗を出して」のように聞くと、関連するデータソースを探し、売上と店舗の列を確認してからクエリを走らせます
- ワークブック化: 「2024年の売上上位10店舗を示すワークブックを作って」と頼むと、同じ手順でデータを確認したうえで、「Your documents」フォルダにワークブックを作り、リンクを返します
4の後は、スクリーンショットを頼んで見た目を確認し、修正を頼み、最後にSigmaで開いて仕上げる流れが想定されています。Claudeに任せるのは土台まで、細かい整形はSigmaの画面で、という分担です。
質問の書き方にはコツがあります。データソースが複数ある組織では、文中に「Sigmaで」「SigmaのSalesデータモデルから」のようにSigmaと対象名を入れると、ほかのコネクタと混線しません。Sigmaエージェントを使う場合も、似た名前のエージェントが多いなら、ワークブック名とエージェント名を両方書くと呼び出し先が定まります。
コストの見え方
Sigmaは、MCPサーバーが送るクエリに"kind":"mcp"のタグを付けます。SnowflakeのQUERY_TAGやDatabricksのクエリタグでこの値を拾えば、MCP経由のクエリに掛かった費用をデータ基盤側で別集計できます。会話で気軽に集計できるぶん問い合わせが増えるので、導入時に設定しておく価値があります。
できないことと制限
Sigmaのドキュメントに載っている制限を、影響の大きい順に並べます。
制限事項
公開版しか見ない
MCPサーバーが問い合わせるのは、ドキュメントの公開(published)版だけです。タグ付きバージョンには見られても公開版にアクセス権が無い場合、クエリは権限エラーになります。
作成先は固定
ワークブックは「Your documents」フォルダにだけ作られます。共有フォルダに「Can edit」を持っていても、共有フォルダへの直接作成はできません。
作れない要素
AI列とカスタムSQL要素を含むワークブックは作れません。作る要素は、テーブル、データモデル、ほかのデータ要素といった既存のデータソースに基づく必要があります。
画像とスクリーンショット
画像は公開URLのみ追加できます。会話に添付した画像は使えません。スクリーンショットは1ページまたは1要素ずつで、APIのエクスポート用レート制限(毎分400リクエスト)を共有し、10分を超えると失敗します。
ほかに、カスタムのウィンドウフレーム、順序付きのウィンドウ集計、動的な間隔を使うクエリは現状サポートされません。書き込みを伴う入力テーブルは、書き込みを許可したコネクションが必要です。
AIプロバイダーを組織で有効にしていない場合、検索結果の関連度が下がります。ただし全ツールは動きます。
エラーが出たときの切り分け
ドキュメントに載っている3つの代表エラーを、原因から引けるようにします。
| 症状 | 原因 | 対処 |
|---|---|---|
Couldn't reach the MCP server. You can check the server URL and verify if the server is running. | 原因MCP URLが正しくない | 対処Sigmaの「Profile」「Integrations」で表示されるURLを、そのまま貼り直す |
Creating a Sigma workbook requires a Build license or higher. Your Sigma admin must upgrade your account to use this tool. | 原因ワークブック作成に必要な権限が無い | 対処管理者に、前の表の2つの作成権限を持つアカウントタイプへ変えてもらう |
tool not found、またはツールが一覧に出ない | 原因AIアシスタントが保存しているツール一覧が古い | 対処コネクタ設定でツール一覧を更新する。更新がなければ、コネクタを切断して再接続する |
3つ目は見落としやすい点です。権限を変えた直後や、Sigma側でツールが増えた後に起きます。Claudeのコネクタ全般のトラブル対処も同じで、認証に失敗するときは「Customize」の「Connectors」から切断して接続し直すのが基本です。
組織のルールで別アカウントのドメインを制限している場合の挙動は、Enterpriseのコネクタ制限で扱っています。
同種のBIコネクタとの違い
BI系のコネクタには、MetabaseやTableauもあります。レイクハウス系はDremioとStarburstの記事が参考になります。Sigmaの特徴は、検索・クエリに加えて、ワークブックの作成・編集とエージェント呼び出しまでが同じMCPサーバーの機能として説明されている点です。そのぶん、書き込み系の権限設計がセットになります。
読み取り専用で始めるなら、閲覧権限だけのアカウントタイプで接続する形が最も単純です。ワークブック作成は、権限を足すかどうかを、運用が固まってから決めれば足ります。