/ 目录 / 演练场 / Tableau MCP
● 官方 tableau 🔑 需要你的密钥

Tableau MCP

作者 tableau · tableau/tableau-mcp

Tableau的官方MCP —允许代理通过PAT (而非屏幕截图)访问您的数据源、工作簿和查看图像。

tableau-mcp是Tableau的第一方MCP服务器。使用Tableau云/服务器URL、站点名称和个人访问令牌进行配置,代理可以查询已发布的数据源、列出和浏览工作簿内容、检索视图图像以及回答自然语言数据问题,而无需将CSV粘贴到聊天中。支持npx、Heroku和Docker部署。

为什么要用

核心特性

实时演示

实际使用效果

tableau-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tableau-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "tableau-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@tableau/mcp-server@latest"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add tableau-mcp -- npx -y @tableau/mcp-server@latest

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Tableau MCP

根据已发布的数据源回答业务问题

👤 生活在聊天中的分析师和运营人员 ⏱ ~10 min beginner

何时使用: 您有一个Tableau仪表板可以回答的问题,但您不想打开Tableau Desktop。

前置条件
  • Tableau Cloud或Server帐户 — 如果您没有访问权限,请询问管理员
  • 个人访问Token — 我的帐户设置→个人访问令牌→创建令牌
步骤
  1. 查找数据源
    列出站点“ops”上已发布的数据源。✓ 已复制
    → 包含名称和ID的数据源数组
  2. 提问
    根据“orders_fact”数据源,上个季度按收入排名前10的产品是什么?✓ 已复制
    → 数字答案引用数据源中存在的字段

结果: 基于您受管Tableau数据的具体答案。

注意事项
  • 询问已发布数据源中没有的字段 — 让客服代表先列出元数据,然后询问
搭配使用: bigquery-server · postgres

在报告文档中嵌入Tableau视图图像

👤 项目经理和分析师撰写每周报告 ⏱ ~5 min beginner

何时使用: 您希望在Notion或Google文档中获得Tableau图表的最新视图。

前置条件
  • 视图URL或其网站/工作簿/视图路径 — 从Tableau UI复制
步骤
  1. 获取图片
    从工作簿“Exec记分卡”获取“每周收入”视图的PNG。✓ 已复制
    → 图像内联返回
  2. -贴吧&#09;<ex id="_1"/><bx id="2"/>.
    在Notion中将其附在报告上,并附上简短的标题。✓ 已复制
    → 图像显示在您想要的位置

结果: 始终全新查看图像,无需屏幕截图步骤。

注意事项
  • 网址中的过滤器丢失 — 在工具调用中显式传递过滤器参数
搭配使用: notion

审核工作簿的所有权和陈旧性

👤 平台/数据治理团队 ⏱ ~25 min intermediate

何时使用: 在进行访问检查之前,您正在清理一个嘈杂的网站。

步骤
  1. 列出所有具有所有者+上次查看日期的工作簿
    枚举网站“ops”上包含所有者、last_viewed和项目的工作簿。✓ 已复制
    → 可按近期排序的工作簿表
  2. 标记死者
    将180多天内未查看的工作簿标记为存档的候选人。✓ 已复制
    → 您可以交给所有者的筛选列表

结果: 由实际使用数据支持的具体存档列表。

搭配使用: linear

直接与仓库交叉检查Tableau编号

👤 数据工程师调试差异 ⏱ ~20 min intermediate

何时使用: 您的控制面板不同意财务团队的电子表格,您希望查找位置。

步骤
  1. 阅读Tableau答案
    Tableau表示上个月的收入是多少?✓ 已复制
    → 单个数字+数据源+提取/实时信息
  2. 在仓库上运行相同的聚合
    在BigQuery和diff上运行等效的SQL。✓ 已复制
    → 两个数字并排+增量解释

结果: 您可以快速找到漂移(提取失效?过滤器?加入? )。

注意事项
  • 比较实时与提取物而不注意它 — 客服代表应在编号前打印数据源类型
搭配使用: bigquery-server

组合

与其他 MCP 搭配,撬动十倍杠杆

tableau-mcp + bigquery-server

根据仓库SQL协调Tableau指标

提取Tableau值和仓库SQL应答并区分它们。✓ 已复制
tableau-mcp + postgres

针对运营数据库的相同工作流程

看看为什么orders_fact提取物今天与实时订单表不一致。✓ 已复制
tableau-mcp + notion

在每周报告中嵌入实时视图图像

将最新的每周收入巴布亚新几内亚放在Notion报告的顶部。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
list_datasources site?: str 在提问前了解已发布的数据 1 API call
query_datasource datasource_id: str, question: str 回答自然语言数据问题 1 API call + VizQL
list_workbooks site?: str, project?: str 浏览或审核工作簿清单 1 API call
get_view_image view_id: str, filters?: map 在文档或回复中包含图表图像 1 API call
list_views workbook_id: str 枚举工作簿中的图表 1 API call

成本与限制

运行它的成本

API 配额
受Tableau Cloud/Server REST API限制的约束
每次调用 Token 数
对于元数据来说很小;视图图像是字节,而不是令牌
费用
免费—您的Tableau许可证已经覆盖了它
提示
缓存LIST_WORKBOOKS/LIST_DATASOURCES审核结果;库存不会每分钟更改。

安全

权限、密钥、影响范围

凭据存储: PAT_VALUE属于env vars ;永远不要提交它。如果泄漏,请从Tableau UI旋转。
数据出站: 所有流量都会传输到您配置的Tableau服务器URL。请勿拨打第三方电话。

故障排查

常见错误与修复

401/登录失败

PAT已过期或站点不匹配。重新生成PAT并确认SITE_NAME与网站网址段相匹配。

验证: Log into Tableau and look at the URL: /site/<SITE_NAME>/...
未找到数据源

它可能未发布或存在于另一个项目中。调用list_datasources以查看令牌可见的内容。

验证: list_datasources with no filter
禁止查看图片返回

PAT所有者缺乏对该工作簿的查看权限。具有管理员授予读取权限。

验证: Open the view URL in a browser with the same user

替代方案

Tableau MCP 对比其他方案

替代方案何时用它替代权衡
bigquery-server您想要原始仓库SQL ,而不是受管理的语义数据源更强大的功能,没有Tableau拥有的指标
postgres您的真相来源是运营Postgres ,而不是BI工具无VizQL层

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills