はじめに
AIアシスタント（Claude、Codex、Geminiなど）からWhaTapモニタリングデータを自然言語で照会できるMCPサーバーです。以下の手順でWhaTap MCPを開始してください。
ステップ1. 事前準備
ステップ2. 会員登録
ステップ3. APIトークン発行
ステップ4. AIクライアントの設定
事前準備
WhaTap MCPサーバーを使用する前に、以下の項目を準備してください。
| Item | Details |
|---|---|
| Node.js | 18.0.0以上（npm、npxを含む） |
| Git | Windows環境でのみ必須 |
| 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のインストール
使用しているOSに合わせた方法で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
Gitのインストール
WhaTap MCPサーバーはGitHubリポジトリを直接参照する際にGitを使用します。macOSとLinuxにはGitが標準で含まれているた め、Windows環境でのみインストールしてください。
winget install --id Git.Git -e --source winget
Windows Package Manager（winget）を使用しない場合は、https://git-scm.comからインストーラーをダウンロードしてください。インストール後 は新しいターミナルを開く必要があります。
インストールが完了したら、ターミナルで以下のコマンドを実行してください。
git --version # バージョンが表示されればOK
会員登録
WhaTapモニタリングサービスを使用するには、まず会員登録が必要です。詳細はアカウント管理 > 会員登録ドキュメントを参照してください。
APIトークン発行
WhaTap MCPサーバーがデータを照会する際に使用するAPIトークンを発行します。
-
WhaTap Consoleにログインします 。
-
右上のプロフィールアイコンをクリックします。
-
アカウント管理を選択します。
-
APIトークンの項目からトークンをコピーします。
このトークンはアカウントレベルのトークンです。このアカウントに属するすべてのプロジェクトのデータを照会できます。データの変更や削除はできないため、安心して使用できます。ただし、トークンが外部に漏洩しないよう適切に管理してください。