본문으로 건너뛰기

환경 설정

WhaTap MCP 서버는 WHATAP_API_TOKEN 하나만 설정하면 SaaS 환경에서 바로 사용할 수 있습니다. 공공기관이나 On-premises 환경이라면 WHATAP_API_URL을 추가로 설정해야 합니다.

환경 변수​

변수필수기본값설명
WHATAP_API_TOKENO-WhaTap 계정 API 토큰
WHATAP_API_URLXhttps://api.whatap.ioAPI 엔드포인트 (SaaS 환경은 변경 불필요)

API 엔드포인트​

WhaTap SaaS 환경에서는 모든 리전(서울, 도쿄, 싱가폴, 프랑크푸르트 등)이 동일한 API URL(https://api.whatap.io)을 사용합니다. 리전별 라우팅은 서버에서 자동 처리되므로 별도 설정이 필요 없습니다.

아래의 경우에만 WHATAP_API_URL을 변경하세요.

환경URL비고
SaaS(기본)https://api.whatap.io변경 불필요
공공기관 / 정부망https://api.gov.whatap.ioWHATAP_API_URL 설정 필요
On-premises고객사 내부 URLWHATAP_API_URL 설정 필요

공공기관용 설정 예시​

Claude Desktop​

Claude Desktop
{
  "mcpServers": {
    "whatap": {
      "command": "npx",
      "args": ["-y", "whatap-mcp"],
      "env": {
        "WHATAP_API_TOKEN": "여기에_토큰_입력",
        "WHATAP_API_URL": "https://api.gov.whatap.io"
      }
    }
  }
}

Claude Code​

Claude Code
claude mcp add whatap \
  -e WHATAP_API_TOKEN=여기에_토큰_입력 \
  -e WHATAP_API_URL=https://api.gov.whatap.io \
  -- npx -y github:whatap/whatap-open-mcp

Codex CLI​

Codex CLI
[mcp_servers.whatap]
command = "npx"
args = ["-y", "whatap-mcp"]

[mcp_servers.whatap.env]
WHATAP_API_TOKEN = "여기에_토큰_입력"
WHATAP_API_URL = "https://api.gov.whatap.io"

Gemini CLI​

Gemini CLI
gemini mcp -s user add whatap \
  -e WHATAP_API_TOKEN=여기에_토큰_입력 \
  -e WHATAP_API_URL=https://api.gov.whatap.io \
  npx -- -y github:whatap/whatap-open-mcp

WhaTap 서비스 리전​

프로젝트의 리전은 WhaTap Console에서 프로젝트 생성 시 선택합니다. 리전이 달라도 API URL은 동일합니다.

리전위치클라우드
서울대한민국AWS, Azure, 카카오클라우드
도쿄일본AWS, Azure
싱가폴싱가폴AWS
자카르타인도네시아AWS
뭄바이인도AWS
캘리포니아미국 서부AWS
버지니아미국 동부AWS
프랑크푸르트독일AWS
최종 수정: