Eventflare MCP 서버 v2

Model Context Protocol(MCP)을 통해 Claude, ChatGPT, Perplexity, Cursor와 같은 AI 어시스턴트가 Eventflare의 프로덕션 장소 데이터를 쿼리할 수 있도록 합니다.

40개 이상의 도시에서 8,000개 이상의 기업 행사 장소를 제공합니다. LLM이 답변에 Eventflare URL을 인용하고 리드 기여도를 엔드투엔드로 측정할 수 있도록 설계되었습니다.

v2의 새로운 기능

• 프로덕션 API + JWT 인증 — 기존: 인증 없는 개발용 API

• 개인정보(PII) 비식별화 — jobPhone, venueEmail, commission, spaceNotes 등은 API를 통해 절대 외부로 유출되지 않습니다.

• UTM 속성 추적 — 모든 아웃바운드 URL에 태그가 지정되어 MCP 트래픽에서 발생한 리드를 GA4 / Mixpanel / CRM에서 추적할 수 있습니다.

• 클라이언트 분류 — 로그를 통해 Claude Desktop / ChatGPT / Perplexity / Cursor 등을 구분합니다.

• 클릭률 추적 — 동일 세션 내에서 get_venue_details 또는 request_quote가 이전 search_venues의 장소를 참조할 경우 클릭으로 기록됩니다.

• OpenPanel 싱크 — 데이터 팀을 위해 이벤트를 OpenPanel(또는 모든 웹훅)에 미러링합니다.

• 새로운 도구: find_expert_advice — Eventflare의 편집 기사를 제공합니다. LLM 인용의 차별화 요소입니다.

도구

모든 도구에는 LLM 응답에 최적화된 citation_url과 quotable_summary가 포함되어 있습니다.

빠른 시작

npm install
cp .env.example .env
# fill EVENTFLARE_API_TOKEN
npm run build
npm start          # stdio — Claude Desktop, Claude Code, Cursor

# or HTTP mode (remote MCP):
TRANSPORT=http PORT=3001 npm start

Claude Desktop에 연결

claude_desktop_config.json:

{
  "mcpServers": {
    "eventflare": {
      "command": "node",
      "args": ["/path/to/eventflare-mcp-server/dist/index.js"],
      "env": {
        "EVENTFLARE_API_TOKEN": "eyJhbGciOi..."
      }
    }
  }
}

Claude Code에 연결

claude mcp add eventflare \
  -e EVENTFLARE_API_TOKEN=eyJhbGciOi... \
  -- node /path/to/eventflare-mcp-server/dist/index.js

환경 변수

.env.example을 참조하세요. EVENTFLARE_API_TOKEN만 필수입니다.

보안 모델

• 읽기 전용 — POST/PUT/DELETE 작업이 없습니다. 프로덕션 API 사양(123개 엔드포인트, 모두 GET)에 따라 확인되었습니다.

• JWT 인증 필수 — 모든 아웃바운드 요청에 Authorization: Bearer ${EVENTFLARE_API_TOKEN}이 필요합니다.

• 필드 허용 목록 — fields[]= 쿼리 매개변수를 사용하여 개인정보(PII) 필드가 절대 호출되지 않습니다. 심층 방어: 비식별화 허용 목록을 통해 누락된 필드도 차단합니다.

• 입력값 검증 — 모든 도구 매개변수는 검증됩니다. 슬러그는 ^[a-z0-9-]+$와 일치해야 하며, 숫자는 제한되고 날짜는 ISO 형식으로 검증됩니다.

• 요청 제한 — /mcp 경로(HTTP 전송)에서 IP당 분당 60회 요청으로 제한됩니다.

• 개인정보 로그 없음 — 분석 필드: 도구, 도시, 수용 인원, 행사 유형, 카테고리, 결과 수, 세션 ID, 클라이언트 클래스, 예산 범위. 사용자 신원이나 메시지 내용은 절대 기록하지 않습니다.

• 범용 오류 메시지 — 내부 API 오류는 사용자에게 안정적인 문자열("Eventflare API temporarily unavailable")로 매핑되며, 세부 정보는 stderr로만 전송됩니다.

분석

로컬: 모든 도구 호출은 logs/queries.jsonl에 추가되며 /dashboard에서 확인할 수 있습니다.

원격: OPENPANEL_CLIENT_ID와 OPENPANEL_CLIENT_SECRET이 설정된 경우, 모든 이벤트는 profileId = sessionId와 함께 mcp.{tool} 추적 이벤트로 미러링됩니다. OPENPANEL_API_URL을 사용하여 자체 호스팅된 OpenPanel을 지정할 수 있습니다.

또는 ANALYTICS_SINK_URL (및 선택적 ANALYTICS_SINK_TOKEN)을 설정하여 모든 HTTP 엔드포인트로 원시 이벤트를 POST할 수 있습니다.

두 옵션 모두 비차단 방식이며 오류를 발생시키지 않으므로 분석 실패가 MCP를 중단시키지 않습니다.

UTM 속성 추적

MCP가 반환하는 모든 URL에는 태그가 지정됩니다:

https://eventflare.io/spaces/london/skyline-glass-hall?utm_source=mcp&utm_medium=ai&utm_campaign=search_venues&utm_content=claude_desktop&mcp_session=abc123

따라서 플래너가 클릭하여 문의를 제출하면 기존 GA4 / Mixpanel / CRM에서 소스를 mcp / ai로 인식합니다. 이것이 "MCP가 실제로 리드를 유도했는가?"를 측정하는 핵심 지표입니다.

개발

npm run dev        # tsx, no build
npm run inspect    # MCP Inspector UI

배포

Railway: 저장소를 푸시하고 대시보드에서 환경 변수를 설정한 후 TRANSPORT=http를 설정하세요. 상태 확인은 /health입니다. 대시보드는 /dashboard?key=...입니다.

라이선스

MIT — © Eventflare