Insights MCP server

Подключите ChatGPT, Claude, Copilot или Gemini к вашему тенанту Fooodo Insights через удалённый сервер Model Context Protocol.

Auto-translated · pending native review. The English version is canonical.

Fooodo Insights поставляется с удалённым Model Context Protocol-сервером для каждого тенанта. Он открывает операционную аналитику вашей организации и ограниченный набор операций записи любому AI-клиенту, поддерживающему MCP, — без API-ключей, пользовательских интеграций и копирования данных вручную.

Кто может использовать? Любой клиент Fooodo Insights с доступом admin, analyst или viewer к тенанту, у которого включён флаг функциональности mcp_enabled. По умолчанию флаг отключён для всех организаций; обратитесь на support@fooodo.com, чтобы запросить активацию и получить MCP URL вашего тенанта.

Два MCP-сервера, одно семейство продуктов. Эта страница посвящена MCP-серверу Insights, который предоставляет операционную аналитику на уровне тенанта через OAuth 2.1. Отдельный MCP-сервер маркетингового справочника работает по адресу /api/mcp на fooodo.com и является публичным — агенты используют его, чтобы узнать, что такое Fooodo, и отправить лид-запросы. Эти две поверхности намеренно разделены: содержимое справочника и данные клиентов.

Зачем нужен MCP

MCP — открытый стандарт, который AI-клиенты используют для взаимодействия с удалёнными данными и инструментами: это аналог OAuth + REST для агентов. Один MCP-сервер достаточно добавить один раз, и им смогут пользоваться ChatGPT, Claude, Copilot, Gemini, Cursor, Windsurf, Zed и растущий список совместимых клиентов.

Для клиентов Fooodo Insights это означает:

Отсутствие привязки к поставщику. Ваш аналитик может задать один и тот же вопрос из ChatGPT сегодня и из Gemini завтра, не меняя никаких настроек.
Ограниченные, аудируемые действия. Инструменты записи (например, запустить импорт данных, подтвердить оповещение) требуют области видимости insights:write и роли admin или analyst. Каждая операция записи фиксируется в журнале аудита с пометкой source: "mcp".
Изоляция тенантов. Инструменты ограничены организацией пользователя на уровне базы данных; межтенантный доступ невозможен.

Подключение из вашего AI

MCP-сервер Insights поддерживает OAuth 2.1 с Dynamic Client Registration, поэтому все перечисленные ниже клиенты используют одинаковый процесс в один клик: вставьте URL тенанта, нажмите Подключить, войдите в свою учётную запись Fooodo Insights, подтвердите области видимости — готово.

В примерах ниже используется <INSIGHTS_MCP_URL> в качестве заполнителя. Замените его на URL, который служба поддержки Fooodo пришлёт вам после включения MCP для вашего тенанта.

ChatGPT (Plus / Pro / Enterprise)

Откройте Settings → Connectors → Add custom connector (необходимо включить режим разработчика).
URL сервера: <INSIGHTS_MCP_URL>.
Подтвердите страницу согласия при появлении запроса.

Claude.ai (Pro и выше)

Откройте Settings → Connectors → Add custom connector.
Имя: Fooodo Insights. URL сервера: <INSIGHTS_MCP_URL>.
Подтвердите страницу согласия.

GitHub Copilot (VS Code 1.101+, JetBrains, Visual Studio)

Добавьте в файл .vscode/mcp.json вашего рабочего пространства:

{
  "servers": {
    "fooodo-insights": {
      "type": "http",
      "url": "<INSIGHTS_MCP_URL>"
    }
  }
}

Если вы используете Copilot Business/Enterprise, ваш администратор должен сначала включить политику MCP servers in Copilot.

Gemini CLI

Добавьте в конфигурацию Gemini CLI:

{
  "mcpServers": {
    "fooodo-insights": {
      "url": "<INSIGHTS_MCP_URL>",
      "oauth": true
    }
  }
}

Gemini Enterprise

В консоли Google Cloud зарегистрируйте сервер как пользовательское хранилище данных MCP:

Поле	Значение
URL сервера	`<INSIGHTS_MCP_URL>`
Аутентификация	OAuth 2.0 (Dynamic Client Registration)
Обязательные области видимости	`insights:read`, `insights:write`

Что может делать агент

Сервер предоставляет инструменты трёх уровней. Клиентам следует выбирать наименьший уровень, достаточный для ответа на вопрос, — это дешевле, быстрее и детерминировано.

Уровень 1 — Инструменты данных (быстрые, детерминированные, только чтение)

Инструмент	Возвращает
`get_period_summary`	Агрегированные метрики за диапазон дат — продажи, COGS, EBIT, валовая маржа, топ-кампании
`get_weekly_sales_data`	Понедельные продажи с активными кампаниями и данными о затратах
`get_channel_stats`	Метрики эффективности по каналам (зал, доставка, тёмная кухня и др.)
`get_daily_performance`	Ежедневные продажи по каналам и ресторанам
`get_product_performance`	Рейтинг продуктов/позиций меню по марже и объёму
`get_cfo_pnl_data`	Разбивка P&L — выручка, COGS, труд, операционные расходы, EBIT — для представления на дашборде CFO

Уровень 2 — Специализированные агенты (LLM-анализ в рамках одной предметной области)

Инструмент	Возвращает
`consult_financial_analyst`	Финансовый анализ причин, основанный на данных периода
`consult_marketing_strategist`	Маркетинговый анализ причинно-следственного прироста и атрибуции кампаний
`consult_market_research`	Рыночный контекст — сезонность, праздники, тенденции потребительского поведения

Уровень 3 — Оркестратор (межпредметный синтез)

Инструмент	Возвращает
`ask_orchestrator`	Направляет межпредметный вопрос всем специализированным агентам и синтезирует единый ответ

Поиск и получение данных (ChatGPT Deep Research, универсальные клиенты)

Инструмент	Возвращает
`search`	Список аналитических материалов и истории действий агентов, соответствующих запросу, — `{id, title, url, snippet}`
`fetch`	Полное содержимое документа по идентификатору из `search` — `{id, title, text, url, metadata}`

Инструменты записи (требуют `insights:write` + роль `admin`/`analyst`)

Инструмент	Действие
`trigger_data_import`	Немедленно запускает настроенную плановую загрузку файлов (асинхронно — возвращает `job_id`)
`acknowledge_alert`	Помечает оповещение как подтверждённое
`resolve_alert`	Закрывает оповещение
`generate_report`	Генерирует PDF-отчёт (асинхронно)
`regenerate_insights`	Повторно запускает генератор аналитики для организации (асинхронно)
`get_job_status`	Опрашивает статус асинхронного задания

Промпты

weekly_business_review, margin_diagnosis — промпты в виде слэш-команд для ChatGPT Apps и других клиентов, поддерживающих промпты.

Безопасность и ограничения

OAuth 2.1 + PKCE, публичные клиенты, ротируемые токены обновления. Токены доступа — это HS256 JWT, действительные в течение одного часа. Токены обновления действительны 60 дней, хранятся в виде SHA-256-хешей и являются одноразовыми при ротации.
Управление доступом на уровне организации через флаг функциональности mcp_enabled — по умолчанию отключён для всех организаций. Активация осуществляется через обращение в поддержку, а не через самостоятельное переключение, что позволяет клиентам поэтапно развёртывать функцию.
Ограничения частоты запросов на пользователя по уровням. Инструменты данных — 60 в минуту; специализированные агенты и оркестратор — 10 за 5 минут; инструменты записи — 5 за 5 минут.
Отзыв доступа. Пользователи могут отозвать доступ любого клиента в любое время в настройках учётной записи (/account/connected-apps на стороне Insights). Администраторы могут отзывать доступ на уровне всей организации.
Журнал аудита. Каждый вызов инструмента записи фиксируется в журнале аудита с пометкой source: "mcp", включая имя клиента, пользователя и входные данные.
Изоляция тенантов на уровне базы данных. Каждый запрос ограничивается организацией пользователя до выхода из приложения; сервер не может вернуть данные другого тенанта.

Для разработчиков агентов

URL обнаружения: <INSIGHTS_MCP_URL>/.well-known/oauth-authorization-server (и с суффиксом /mcp, согласно RFC 8414 §3.1).
Метаданные защищённого ресурса: <INSIGHTS_MCP_URL>/.well-known/oauth-protected-resource/mcp (согласно RFC 9728).
Dynamic Client Registration: POST <INSIGHTS_MCP_URL>/register — открытая регистрация, однако каждая авторизация по-прежнему требует интерактивного согласия.
Области видимости: insights:read (по умолчанию) и insights:write (для инструментов записи).
Транспорт: Streamable HTTP, версия протокола MCP 2025-06-18.

Используемые стандарты: MCP 2025-06-18, RFC 6749 (OAuth 2.0), RFC 7636 (PKCE), RFC 7591 (Dynamic Client Registration), RFC 8414 (Authorization Server Metadata), RFC 9728 (Protected Resource Metadata).

Insights MCP server

На этой странице