Tableau MCPは、Tableauが公式に公開しているMCPサーバーです。ClaudeやChatGPTなどのAIエージェントが、Tableau CloudやTableau Serverの公開済みデータソースを、利用者本人の権限で集計できるようになります。この記事では、2026年11月時点の最新版v6.0.4の公式ドキュメントをもとに、ホスト版・ローカル起動・自社ホストの選び方、Claude CodeとClaude Desktopの接続設定、VizQLクエリの実物、ツールと照会範囲を絞る権限設計をまとめました。
まとめ：Tableau MCPの接続方式の選び方と最初に絞るツール・照会範囲
Tableau Cloudなら、まずホスト版のhttps://mcp.tableau.comを使います。サーバーの構築が要らず、利用者ごとのOAuthサインインで既存の権限がそのまま効くからです。Tableau Serverにはホスト版が無いので、自社ホストになります。複数人で使うなら2025.3以降のOAuth構成が前提です。
設定で先に決めるのは、AIに渡すツールとデータの範囲です。既定ではPrepフローの実行系まで含む多数のツールが登録されます。分析の質問に答えさせるだけならINCLUDE_TOOLS=datasourceから始め、プロジェクトやデータソースのIDで照会先を固定してください。
PATを1つ共有して全員で使う構成は採りません。PATは同時に使えず、共有した持ち主の権限で全員がデータを引けてしまいます。
Tableau MCPの集計構造：VizQL Data ServiceとAIの役割
Tableau MCPは、AIエージェントとTableauのAPI群の間に立つ中継役です。エージェントはMCPのツールを呼び、Tableau MCPがVizQL Data Service（VDS）、Metadata API、REST APIへ要求を出して結果を返します。
公式MCPサーバーの提供形態とv6.0.4時点のツールグループの内訳
本体はGitHubのtableau/tableau-mcpで開発されているApache-2.0のOSSで、npmでは@tableau/mcp-serverとして配布されています。リリースの間隔は短く、10月中旬の4.26系から11月9日公開のv6.0.4まで、1か月足らずでメジャー版が2回上がりました。ツールの名前とグループはtoolName.tsが定義しています。主なグループは次のとおりです。
| グループ名 | できること | 操作の種類 |
|---|---|---|
| datasource | データソースの一覧と集計 | 読み取り |
| view | ビューのデータと画像の取得 | 読み取り |
| workbook | ワークブックの一覧と移動 | 読み取りと移動 |
| authoring | ワークブック等の公開 | 書き込み |
| flow | Prepフローの一覧と実行 | 読み取りと実行 |
| pulse | メトリクスと要約の取得 | 読み取り（Cloud） |
| content・users | コンテンツ削除と利用者更新 | 管理者のみ |
集計の本体はquery-datasource、公開はpublish-workbook、削除はdelete-contentというツールです。読み取りだけのサーバーではありません。削除や利用者の更新はADMIN_TOOLS_ENABLEDを有効にしたときだけ登録されます。一方、Prepフローの実行系は既定で有効です。どのグループをAIに見せるかは、後半の権限設計の章で絞ります。
ホスト版mcp.tableau.com・ローカル起動・自社ホストの3方式の比較
動かし方は3通りあります。Hosted Tableau MCPとGetting Startedの記載を並べると、違いは次のようになります。
| 項目 | ホスト版 | ローカル起動 | 自社ホスト |
|---|---|---|---|
| 対象 | Tableau Cloudのみ | Cloud・Server | Cloud・Server |
| 通信方式 | Streamable HTTP | stdio | Streamable HTTP |
| 認証 | OAuth 2.1 | 主にPAT | OAuth推奨 |
| 版の更新 | 自動 | npxの指定次第 | 自社で管理 |
| 向く使い方 | 部門での利用 | 個人の検証 | Serverの全社展開 |
ホスト版はどのSKUのTableau Cloudでも使えますが、Pulseのインサイト要約はTableau+が条件です。通信方式はStreamable HTTPとは？MCPのトランスポートとSSEの違い、CloudとServerの選定はTableau Cloudとは：Serverとの違い・SSOとBridgeの設定で扱っています。
導入前の準備：VDS・API Access権限・PATをTableau側で揃える作業
接続でつまずく原因の多くは、AIクライアントではなくTableau側の設定にあります。
VDSの有効化とデータソースごとのAPI Access権限の付与
Configuring Tableauが挙げる前提は、VDSが有効であること、照会したいデータソースで利用者にAPI Accessの権限があること、Metadata APIを使うならData Catalogが有効であることの3つです。Tableau ServerのVDSは2025.1で設定項目が加わり、既定で有効になっています。
見落としやすいのはAPI Accessです。VDSの設定ページによると、データソースの権限ダイアログでAPI Accessを割り当てる必要があります。ワークブックの中のデータを引く場合は、表示・API Access・完全なデータのクエリの3つが要ります。Viewerにダッシュボードを見せている権限設定のままでは、MCPから集計できません。
PATの作成と15日未使用で失効する仕様・同時に使えない制約
ローカル起動ではPAT（個人用アクセストークン）で認証します。個人用アクセストークンのヘルプによると、PATは15日間使われないと失効し、使い続けても1年で期限が切れます。1人が持てるのは10個までです。
運用で効くのは同時使用の制限です。同じPATで新しくサインインすると、前のセッションが切れます。Tableau MCPのPATのページも、複数のクライアントから同時に呼ばれる構成では使わないよう警告しています。PATは1人が1台で使う検証用と割り切ってください。
Tableau MCPへの接続設定：Claude CodeとDesktopの手順
ここからはクライアント側の設定です。Claude Codeはホスト版、Claude Desktopはローカル起動の例で示します。
Claude Codeでホスト版へ接続するコマンドとOAuth認証・サイトの切替
Popular Client Integrationsにある手順は、次のコマンドで登録するだけです。
# ホスト版の Tableau MCP を HTTP トランスポートで登録する
claude mcp add --transport http Tableau https://mcp.tableau.com
# 登録の確認
claude mcp listClaude Codeを起動して/mcpを開き、Tableauを選んでAuthenticateを押すと、ブラウザでTableau Cloudの同意画面が開きます。同意画面に表示されるサイト名と利用者名は、承認の前に確かめておきます。ホスト版の接続は承認したサイトに固定されるからです。別のサイトへ切り替えるときは、/mcpからRe-authenticateを選び直します。
Claudeのアプリでは、Customizeのコネクタ一覧でTableauを検索して接続します。MCPそのものの仕組みはMCP（Model Context Protocol）とは？仕組み・APIとの違いで説明しています。
Claude Desktopでnpxからローカル起動する設定ファイルの書き方
Tableau Serverにつなぐ場合や、ホスト版を使えない環境では、Claude Desktopの設定ファイルclaude_desktop_config.jsonに次のように書きます。版を@latestにせず固定しているのは、メジャー版の更新で挙動が変わるのを避けるためです。
{
"mcpServers": {
"tableau": {
"command": "npx",
"args": ["-y", "@tableau/[email protected]"],
"env": {
"SERVER": "https://tableau.example.co.jp",
"SITE_NAME": "",
"PAT_NAME": "mcp",
"PAT_VALUE": "ここにPATのシークレットを入れる",
"INCLUDE_TOOLS": "datasource",
"MAX_RESULT_LIMIT": "500"
}
}
}
}SITE_NAMEには表示名ではなくURLに出るコンテンツURLを入れます。Serverの既定サイトなら空欄のままで構いません。Tableau CloudではSERVERにサイトのポッドのURLを指定します。Node.jsは、Getting Startedの「18以降」ではなくpackage.jsonの要件に合わせて22.7.5以上を入れてください。設定ファイルの場所やDesktop側の拡張機能の入れ方はClaude Desktopとは？Linux対応・料金・インストールとMCP設定の手順で扱っています。
401・403・IPフィルタで接続できないときの原因と確認する場所
Getting Startedのトラブルシューティングに載っているエラーを、確認する順に並べました。
| 症状 | 主な原因 | 確認すること |
|---|---|---|
| 401 Unauthorized | PAT名の誤り・PATの失効 | 利用者名ではなくPATの名前か |
| 403 Forbidden | API Access権限の不足 | データソースの権限ダイアログ |
| IPアドレスで拒否 | CloudのIPフィルタ | 許可リストとポッド単位の接続先 |
401でまず疑うのはPAT_NAMEで、メールアドレスを入れる誤りが典型です。IPフィルタを有効にしたCloudのサイトではAccess FORBIDDEN for this IP addressと返り、許可リストを直してポッド単位の接続先を指定するまでホスト版はつながりません。
データソース照会の流れ：AIエージェントによる検索・メタデータ取得・集計
データソースの照会では、list-datasourcesによる検索からquery-datasourceによる集計までの流れを確認します。AIエージェントが各段階で実際に何を送っているかを知っておくと、回答の検算がしやすくなります。
データソースの検索から集計までにAIが呼び出す3つのツールの順序
「先月の地域別の売上は？」と聞いたとき、datasourceグループのツールはおおむね次の順で呼ばれます。
list-datasourcesで、名前の合う公開済みデータソースとそのLUIDを探すget-datasource-metadataで、フィールド名・型・既定の集計・説明を取るquery-datasourceで、VizQLのクエリを組み立てて集計を実行する
2番目で読まれるのがフィールドの説明です。説明が空だったり、名前が略号のままだったりすると、エージェントはフィールドを推測で選びます。Tableau AIでも同じ問題があり、説明欄の未入力をAPIで洗い出す方法はTableau AIとは：Tableau Agentの機能と利用条件で紹介しました。なお、AIを介さずにVizQL Data ServiceやREST APIを業務システムから直接呼ぶ方法はTableau APIの使い方：REST・埋め込み・Hyper APIの使い分けとPython実装例で解説しています。
VizQLクエリの実物：上位5顧客の売上合計とTOPフィルタの落とし穴
Query Datasourceのページにある例を、サンプルのSuperstoreで売上上位5顧客を出すクエリとして示します。エージェントの呼び出し履歴にこの形のJSONが出るので、検算の手がかりになります。
{
"datasourceLuid": "2d935df8-fe7e-4fd8-bb14-35eb4ba31d45",
"limit": 100,
"query": {
"fields": [
{ "fieldCaption": "Customer Name" },
{ "fieldCaption": "Sales", "function": "SUM",
"fieldAlias": "Total Revenue", "sortDirection": "DESC", "sortPriority": 1 }
],
"filters": [
{ "field": { "fieldCaption": "Customer Name" },
"filterType": "TOP", "howMany": 5, "direction": "TOP",
"fieldToMeasure": { "fieldCaption": "Sales", "function": "SUM" } }
]
}
}落とし穴は、TOPフィルタと地域などのディメンションフィルタの組み合わせです。TOPが先に評価されるため、「西部の上位10顧客」のつもりが全体の上位10人から西部の人を残した結果になり、8行しか返らないことがあります。このときTableau MCPはMISSING_CONTEXT_ON_DIMENSION_FILTERの警告を返すので、ディメンションフィルタに"context": trueを付けて直します。
権限設計：ツールと照会範囲を絞ってAIへ渡す情報を最小にする設定
Tableau MCPは利用者本人の権限で動くため、本人が見られるデータはすべてAIの文脈に入りえます。権限設計は、そこから用途の分だけ狭める作業です。
INCLUDE_TOOLSとMAX_RESULT_LIMITSで読み取り専用にする設定例
Environment Variablesの値を組み合わせると、分析の質問に答えるだけのサーバーは次のように書けます。
# 照会と検索だけを登録する（INCLUDE_TOOLS と EXCLUDE_TOOLS は同時に指定できない）
INCLUDE_TOOLS=datasource,content-exploration,project
# 既定は件数無制限。全体を30件に抑え、集計だけ1,000行まで許す
MAX_RESULT_LIMIT=30
MAX_RESULT_LIMITS=query-datasource:1000
# 製品テレメトリは既定で有効。送らないなら false を明示する
PRODUCT_TELEMETRY_ENABLED=false
# 管理者向けツールは既定で無効のまま触らない
# ADMIN_TOOLS_ENABLED=falseINCLUDE_TOOLSを指定しないと、Prepフローの実行系も登録されます。実行前に確認を求める2段階の仕組みはありますが、利用者が中身を読まずに承認すれば動きます。読み取りで足りるなら最初から登録しません。
プロジェクト・データソースのIDで照会範囲を固定するツールスコープ
ツールを絞っても、本人が見られるデータソースはすべて照会できます。範囲まで絞るのがTool Scopingです。
# 営業プロジェクトの中で、sales タグが付いたものだけを対象にする
INCLUDE_PROJECT_IDS=d87d843b-4326-4ce3-bc50-a68c1e6c9ca5
INCLUDE_TAGS=sales
# 1つのデータソースに固定する場合（埋め込みデータソースは照会できなくなる）
# INCLUDE_DATASOURCE_IDS=2d935df8-fe7e-4fd8-bb14-35eb4ba31d4プロジェクトやタグで絞ると、データソースの所属を確かめるために親プロジェクトの表示権限が要ります。権限が無い利用者ではMetadata APIでの確認に切り替わりますが、こちらはTableau EnterpriseかTableau+でしか使えません。親プロジェクトの表示権限を揃えておけば、契約による失敗を避けられます。タグは大文字と小文字を区別します。
ホスト版を止めたい管理者のEXCLUDE_TOOLSとv6.0.4のスコープ追加
ホスト版はサイト管理者が無効にできません。止める方法は、Site SettingsでEXCLUDE_TOOLSに全グループを指定し、ツールを1つも呼べなくすることです。設定はREST APIのTableau MCPメソッドから行い、サイト設定自体は2026.2以降で使えます。サーバー側は既定で10分ごとに設定を読み直すため、反映には時間差があります。
v6.0.4では、ホスト版のOAuthスコープにtableau:entitlements:readが加わりました。既定の厳密なスコープ照合のままだと、更新前に発行されたトークンは再同意が必要です。スコープの一覧を固定して登録している自作のコネクタは、この値の追加が要ります。11月に入ってPulseのAIツールだけが消えた、という相談はこの変更をまず疑ってください。
Tableau Serverで自社ホストする構成：OAuthの要件とネットワークの分離
Tableau Serverの利用者にMCPを全社で開放するなら、Tableau MCPを社内のWebアプリとして立てます。Serverの導入ガイドの要件を確認します。
2025.3以降のOAuth構成に必要なRSA鍵とtsmのリダイレクト許可
OAuthでは、利用者が初回にブラウザでTableauへサインインし、以降は本人としてREST APIが呼ばれます。条件はTableau Server 2025.3以降で、RSA秘密鍵の用意とTSMでのリダイレクト先の許可が要ります。
# アクセストークンの暗号化に使う RSA 秘密鍵を作る
openssl genrsa -out private.pem
# Tableau Server 側で MCP サーバーのホストをリダイレクト先として許可する
tsm configuration set -k oauth.allowed_redirect_uri_hosts -v tableau-mcp.example.co.jp
tsm pending-changes apply
# MCP サーバーの .env（SERVER は MCP ではなく Tableau Server の URL）
SERVER=https://tableau.example.co.jp
SITE_NAME=
AUTH=oauth
OAUTH_ISSUER=https://tableau-mcp.example.co.jp
OAUTH_RESOURCE_URI=https://tableau-mcp.example.co.jp
OAUTH_JWE_PRIVATE_KEY_PATH=private.pem
INCLUDE_TOOLS=datasource,content-exploration,project
# コンテナで起動する（版は固定する）
docker run -d --name tableau-mcp --env-file .env -p 3927:3927 ghcr.io/tableau/tableau-mcp:6.0.4tsm pending-changes applyはServerの再起動を伴うことがあるので、業務時間外に流します。TSMの基本はTableau Serverとは：Linux・Windowsのインストール手順・TSMコマンドで解説しています。
PATの共有アカウント運用を避ける理由とDirect Trustの位置づけ
HTTPで動かすときは、既定でOAuthが必須になります。PATやDirect Trustで動かすにはDANGEROUSLY_DISABLE_OAUTH=trueを明示しなければなりません。変数名のとおり、公式はこの構成を通常の選択肢と見ていません。
OAuthを切ると、MCPサーバーに届く人は誰でも、設定した認証情報の持ち主としてデータを引けます。サイト管理者のPATで立てれば、全員が管理者の視野で照会できてしまいます。PATは検証用、Direct Trustは利用量ベースのライセンスで承認された場合に限る、というのが公式の線引きです。ネットワークはTableau Serverと同じ水準で閉じてください。
Tableau MCPの採用判断：向く組織・見送る場面と自社開発に切り替える条件
判断の軸は、データソースが整っているかと、照会の責任を誰が持つかの2つです。
採用する条件：認証済みデータソースがあり質問の型が決まっている組織
次の両方を満たすなら、ホスト版か読み取り限定のローカル起動で試してください。
- 認証済みの公開データソースがあり、フィールドの説明を埋める担当を決められる
- 「月次の売上」「部門別の件数」など、繰り返し聞かれる質問が10件以上ある
- AIクライアントの契約で、入力データの扱いを情報管理の担当が確認済みである
ホスト版自体はTableauのデータを保存しませんが、照会の結果はAIクライアントへ渡ります。その扱いを決めるのはClaudeやChatGPT側の契約です。
見送る場面：埋め込みデータソース中心・PAT共有前提・2025.2以前のServer
次のどれかに当てはまる段階では、Tableau MCPの導入を見送ります。
- 分析の大半がワークブックに埋め込まれたデータソースで、公開済みデータソースが無い
- Tableau Serverが2025.2以前で、複数人に使わせるにはPATを共有するしかない
- Viewerの権限設計しかなく、API Accessを誰に付けるか決められない
埋め込みデータソースの照会は2026.3以降の機能で、サイト管理者による有効化も要ります。先にデータソースを公開して認証済みにしてください。Serverを上げずに共有PATで全社展開するのは事故の元です。
標準ツールで足りない範囲：業務システムへの組み込みと独自エージェント
Tableau MCPのツールは、Tableauの中にあるデータとコンテンツを扱う範囲で完結しています。基幹システムの在庫と突き合わせて回答させたい、社内ポータルの画面から部署の権限に合わせて数字を出したい、といった要望は標準の外です。会話で数字を引く仕組みの全体像は会話型BIとは？自然言語で数字を引き出す仕組みと導入判断で整理しました。
データソースの整備や権限設計から外部に任せる場合の範囲と費用は、Tableauの導入支援｜依頼できる範囲と外注先の選び方で紹介しています。Tableau MCPと社内のAPIを束ねたエージェントを作りたい場合は、AIエージェント開発としてご相談いただけます。
よくある質問
Tableau MCPを試す前によく調べられる質問に答えます。
Tableau MCPは無料で使えますか？
Tableau MCP自体はApache-2.0のOSSで、ホスト版もTableau CloudのどのSKUでも使えると案内されています。ただし照会できるのはTableauのライセンスを持つ利用者の権限の範囲で、Pulseのインサイト要約などはTableau+が条件です。接続するAIクライアント側の契約は別に要るので、ClaudeやChatGPTのどのプランでMCPを使えるかは各社の条件を確かめてください。
Tableau PublicのデータもTableau MCPで扱えますか？
公式のTableau MCPが対象にしているのはTableau CloudとTableau Serverです。Tableau Public向けのMCPサーバーはコミュニティが別に公開しているもので、Tableau MCPとは別物になります。Tableau Publicに置いたデータは誰でも閲覧できるので、社内データの照会に使う前提にはなりません。公開範囲の仕様はTableau Public（タブローパブリック）とはで説明しています。
Tableau Serverでもホスト版のmcp.tableau.comを使えますか？
使えません。ホスト版はTableau Cloud向けのサービスで、公式ドキュメントもServerの利用者には自社ホストを案内しています。個人で試すだけなら、Claude Desktopからnpxでローカル起動してPATで接続するのが手軽です。複数人で使うなら、Server 2025.3以降でOAuthを有効にした自社ホストを組みます。
ChatGPTやCursor、SlackからもTableau MCPを使えますか？
使えます。公式の手順では、ChatGPTはプラグインの一覧からTableauを入れてOAuthで接続します。SlackはTableauのサイト設定の統合タブからSlackアプリを入れる方式で、マーケットプレイスからは入れられず、ワークブックの公開もできません。Cursorなどほかのクライアントでは、カスタムのMCP接続先にhttps://mcp.tableau.comを指定します。
Tableau AI（Tableau Agent）とTableau MCPは何が違いますか？
Tableau Agentは、Tableauの画面の中でビューや計算式を作る製品の機能で、Tableau+などの契約が条件です。Tableau MCPは、ClaudeなどTableauの外にあるAIエージェントへデータを渡す接続口です。前者はTableauの中で作業する人向け、後者は普段使うAIからTableauの数字を引きたい人向けと分かれます。Tableau Agentの条件と制約はTableau AIとはにまとめました。
関連記事
- Tableau（タブロー）とは：製品の種類・データ接続・権限設計と自社開発との使い分け：Tableau全体の構成とロールごとの権限
- Tableau AIとは：Tableau Agentの機能と利用条件・計算式生成とデータ準備の実際と制約：製品内のAI機能との違い
- MCP（Model Context Protocol）とは？仕組み・APIとの違い・MCPサーバーの作り方：MCPの仕組みと自作の方法
- Tableau Serverとは：Linux・Windowsのインストール手順・TSMコマンド・ノード構成とサイジング：自社ホストの前提になるServerの構築
- Claude Desktopとは？Linux対応・料金・インストールとMCP設定の手順：ローカル起動するクライアントの準備
