/ 디렉터리 / 플레이그라운드 / Tableau MCP
● 공식 tableau 🔑 본인 키 필요

Tableau MCP

제작: tableau · tableau/tableau-mcp

Tableau의 공식 MCP — 에이전트에게 스크린샷이 아닌 PAT를 통해 데이터 원본, 통합 문서 및 뷰 이미지에 대한 범위 지정 액세스 권한을 부여합니다.

tableau-mcp는 Tableau의 자사 MCP 서버입니다. Tableau Cloud/Server 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 또는 서버 계정 — 액세스 권한이 없는 경우 관리자에게 액세스 권한을 요청하세요.
  • 개인 액세스 토큰 — 내 계정 설정 → 개인 액세스 토큰 → 토큰 생성
흐름
  1. 데이터 소스 찾기
    'ops' 사이트에 게시된 데이터 소스를 나열합니다.✓ 복사됨
    → 이름과 ID가 있는 데이터 소스 배열
  2. 질문하기
    'orders_fact' 데이터 소스에서 지난 분기 매출 기준 상위 10개 제품은 무엇이었나요?✓ 복사됨
    → 데이터 소스에 존재하는 필드를 참조하는 숫자 답변

결과: 관리되는 Tableau 데이터를 기반으로 한 구체적인 답변입니다.

함정
  • 게시된 데이터 원본에 없는 필드에 대해 질문하기 — 에이전트가 메타데이터를 먼저 나열하도록 한 다음 질문합니다.
함께 쓰기: bigquery-server · postgres

보고서 문서에 Tableau 뷰 이미지 포함

👤 주간 보고서를 작성하는 PM 및 분석가 ⏱ ~5 min beginner

언제 쓸까: Notion 또는 Google Docs 내에서 Tableau 차트의 최신 보기를 원합니다.

사전 조건
  • 보기 URL 또는 해당 사이트/통합 문서/보기 경로 — Tableau UI에서 복사
흐름
  1. 이미지 가져오기
    통합 문서 'Exec Scorecard'에서 '주간 수익' 보기의 PNG를 가져옵니다.✓ 복사됨
    → 인라인으로 반환된 이미지
  2. 붙여넣기
    짧은 캡션과 함께 Notion의 보고서에 첨부하세요.✓ 복사됨
    → 원하는 위치에 이미지가 나타납니다.

결과: 스크린샷 단계 없이 항상 새로운 이미지를 볼 수 있습니다.

함정
  • URL의 필터가 손실됨 — 도구 호출에서 명시적으로 필터 매개변수를 전달합니다.
함께 쓰기: notion

통합 문서의 소유권 및 부실 여부를 감사합니다.

👤 플랫폼/데이터 거버넌스팀 ⏱ ~25 min intermediate

언제 쓸까: 액세스 검토 전에 시끄러운 사이트를 정리하고 있습니다.

흐름
  1. 소유자 + 마지막 보기 날짜가 포함된 모든 통합 문서 나열
    소유자, last_viewed 및 프로젝트를 사용하여 'ops' 사이트의 통합 문서를 열거합니다.✓ 복사됨
    → 최신순으로 정렬할 수 있는 통합 문서 표
  2. 죽은 사람에게 플래그를 지정하세요.
    180일 이상 보지 않은 통합 문서를 보관 대상으로 표시합니다.✓ 복사됨
    → 소유자에게 전달할 수 있는 필터링된 목록

결과: 실제 사용 데이터를 기반으로 하는 구체적인 아카이브 목록입니다.

함께 쓰기: linear

Tableau 번호를 창고와 직접 대조 확인

👤 불일치를 디버깅하는 데이터 엔지니어 ⏱ ~20 min intermediate

언제 쓸까: 귀하의 대시보드가 ​​재무팀의 스프레드시트와 일치하지 않아 그 위치를 찾으려고 합니다.

흐름
  1. Tableau 답변 읽기
    Tableau에서는 지난 달 수익이 얼마라고 말합니까?✓ 복사됨
    → 단일 숫자 + 데이터 소스 + 추출/라이브 정보
  2. 웨어하우스에서 동일한 집계 실행
    BigQuery 및 diff에서 동등한 SQL을 실행합니다.✓ 복사됨
    → 두 숫자를 나란히 놓고 + 델타 설명

결과: 드리프트(부실 추출? 필터? 조인?)를 빠르게 찾습니다.

함정
  • 별도의 언급 없이 라이브와 추출을 비교합니다. — 에이전트는 숫자 앞에 데이터 소스 유형을 인쇄해야 합니다.
함께 쓰기: bigquery-server

조합

다른 MCP와 조합해 10배 효율

tableau-mcp + bigquery-server

웨어하우스 SQL에 대해 Tableau 측정항목 조정

Tableau 값과 웨어하우스 SQL 응답을 가져와 비교합니다.✓ 복사됨
tableau-mcp + postgres

운영 DB에 대한 동일한 워크플로우

주문_사실 추출이 오늘 실시간 주문 테이블과 일치하지 않는 이유를 확인하세요.✓ 복사됨
tableau-mcp + notion

주간 보고서에 실시간 보기 이미지 삽입

최신 주간 수익 PNG를 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 제한에 따라 제한됨
호출당 토큰
메타데이터의 경우 작음. 보기 이미지는 토큰이 아니라 바이트입니다.
금액
무료 — Tableau 라이선스에 이미 적용되어 있습니다.
감사를 위해 list_workbooks / list_datasources 결과를 캐시합니다. 인벤토리는 매분 변경되지 않습니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: PAT_VALUE는 환경 변수에 속합니다. 절대 저지르지 마세요. 유출된 경우 Tableau UI에서 회전합니다.
데이터 외부 송신: 모든 트래픽은 구성된 Tableau SERVER URL로 이동합니다. 제3자 통화는 안 됩니다.

문제 해결

자주 발생하는 오류와 해결

401 / 로그인 실패

PAT가 만료되었거나 사이트가 일치하지 않습니다. PAT를 다시 생성하고 SITE_NAME이 사이트 URL 세그먼트와 일치하는지 확인하세요.

확인: 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정보의 원천은 BI 도구가 아닌 운영 Postgres입니다.VizQL 레이어 없음

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기