本文へスキップ

設定

使用するAIクライアントに合わせた設定方法です。どのクライアントを選んでも同じMCPサーバーを使用し、設定形式のみ異なります。

ノート

すべてのクライアントでGitHubリポジトリを直接参照します: npx -y github:whatap/whatap-open-mcp

リポジトリの参照にGitを使用するため、Windows環境では事前にインストールしてください。詳細ははじめに > Gitのインストールドキュメントを参照してください。

AI ClientFormatConfig fileCommand
Claude DesktopJSONclaude_desktop_config.jsonファイルを直接編集
Claude Code--claude mcp add whatap -e WHATAP_API_TOKEN=... -- npx -y github:whatap/whatap-open-mcp
Codex CLITOML~/.codex/config.tomlcodex mcp add whatap --env ... -- npx -y github:whatap/whatap-open-mcp
Gemini CLIJSON~/.gemini/settings.jsongemini mcp -s user add whatap -e ... -- npx -y github:whatap/whatap-open-mcp

Claude Desktop​

設定ファイルにWhaTap MCPサーバーの情報を追加します。

OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

設定を追加する​

設定ファイルを開き、以下の内容を追加します。

Claude Desktop 設定追加
{
  "mcpServers": {
    "whatap": {
      "command": "npx",
      "args": ["-y", "github:whatap/whatap-open-mcp"],
      "env": {
        "WHATAP_API_TOKEN": "ここにトークンを入力"
      }
    }
  }
}
ノート

他のMCPサーバーがすでに設定されている場合は、既存の"mcpServers"の中に"whatap": { ... }ブロックのみを追加してください。

登録を確認する​

設定ファイルを保存してClaude Desktopを再起動すると、WhaTap MCPサーバーが接続されます。

注意

Claude Desktopはウィンドウを閉じるのではなく、アプリを終了してから再起動しないと設定が反映されません。

Claude Code (CLI)​

ターミナルコマンドでWhaTap MCPサーバーを登録します。

適用範囲を選択する​

登録前に使用範囲を決定します。

ScopeOptionDescription
全プロジェクト-s userアカウントのすべてのプロジェクトで使用
現在のプロジェクト-s project現在のプロジェクトのみ（.mcp.jsonに保存）

コマンドで登録する​

Claude Code (CLI) 登録
# 全プロジェクト（userスコープ）
claude mcp add whatap -s user \
  -e WHATAP_API_TOKEN=ここにトークンを入力 \
  -- npx -y github:whatap/whatap-open-mcp

# 現在のプロジェクト（projectスコープ）
claude mcp add whatap -s project \
  -e WHATAP_API_TOKEN=ここにトークンを入力 \
  -- npx -y github:whatap/whatap-open-mcp

登録を確認する​

Claude Code (CLI) 登録確認
claude mcp list

Codex CLI (OpenAI)​

コマンドまたは設定ファイルでWhaTap MCPサーバーを登録します。

登録する​

以下の2つの方法から選択できます。

Codex CLI (OpenAI) コマンド登録
codex mcp add whatap \
  --env WHATAP_API_TOKEN=ここにトークンを入力 \
  -- npx -y github:whatap/whatap-open-mcp

登録を確認する​

Codex CLI (OpenAI) 登録確認
codex mcp list

Gemini CLI (Google)​

コマンドまたは設定ファイルでWhaTap MCPサーバーを登録します。

適用範囲を選択する​

登録前に使用範囲を決定します。

ScopeFile locationPurpose
ユーザー（全体）~/.gemini/settings.json個人設定、全プロジェクト
プロジェクト.gemini/settings.json（プロジェクトルート）チーム共有用

登録する​

以下の2つの方法から選択できます。

Gemini CLI (Google) 登録
gemini mcp -s user add whatap \
  -e WHATAP_API_TOKEN=ここにトークンを入力 \
  npx -- -y github:whatap/whatap-open-mcp

登録を確認する​

Gemini CLI (Google) 登録確認
gemini mcp list

接続を確認する​

  1. 設定完了後、AIクライアントを開きます。

  2. 以下のように入力します。

    WhaTapのプロジェクト一覧を見せて

  3. プロジェクトコード（pcode）、名前、プラットフォーム、製品タイプを含む一覧が表示されれば接続は正常です。表示されない場合はトラブルシューティングドキュメントを参照してください。

最終修正：