본문으로 건너뛰기

시작하기

AI 어시스턴트(Claude, Codex, Gemini 등)에서 WhaTap 모니터링 데이터를 자연어로 조회할 수 있는 MCP 서버입니다. WhaTap MCP는 다음 절차로 시작합니다.

1단계. 사전 준비
2단계. 회원 가입하기
3단계. API 토큰 발급
4단계. AI 클라이언트 설정

사전 준비​

WhaTap MCP 서버를 사용하기 위해 아래 항목을 미리 준비하세요.

표 | 사전 요구 사항
항목세부 내용
Node.js18.0.0 이상 (npm, npx 포함)
WhaTap 계정whatap.io 무료 또는 유료 계정
AI 클라이언트Claude Desktop, Claude Code, Codex CLI, Gemini CLI 중 하나

Node.js 설치 확인하기​

터미널에서 아래 명령어를 실행하세요. 버전이 낮거나 설치되어 있지 않으면 설치 방법을 참고하세요.

node --version   # v18.x.x 이상이면 OK
npx --version    # 버전이 출력되면 OK

Node.js 설치하기​

사용 중인 운영체제에 맞는 방법으로 Node.js를 설치하세요.

macOS​

brew install node
노트

Homebrew가 없는 경우 https://brew.sh 에서 먼저 설치하거나, https://nodejs.org 에서 직접 다운로드하세요.

Windows​

winget install OpenJS.NodeJS.LTS
노트

또는 https://nodejs.org 에서 LTS 버전 설치 파일을 다운로드하세요. 설치 후 터미널을 새로 열어야 합니다.

Ubuntu / Debian​

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
주의

apt install nodejs로 설치하면 구버전(v12~v16)이 설치됩니다. 반드시 NodeSource를 사용하세요.

Fedora / RHEL / Amazon Linux​

sudo dnf install -y nodejs npm

nvm으로 설치(모든 OS)​

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts

회원 가입​

와탭 모니터링 서비스를 사용하려면 먼저 회원 가입이 필요합니다. 회원 가입에 관한 자세한 내용은 계정 관리 > 회원 가입 문서를 참고하세요.

API 토큰 발급​

WhaTap MCP 서버가 데이터를 조회할 때 사용할 API 토큰을 발급합니다.

  1. WhaTap Console에 로그인합니다.

  2. 우측 상단 프로필 아이콘을 클릭합니다.

  3. 계정 관리를 선택합니다.

  4. API 토큰 항목에서 토큰을 복사합니다.

노트

이 토큰은 계정 레벨 토큰입니다. 해당 계정에 속한 모든 프로젝트의 데이터를 조회할 수 있습니다. 데이터를 변경하거나 삭제하는 기능은 없으므로 안심하고 사용하세요. 단, 토큰은 외부에 노출되지 않도록 관리해 주세요.

최종 수정: