Eventflare MCP Server v2

Делает производственные данные Eventflare о площадках доступными для запросов ИИ-ассистентами — Claude, ChatGPT, Perplexity, Cursor — через протокол Model Context Protocol.

Более 8000 площадок для корпоративных мероприятий в 40+ городах. Разработано таким образом, чтобы LLM ссылались на URL-адреса Eventflare в своих ответах, а атрибуция лидов была измеримой от начала до конца.

Что нового в v2

• Production API + JWT-авторизация — было: dev 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 sink — события дублируются в OpenPanel (или любой вебхук) для команды аналитиков

• Новый инструмент: find_expert_advice — выводит редакционные статьи Eventflare. Дифференциатор для цитирования LLM.

Related MCP server: EvHenter MCP

Инструменты

Все инструменты включают citation_url и quotable_summary для каждого результата, оптимизированные для ответов LLM.

Быстрый старт

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.

• Ограничение частоты запросов — 60 запросов/мин на IP для /mcp (транспорт HTTP).

• PII не логируются — поля аналитики: инструмент, город, вместимость, тип мероприятия, категория, количество результатов, ID сессии, класс клиента, ценовой диапазон. Никогда не логируются личность пользователя или содержание сообщений.

• Универсальные сообщения об ошибках — внутренние ошибки API отображаются как стабильные строки для пользователя ("Eventflare API временно недоступен"); подробности отправляются только в stderr.

Аналитика

Локально: каждый вызов инструмента добавляется в logs/queries.jsonl и отображается на /dashboard.

Удаленно: если заданы OPENPANEL_CLIENT_ID + OPENPANEL_CLIENT_SECRET, каждое событие дублируется как событие отслеживания mcp.{tool} с profileId = sessionId. Используйте OPENPANEL_API_URL, чтобы указать на self-hosted OpenPanel.

Или установите ANALYTICS_SINK_URL (+ опционально ANALYTICS_SINK_TOKEN) для отправки POST-запросов с необработанными событиями на любой HTTP-эндпоинт.

Оба варианта не блокируют работу и не вызывают исключений — сбои аналитики не нарушают работу MCP.

UTM-атрибуция

Каждый URL, возвращаемый MCP, помечен:

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