Claude Code는 Claude의 명령줄(Command Line) 도구입니다. 커넥터는 단 하나의 명령으로 추가할 수 있습니다.
Claude Code에서 연결하는 방법
1. 터미널에서 다음 명령을 실행합니다.
claude mcp add --transport http HTA_MCP
https://mcp.hilltopads.com/mcp
Claude Code에 다음과 같은 확인 메시지가 표시됩니다.
Added HTTP MCP server HTA_MCP
여기서 HTA_MCP는 서버의 로컬 이름일 뿐이며, 원하는 다른 이름으로 변경할 수 있습니다.
1단계 — 하나의 명령으로 서버를 추가합니다.
2. Claude Code를 실행합니다. 서버에 인증이 필요하다는 것을 자동으로 감지합니다. 그런 다음 다음 명령을 실행합니다. /mcp
2단계 — /mcp 명령을 실행합니다.
3. 서버 목록에서 HTA_MCP가 Needs authentication 상태로 표시됩니다. 해당 항목을 엽니다.
3단계 — HTA_MCP에 인증이 필요합니다.
4. Authenticate를 선택합니다.
4단계 — Authenticate를 선택합니다.
5. Claude Code가 인증을 위해 브라우저 창을 엽니다. (브라우저가 자동으로 열리지 않으면 터미널에 표시된 URL을 복사하여 브라우저에서 직접 여십시오.)
5단계 — 인증을 위한 브라우저 창이 열립니다.
6. HilltopAds MCP Authorization 페이지에서 API Key를 붙여넣고 Authorize를 클릭합니다.
6단계 — API Key를 사용하여 인증합니다.
7. 브라우저에 Authentication successful 메시지가 표시되면 탭을 닫고 터미널로 돌아갑니다.
7단계 — 인증이 완료되었습니다. 터미널로 돌아갑니다.
8. /mcp 명령을 다시 실행합니다. 이제 HTA_MCP가 Connected 상태로 표시되며, 사용 가능한 모든 도구를 확인할 수 있습니다.
8단계 — HTA_MCP가 연결되었으며, 사용할 수 있는 도구가 표시됩니다.
Claude Code에서 사용하기
필요한 데이터를 자연어로 요청하면 Claude Code가 자동으로 커넥터를 호출합니다. 또한 데이터를 가져오는 것뿐만 아니라, 해당 데이터를 기반으로 차트를 생성하는 등의 작업도 수행할 수 있습니다.
예를 들어 다음과 같이 요청해 보세요.
"using HTA_MCP get advertiser stats for last 7 days and plot a graph for the top-5 geo, grouping by geo."
Claude Code가 통계 데이터를 가져오고 시각화를 생성합니다.
결과: 상위 5개 GEO를 보여주는 표와 자동으로 생성된 차트가 표시됩니다.