Skip to main content
Glama
eneskoruzh
colintoh

Clicky MCP Server

by colintoh
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Clicky MCP 서버

Clicky 웹 분석을 AI 어시스턴트를 위한 11가지 도구(방문자 수, 인기 페이지, 트래픽 소스, 이탈률, 검색어, 실시간 방문자 등)로 노출하는 MCP(Model Context Protocol) 서버입니다. 전체 목록은 도구 참조를 확인하세요.

빠른 시작

필요한 것:

  • Node.js 20+ 설치됨 (node --version)

  • Clicky 사이트 ID 및 사이트 키 — https://clicky.com/user/preferences/site 의 "Info" 섹션에서 확인 가능

  • 이 저장소를 복제하고 한 번 빌드:

    git clone https://github.com/colintoh/clicky-mcp.git
cd clicky-mcp && npm install && npm run build

그런 다음 아래에서 MCP 호스트를 선택하세요.

왜 npm start 단계가 없나요? MCP stdio 서버는 독립형 데몬으로 실행되지 않습니다. MCP 호스트(Claude Desktop, Claude Code 등)가 필요할 때 서버를 하위 프로세스로 생성하고 stdin/stdout을 통해 통신합니다. 직접 "시작"할 것은 없습니다.

Claude Desktop

  1. 설정 파일을 엽니다(없으면 생성):

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. 이 내용을 파일의 mcpServers 블록에 병합합니다(세 개의 ALL_CAPS 플레이스홀더를 교체):

    {
  "mcpServers": {
    "clicky-analytics": {
      "command": "ABSOLUTE_PATH_TO_NODE", // e.g. /Users/.../.nvm/versions/node/v25.2.1/bin/node
      "args": ["ABSOLUTE_PATH_TO_CLICKY_MCP_FOLDER/dist/index.js"], // e.g. /Users/.../clicky-mcp/dist/index.js
      "env": {
        "CLICKY_SITE_ID": "YOUR_SITE_ID",
        "CLICKY_SITE_KEY": "YOUR_SITE_KEY"
      }
    }
  }
}

    터미널에서 which node를 실행하여 ABSOLUTE_PATH_TO_NODE를 얻으세요. 단순히 "node"라고 입력하지 마세요. Claude Desktop은 nvm이나 homebrew를 포함하지 않는 최소한의 PATH로 launchd를 통해 실행되므로, 단순히 "node"라고 하면 조용히 실패합니다. dist/index.js 경로도 마찬가지로 절대 경로여야 합니다.

  3. Claude Desktop을 완전히 종료하고(macOS에서는 ⌘Q — 창을 닫는 것만으로는 부족함), 다시 엽니다.

  4. Claude에게 *"list my Clicky MCP tools"*라고 물어 확인하세요. 11개의 도구가 보여야 합니다.

문제가 발생하면 문제 해결을 참조하세요.

Claude Code

명령어 하나로 가능:

claude mcp add clicky-analytics \
  -e CLICKY_SITE_ID=YOUR_SITE_ID \
  -e CLICKY_SITE_KEY=YOUR_SITE_KEY \
  -- node /absolute/path/to/clicky-mcp/dist/index.js

이 명령어는 기본적으로 ~/.claude.json에 기록합니다. 대신 프로젝트 로컬 .mcp.json에 기록하려면 --scope project를 추가하세요. Claude Code를 다시 시작하거나(또는 /mcp를 실행하여 새로 고침) 11개의 도구를 사용할 수 있게 됩니다.

MCP Inspector (디버깅)

서버를 호스트에 커밋하지 않고 도구를 직접 호출하고 싶을 때 사용하세요. 스키마 검사나 응답 문제 해결에 유용합니다:

npx @modelcontextprotocol/inspector node dist/index.js

그런 다음 출력된 URL을 열고, Inspector UI에서 CLICKY_SITE_ID 및 CLICKY_SITE_KEY를 환경 변수로 설정하거나(또는 dist/index.js 뒤에 CLI 인수로 --site-id … --site-key … 전달), 클릭하여 사용해 보세요.

Related MCP server: Plausible MCP Server

날짜 매개변수

모든 날짜 인식 도구는 명시적 날짜 범위 또는 Clicky 상대 날짜 키워드 중 하나를 허용하며, 둘 다 동시에 사용할 수는 없습니다:

  • 명시적: start_date + end_date, 둘 다 YYYY-MM-DD 형식, 범위는 31일 이하.

  • 키워드: date_range, today, yesterday, last-7-days, last-30-days, this-week, last-week, this-month, last-month, this-year, last-year 중 하나.

예시:

{ "date_range": "last-7-days" }

도구 참조

사용 사례별로 알파벳순으로 정렬된 11가지 도구입니다.

get_total_visitors

특정 기간의 총 방문자 수.

  • start_date / end_date 또는 date_range

get_actions

특정 기간의 총 페이지 뷰/액션 수.

  • start_date / end_date 또는 date_range

  • limit (숫자, 선택 사항, 최대 1000)

get_bounce_rate

특정 기간의 이탈률 및 평균 사이트 체류 시간.

  • start_date / end_date 또는 date_range

get_visitors_online

실시간 방문자 수 및 세분화. 매개변수가 필요 없습니다.

get_top_pages

특정 기간의 가장 인기 있는 페이지.

  • start_date / end_date 또는 date_range

  • limit (숫자, 선택 사항, 최대 1000)

get_page_traffic

특정 페이지 URL에 대한 트래픽 데이터.

  • url (문자열, 필수)

  • start_date / end_date 또는 date_range

get_traffic_sources

트래픽 소스 분석 — 페이지 URL별로 선택적 필터링 가능.

  • start_date / end_date 또는 date_range

  • page_url (문자열, 선택 사항) — 전체 URL 또는 경로

get_referring_domains

트래픽을 보내는 상위 참조 도메인.

  • start_date / end_date 또는 date_range

  • limit (숫자, 선택 사항, 최대 1000)

get_domain_visitors

참조 도메인별로 필터링된 방문자 데이터(선택적 세분화 포함).

  • domain (문자열, 필수)

  • start_date / end_date 또는 date_range

  • segments (배열, 선택 사항) — ["pages", "visitors"]. 기본값은 ["visitors"].

  • limit (숫자, 선택 사항, 최대 1000)

get_searches

방문자를 유입시킨 상위 검색어.

  • start_date / end_date 또는 date_range

  • limit (숫자, 선택 사항, 최대 1000)

get_countries

국가별 방문자 분석.

  • start_date / end_date 또는 date_range

  • limit (숫자, 선택 사항, 최대 1000)

API 제한

이 서버가 아닌 Clicky에 의해 부과됩니다:

  • 최대 명시적 날짜 범위: 31일

  • 요청당 최대 결과: 1,000개 항목

  • 사이트 ID당 IP별 동시 요청 1개

문제 해결

"Claude Desktop이 서버를 찾지 못합니다." ~/Library/Logs/Claude/mcp-server-clicky-analytics.log에서 생성 로그를 확인하세요. 가장 흔한 원인은 node가 Claude Desktop의 launchd PATH에 없는 경우입니다. "command": "node"를 which node에서 얻은 절대 경로로 교체하여 해결하세요. 두 번째로 흔한 원인은 Claude Desktop을 완전히 종료하지 않은 경우입니다(⌘Q를 사용하세요).

"날짜 범위는 31일을 초과할 수 없습니다." 이는 Clicky API 제한입니다. 범위를 좁히거나 last-30-days와 같은 date_range 키워드를 사용하세요.

로컬 개발

서버를 단순히 사용하는 것이 아니라 개발하는 경우입니다.

npm install         # install deps
npm run dev         # run with tsx, watching for changes (used for local testing only)
npm run build       # compile TS to dist/
npm test            # 46 unit tests, offline, no credentials needed
npm run test:integration  # live API smoke test (requires .env or env vars)

로컬 개발 시 자격 증명은 프로젝트 루트의 .env 파일에서 가져올 수 있습니다:

CLICKY_SITE_ID=your_site_id
CLICKY_SITE_KEY=your_site_key

.env는 gitignore 처리됩니다. Claude Desktop과 같은 호스트에는 .env를 사용하지 마세요. 빠른 시작에 표시된 대로 호스트의 설정 env 블록을 통해 자격 증명을 전달하세요. 서버는 자격 증명이 환경에 이미 존재하지 않을 때만 .env를 로드합니다.

.githooks/pre-push의 사전 푸시 git 훅은 원격 main 브랜치를 업데이트하는 모든 푸시 전에 npm test를 자동으로 실행하므로 회귀 오류가 발생하지 않습니다. 이는 npm install 후 prepare npm 스크립트에 의해 자동으로 설치됩니다. 기능 브랜치로의 푸시는 제한되지 않습니다. 긴급한 경우 git push --no-verify로 우회하세요.

프로젝트 구조

clicky-mcp/
├── src/
│   ├── index.ts              # MCP server + tool dispatcher
│   ├── clicky-client.ts      # Clicky HTTP API client
│   ├── date-utils.ts         # Shared date param builder
│   └── tools/                # One file per tool
├── test/                     # node:test unit tests
├── scripts/verify.mjs        # Live API smoke runner
├── .githooks/pre-push        # Auto-installed test gate for main
├── package.json
├── tsconfig.json
└── README.md

AI 에이전트를 통해 이 MCP 설치하기

AI 에이전트(예: 다른 프로젝트의 Claude Code)가 이 MCP를 설치하게 하려면 이 섹션을 참조하세요. 에이전트는 다음을 수행해야 합니다:

  1. 복제 및 빌드:

    git clone https://github.com/colintoh/clicky-mcp.git
cd clicky-mcp && npm install && npm run build

  2. 사용자에게 Clicky 사이트 ID 및 사이트 키(https://clicky.com/user/preferences/site)를 요청합니다.

  3. which node를 실행하여 절대 경로를 캡처합니다.

  4. 사용자의 Claude Desktop 설정을 찾아(빠른 시작 › Claude Desktop의 경로 참조), 해당 섹션의 mcpServers 스니펫을 병합하고 절대 node 경로, 절대 dist/index.js 경로 및 사용자의 자격 증명을 대체합니다.

  5. 사용자에게 Claude Desktop을 완전히 다시 시작(⌘Q)하고, Claude에게 *"list my Clicky MCP tools"*라고 물어 11개의 도구가 나타나는지 확인하도록 안내합니다.

Claude Code의 경우, 빠른 시작 › Claude Code의 단일 claude mcp add 명령어가 더 빠르며 한 단계로 설정을 작성합니다.

라이선스

MIT

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - A tier

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/colintoh/clicky-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server