Getting Started

This MCP server lets you query WhaTap monitoring data using natural language from AI assistants such as Claude, Codex, and Gemini. Get started with WhaTap MCP by following the steps below.

Step 1. Prerequisites
Step 2. Sign up
Step 3. Issue API token
Step 4. Configure AI client

---

Prerequisites

Prepare the following before using the WhaTap MCP server.

Item	Details
Node.js	18.0.0 or higher (includes npm and npx)
Git	Required on Windows only
WhaTap account	Free or paid account at whatap.io
AI client	One of: Claude Desktop, Claude Code, Codex CLI, Gemini CLI

Verify Node.js installation

Run the following commands in your terminal. If the version is too low or Node.js is not installed, refer to the installation guide below.

node --version   # v18.x.x or higher
npx --version    # any version output is OK

Install Node.js

Install Node.js using the method that matches your operating system.

macOS

brew install node

Note

If Homebrew is not installed, install it from https://brew.sh first, or download Node.js directly from https://nodejs.org.

Windows

winget install OpenJS.NodeJS.LTS

Note

Alternatively, download the LTS installer from https://nodejs.org. After installation, open a new terminal for the changes to take effect.

Ubuntu / Debian

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

Caution

Running apt install nodejs installs an old version (v12–v16). Always use NodeSource.

Fedora / RHEL / Amazon Linux

sudo dnf install -y nodejs npm

Install via nvm (all OS)

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

Install Git

The WhaTap MCP server references a GitHub repository directly, which requires Git. Git comes preinstalled on macOS and Linux, so install it on Windows only.

winget install --id Git.Git -e --source winget

Note

If you do not use Windows Package Manager (winget), download the installer from https://git-scm.com. After installation, open a new terminal for the changes to take effect.

After installation, run the following command in the terminal.

git --version   # Check that a version is printed

Sign up

You need to sign up to use the WhaTap monitoring service. For more details, refer to the Account Management > Sign up document.

Issue API token

Issue an API token for the WhaTap MCP server to use when querying data.

1. Log in to WhaTap Console.

2. Click the profile icon in the top right corner.

3. Select Account Management.

4. Copy the token from the API Token section.

Note

This is an account-level token. It can read data from all projects under this account. It cannot modify or delete data, so it is safe to use. However, keep the token secure and do not expose it externally.