Insights MCP serveris

Prijunkite ChatGPT, Claude, Copilot ar Gemini prie savo Fooodo Insights tenanto per nuotolinį Model Context Protocol serverį.

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

Fooodo Insights pateikiamas atskiras kiekvienam tenantui skirtas nuotolinis Model Context Protocol serveris. Jis atskleidžia jūsų organizacijos veiklos analitiką ir nedidelį rinkinį ribotų rašymo veiksmų bet kuriam AI klientui, kuris palaiko MCP — be API raktų, pasirinktinių integracijų ar kopijavimo ir įklijavimo.

Kas gali naudotis? Bet kuris Fooodo Insights klientas, turintis admin, analyst ar viewer prieigą prie tenanto, kuriam įjungta mcp_enabled funkcijos vėliavėlė. Pagal numatytuosius nustatymus vėliavėlė yra išjungta kiekvienai organizacijai; susisiekite su support@fooodo.com, kad paprašytumėte įjungimo ir gautumėte savo tenanto MCP URL.

Du MCP serveriai, viena produktų šeima. Šis puslapis aprašo Insights MCP serverį, kuris atskleidžia kiekvieno tenanto veiklos analitiką per OAuth 2.1. Atskiras rinkodaros vadovo MCP serveris veikia adresu /api/mcp svetainėje fooodo.com ir yra viešas — agentai jį naudoja, kad sužinotų, kas yra Fooodo, ir pateiktų potencialių klientų užklausas. Abi sąsajos yra sąmoningai atskirtos: vadovo turinys ir kliento duomenys.

Kodėl MCP

MCP yra atviras standartas, kurį AI klientai naudoja bendravimui su nuotoliniais duomenimis ir įrankiais — agento atitikmuo OAuth + REST. Vieną MCP serverį galima pridėti vieną kartą ir pakartotinai naudoti su ChatGPT, Claude, Copilot, Gemini, Cursor, Windsurf, Zed ir augančiu sąrašu suderinamų klientų.

Fooodo Insights klientams tai reiškia:

Jokio priklausomumo nuo tiekėjo. Jūsų analitikas gali užduoti tą patį klausimą ChatGPT šiandien ir Gemini rytoj, nieko iš naujo nekonfigūruodamas.
Riboti, audituojami veiksmai. Rašymo įrankiams (pvz., paleisti duomenų importą, patvirtinti įspėjimą) reikalinga insights:write apimtis ir admin arba analyst vaidmuo. Kiekvienas rašymo veiksmas įrašomas audito žurnale su source: "mcp".
Tenantų izoliacija. Įrankiai yra apriboti vartotojo organizacijos duomenų bazės lygiu; prieiga tarp tenantų yra neįmanoma.

Prisijunkite iš savo AI

Insights MCP serveris naudoja OAuth 2.1 su dinaminiu kliento registravimu, todėl kiekvienas toliau nurodytas klientas naudoja tą patį vieno paspaudimo srautą: įklijuokite savo tenanto URL, spustelėkite Prisijungti, prisijunkite su savo Fooodo Insights paskyra, patvirtinkite apimtis — atlikta.

Toliau pateiktuose fragmentuose <INSIGHTS_MCP_URL> naudojamas kaip vietos žymiklis. Pakeiskite jį URL, kurį Fooodo palaikymo komanda atsiųs jums įjungus MCP jūsų tenantui.

ChatGPT (Plus / Pro / Enterprise)

Atidarykite Settings → Connectors → Add custom connector (turi būti įjungtas kūrėjo režimas).
Serverio URL: <INSIGHTS_MCP_URL>.
Patvirtinkite sutikimo puslapį, kai būsite paraginti.

Claude.ai (Pro ir aukštesnė versija)

Atidarykite Settings → Connectors → Add custom connector.
Pavadinimas: Fooodo Insights. Serverio URL: <INSIGHTS_MCP_URL>.
Patvirtinkite sutikimo puslapį.

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

Pridėkite į savo darbo srities .vscode/mcp.json:

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

Jei naudojate Copilot Business/Enterprise, jūsų administratorius pirmiausia turi įjungti MCP servers in Copilot politiką.

Gemini CLI

Pridėkite į savo Gemini CLI konfigūraciją:

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

Gemini Enterprise

Google Cloud konsolėje užregistruokite serverį kaip pasirinktinę MCP duomenų saugyklą:

Laukas	Reikšmė
Serverio URL	`<INSIGHTS_MCP_URL>`
Autentifikavimas	OAuth 2.0 (dinaminis kliento registravimas)
Reikalingos apimtys	`insights:read`, `insights:write`

Ką agentas gali daryti

Serveris atskleidžia įrankius trijuose lygiuose. Klientai turėtų pasirinkti žemiausią lygį, kuris atsako į klausimą — tai pigiau, greičiau ir deterministiškai.

1 lygis — Duomenų įrankiai (greiti, deterministiniai, tik skaitymas)

Įrankis	Grąžina
`get_period_summary`	Apibendrinti rodikliai už datos intervalą — pardavimai, COGS, EBIT, bendroji marža, geriausios kampanijos
`get_weekly_sales_data`	Savaitiniai pardavimai su aktyviomis kampanijomis ir išlaidų duomenimis
`get_channel_stats`	Rinkodaros kanalo veiklos rodikliai — kampanijos ir įsigijimo kanalai, o ne maitinimo vietoje / pristatymo padalijimas (tam naudokite `get_channel_breakdown`)
`get_daily_performance`	Dienos pardavimai pagal kanalą ir restoraną
`get_product_performance`	Produktų / meniu elementų reitingas pagal pardavimus ir kiekį, su kategorijų suskirstymu
`get_cfo_pnl_data`	P&L suskirstymas — pajamos, COGS, darbo jėga, veiklos išlaidos, EBIT — CFO prietaisų skydelio rodinys
`get_restaurant_performance`	Pardavimų suskirstymas pagal restoraną / vietą datos intervalui, su kiekvienos vietos dalimi grandinės bendrame rodiklyje
`get_channel_breakdown`	Pardavimų kanalo padalijimas (maitinimas vietoje / pristatymas / Wolt / Bolt / pasiėmimas) su € ir % dalimi — pardavimų pusės atitikmuo; rinkodaros kanalai yra `get_channel_stats`
`get_check_metrics`	Vidutinis čekis (€, be PVM), patiekalai vienam čekiui ir čekių skaičiai datos intervalui — su padalijimais pagal užsakymo tipą ir restoraną
`get_table_times`	Vidutinis stalo uždarymo laikas (minutėmis) ir užsakymų skaičiai — paslaugų greičio signalas — su pasirinktiniais padalijimais pagal užsakymo tipą ir restoraną
`get_waiter_times`	Vidutinis stalo uždarymo laikas pagal padavėją viename restorane (reikalingas `restaurant_id`)
`get_guest_feedback`	Svečių pasitenkinimas — NPS apklausos balai (maistas / aptarnavimas / restoranas) ir naujausios Google apžvalgų įvertinimai pagal restoraną
`get_cash_position`	Dabartinis grynųjų pinigų likutis, savaitinis išlaidų tempas, veiklos trukmė ir likučiai pagal subjektą
`get_goals_vs_actuals`	KPI tikslai (vidutinis čekis, patiekalai vienam čekiui) ir dienos pardavimų biudžetas palyginti su faktiniu, su užsakymų skaičiaus įvykdymu
`get_monthly_sales_plan`	Perspektyvinis mėnesinis pardavimų planas — pajamų ir užsakymų skaičiaus biudžetas pagal kanalą ir restoraną, įskaitant būsimus mėnesius
`get_marketing_spend`	Mėnesinės rinkodaros išlaidos (iš P&L) ir kampanijų kalendorius intervalui
`list_restaurants`	Restoranų katalogas (id, kodas, pavadinimas, miestas) — pavadinimą ar kodą paverčia `restaurant_id`, pagal kurį filtruoja kiti duomenų įrankiai
`get_menu_sales`	Patiekalų pardavimų suskirstymas metų palyginimui pagal restoraną ar miestą (tik pietūs arba bendras), su pasirinktinu kanalo filtru

2 lygis — Specializuoti agentai (vienos srities LLM analizė)

Įrankis	Grąžina
`consult_financial_analyst`	Tik finansinė „kodėl" analizė, pagrįsta laikotarpio duomenimis
`consult_marketing_strategist`	Tik rinkodaros priežastinio poveikio ir kampanijų priskyrimo analizė
`consult_market_research`	Rinkos kontekstas — sezoniškumas, šventės, vartotojų elgsenos tendencijos

Specializuotų agentų atsakymai yra apskaičiuoti, o ne improvizuoti: kelių žingsnių aritmetika atliekama deterministiniu serverio pusės skaičiuotuvu, o ne LLM mintiniu skaičiavimu, ir kiekvienas skaičius turi pasitikėjimo metką ir šaltinio nuorodą. Pelno poveikio klausimams pirmiausia gaukite P&L bazinę liniją su get_cfo_pnl_data ir perduokite atitinkamus skaičius (bazinis EBIT, išlaidos) į consult_financial_analyst — specialisto nuosavi įrankiai apima tik pardavimų duomenis.

3 lygis — Orkestrantas (tarpdomaininė sintezė)

Įrankis	Grąžina
`ask_orchestrator`	Nukreipia tarpdomaininį klausimą visiems specializuotiems agentams ir sintetina vieną atsakymą

Paieška ir gavimas (ChatGPT Deep Research, bendrieji klientai)

Įrankis	Grąžina
`search`	Įžvalgų ir agento veiksmų istorijos, atitinkančių užklausą, sąrašas — `{id, title, url, snippet}`
`fetch`	Viso dokumento turinys pagal id iš `search` — `{id, title, text, url, metadata}`

Rašymo įrankiai (reikalinga `insights:write` + `admin`/`analyst` vaidmuo)

Įrankis	Atlieka
`trigger_data_import`	Iš karto paleidžia sukonfigūruotą suplanuotą failų gavimą (asinchroniškai — grąžina `job_id`)
`acknowledge_alert`	Pažymi įspėjimą kaip patvirtintą
`resolve_alert`	Išsprendžia įspėjimą
`generate_report`	Generuoja verslo ataskaitą — vykdomąją santrauką, kampanijų veiklą, kanalų analizę — datos intervalui; asinchroniškai (grąžina `job_id`), pasirinktinai siunčiama el. paštu
`regenerate_insights`	Iš naujo paleidžia įžvalgų generatorių organizacijai (asinchroniškai)
`get_job_status`	Tikrina asinchroninės užduoties būseną

Raginimai

weekly_business_review, margin_diagnosis — pasvirojo brūkšnio komandų raginimai ChatGPT Apps ir kitiems raginimus palaikantiems klientams.

Saugumas ir apribojimai

OAuth 2.1 + PKCE, vieši klientai, besisukantys atnaujinimo prieigos raktai. Prieigos raktai yra HS256 JWT, galiojantys vieną valandą. Atnaujinimo raktai galioja 60 dienų, saugomi kaip SHA-256 maišos, vienkartiniai rotacijos metu.
Organizacijos lygio valdymas per mcp_enabled funkcijos vėliavėlę — pagal numatytuosius nustatymus išjungta kiekvienai organizacijai. Įjungimas atliekamas per palaikymo užklausą, o ne savarankiškai, todėl klientai gali laipsniškai diegti.
Greičio apribojimai pagal lygį vienam vartotojui. Duomenų įrankiai — 60/min; specializuoti ir orkestrantas — 10 per 5 min; rašymo įrankiai — 5 per 5 min.
Atšaukimas. Vartotojai gali bet kada atšaukti bet kurį klientą iš savo paskyros nustatymų (/account/connected-apps Insights pusėje). Administratoriai gali atšaukti visos organizacijos lygiu.
Audito sekimas. Kiekvienas rašymo įrankio iškvietimas įrašomas audito žurnale su source: "mcp", įskaitant kliento pavadinimą, vartotoją ir įvesties naudingąją apkrovą.
Tenantų izoliacija duomenų bazės lygiu. Kiekviena užklausa yra apribota vartotojo organizacija prieš paliekant programą; serveris negali grąžinti tarptenantinių duomenų.

Agentų kūrėjams

Atradimo URL: <INSIGHTS_MCP_URL>/.well-known/oauth-authorization-server (ir su /mcp priesaga, pagal RFC 8414 §3.1).
Apsaugoto ištekliaus metaduomenys: <INSIGHTS_MCP_URL>/.well-known/oauth-protected-resource/mcp (pagal RFC 9728).
Dinaminis kliento registravimas: POST <INSIGHTS_MCP_URL>/register — atviras registravimas, tačiau kiekvienas leidimas vis tiek reikalauja interaktyvaus sutikimo.
Apimtys: insights:read (numatytoji) ir insights:write (rašymo įrankiams).
Transportas: srautinis HTTP, MCP protokolo versija 2025-06-18.

Laikytasi standartų: MCP 2025-06-18, RFC 6749 (OAuth 2.0), RFC 7636 (PKCE), RFC 7591 (dinaminis kliento registravimas), RFC 8414 (autorizacijos serverio metaduomenys), RFC 9728 (apsaugoto ištekliaus metaduomenys).

Insights MCP serveris

Šiame puslapyje