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.

Инструменты

Инструмент	Описание
`search_venues`	Поиск площадок по городу + вместимости + категории + типу мероприятия. Возвращает названия, цены, вместимость по рассадке, район, фотографии, URL-адреса.
`get_venue_details`	Полная информация о конкретной площадке.
`get_city_info`	Обзор доступных предложений в городе — количество площадок, категории, ценовой диапазон.
`list_cities`	Все 40+ городов с количеством площадок и URL-адресами. Фильтрация по региону.
`get_pricing_guide`	Ориентировочные цены по городам и категориям.
`find_expert_advice`	Вывод редакционных статей из библиотеки экспертных советов Eventflare для города.
`request_quote`	Генерация URL-адреса запроса с UTM-меткой (без отправки данных).

Все инструменты включают 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.

Переменная	По умолчанию	Назначение
`EVENTFLARE_API_TOKEN`	(обязательно)	Токен Strapi API, роль `mcp-readonly`
`EVENTFLARE_API_URL`	`https://content.eventflare.io/api`	Базовый URL API
`EVENTFLARE_URL`	`https://eventflare.io`	Базовый URL сайта для исходящих ссылок
`TRANSPORT`	`stdio`	`stdio` или `http`
`PORT`	`3001`	HTTP-порт
`RATE_LIMIT`	`60`	Запросов/мин на IP для `/mcp`
`DASHBOARD_KEY`	(не задано)	Если задано, `/dashboard` требует `?key=...`
`OPENPANEL_CLIENT_ID`	(не задано)	ID проекта OpenPanel (включает удаленный sink)
`OPENPANEL_CLIENT_SECRET`	(не задано)	Ключ записи OpenPanel
`OPENPANEL_API_URL`	`https://api.openpanel.dev`	Базовый URL OpenPanel
`ANALYTICS_SINK_URL`	(не задано)	Резервный универсальный вебхук
`ANALYTICS_SINK_TOKEN`	(не задано)	Bearer-токен для вебхука
`LOG_DIR`	`./logs`	Локальные логи JSONL

Модель безопасности

Только чтение — никаких 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=....

Eventflare MCP