본문으로 건너뛰기

설정하기

사용하는 AI 클라이언트에 맞는 설정 방법입니다. 어떤 클라이언트를 선택하든 동일한 MCP 서버를 사용하며 설정 형식만 다릅니다.

노트

설치 방식에 따라 패키지 참조 형식이 다릅니다.

  • JSON/TOML 설정 파일 (Claude Desktop, Codex, Gemini 파일 편집): npx -y whatap-mcp (npm 레지스트리)
  • CLI 등록 명령어 (Claude Code, Codex, Gemini CLI 명령): npx -y github:whatap/whatap-open-mcp (GitHub 직접)
표 | AI 클라이언트별 설정 요약
AI 클라이언트설정 형식설정 파일등록 명령어
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 서버 정보를 추가합니다.

표 | 설정 파일 위치
운영체제경로
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", "whatap-mcp"],
      "env": {
        "WHATAP_API_TOKEN": "여기에_토큰_입력"
      }
    }
  }
}
노트

이미 다른 MCP 서버가 설정되어 있다면, 기존 "mcpServers" 안에 "whatap": { ... } 블록만 추가하세요.

등록 확인하기​

설정 파일을 저장한 후 Claude Desktop을 다시 실행하면 WhaTap MCP 서버가 연결됩니다.

주의

Claude Desktop은 창 닫기가 아닌 앱 종료 후 다시 실행해야 설정이 적용됩니다.

Claude Code (CLI)​

터미널 명령어로 WhaTap MCP 서버를 등록합니다.

적용 범위 선택하기​

등록 전에 사용 범위를 먼저 결정합니다.

범위옵션설명
전체 프로젝트-s user내 계정의 모든 프로젝트에서 사용
현재 프로젝트-s project현재 프로젝트에서만 사용 (.mcp.json에 저장)

명령어로 등록하기​

Claude Code (CLI) 등록
# 전체 프로젝트 (user scope)
claude mcp add whatap -s user \
  -e WHATAP_API_TOKEN=여기에_토큰_입력 \
  -- npx -y github:whatap/whatap-open-mcp

# 현재 프로젝트 (project scope)
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 서버를 등록합니다.

등록하기​

두 방법 중 하나를 선택해 등록할 수 있습니다.

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 서버를 등록합니다.

적용 범위 선택하기​

등록 전에 사용 범위를 먼저 결정합니다.

범위파일 위치용도
전체 (user)~/.gemini/settings.json개인 설정, 모든 프로젝트
프로젝트.gemini/settings.json (프로젝트 루트)팀 공유용

등록하기​

두 방법 중 하나를 선택해 등록할 수 있습니다.

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), 이름, 플랫폼, 제품 유형이 포함된 목록이 나타나면 연결이 정상입니다. 목록이 나타나지 않으면 문제 해결 문서를 참고하세요.

최종 수정: