Insights MCP serveris

Savienojiet ChatGPT, Claude, Copilot vai Gemini ar savu Fooodo Insights tenant, izmantojot attālo Model Context Protocol serveri.

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

Fooodo Insights nodrošina katram tenant atsevišķu attālo Model Context Protocol serveri. Tas pakļauj jūsu organizācijas darbības analītiku un nelielu ierobežotu rakstīšanas darbību kopu jebkuram AI klientam, kas izmanto MCP — bez API atslēgām, pielāgotām integrācijām vai kopēšanas un ielīmēšanas.

Kas var to izmantot? Jebkurš Fooodo Insights klients ar admin, analyst vai viewer piekļuvi tenant, kuram ir ieslēgts mcp_enabled funkcijas karogs. Karogs pēc noklusējuma ir slēpts katrai organizācijai; sazinieties ar support@fooodo.com, lai pieprasītu aktivizāciju un saņemtu sava tenant MCP URL.

Divi MCP serveri, viena produktu saime. Šī lapa aptver Insights MCP serveri, kas pakļauj katram tenant atsevišķu darbības analītiku, izmantojot OAuth 2.1. Atsevišķs mārketinga rokasgrāmatas MCP serveris darbojas /api/mcp adresē vietnē fooodo.com un ir publiski pieejams — aģenti to izmanto, lai uzzinātu, kas ir Fooodo, un iesniegtu potenciālo klientu pieprasījumus. Abas virsmas ir apzināti nodalītas: rokasgrāmatas saturs pret klientu datiem.

Kāpēc MCP

MCP ir atvērtais standarts, ko AI klienti izmanto, lai sazinātos ar attāliem datiem un rīkiem — aģenta ekvivalents OAuth + REST. Vienu MCP serveri var pievienot vienreiz un atkārtoti izmantot ar ChatGPT, Claude, Copilot, Gemini, Cursor, Windsurf, Zed un arvien pieaugošo saderīgo klientu sarakstu.

Fooodo Insights klientiem tas nozīmē:

Nav piesaistes konkrētam piegādātājam. Jūsu analītiķis var uzdot to pašu jautājumu no ChatGPT šodien un no Gemini rīt, neko nepārkonfigurējot.
Ierobežotas, auditētas darbības. Rakstīšanas rīkiem (piem., aktivizēt datu importu, apstiprināt brīdinājumu) nepieciešams insights:write tvērums un admin vai analyst loma. Katra rakstīšanas darbība tiek reģistrēta auditācijas žurnālā ar source: "mcp".
Tenant izolācija. Rīki ir ierobežoti līdz lietotāja organizācijai datu bāzes līmenī; piekļuve starp tenant nav iespējama.

Savienojums no jūsu AI

Insights MCP serveris izmanto OAuth 2.1 ar Dynamic Client Registration, tāpēc katrs tālāk norādītais klients izmanto vienu un to pašu viena klikšķa plūsmu: ielīmējiet sava tenant URL, noklikšķiniet uz Connect, piesakieties ar savu Fooodo Insights kontu, apstipriniet tvērumus — gatavs.

Tālāk sniegtajos fragmentos kā vietturis tiek izmantots <INSIGHTS_MCP_URL>. Aizstājiet to ar URL, ko Fooodo atbalsts nosūta pēc MCP aktivizēšanas jūsu tenant.

ChatGPT (Plus / Pro / Enterprise)

Atveriet Settings → Connectors → Add custom connector (jābūt ieslēgtam Developer Mode).
Servera URL: <INSIGHTS_MCP_URL>.
Apstipriniet piekrišanas lapu, kad tiek prasīts.

Claude.ai (Pro un augstāk)

Atveriet Settings → Connectors → Add custom connector.
Nosaukums: Fooodo Insights. Servera URL: <INSIGHTS_MCP_URL>.
Apstipriniet piekrišanas lapu.

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

Pievienojiet sava darbvietas .vscode/mcp.json failam:

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

Ja izmantojat Copilot Business/Enterprise, jūsu administratoram vispirms jāiespējo politika MCP servers in Copilot.

Gemini CLI

Pievienojiet savam Gemini CLI konfigurācijas failam:

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

Gemini Enterprise

Google Cloud konsolē reģistrējiet serveri kā pielāgotu MCP datu krātuvi:

Lauks	Vērtība
Server URL	`<INSIGHTS_MCP_URL>`
Authentication	OAuth 2.0 (Dynamic Client Registration)
Required scopes	`insights:read`, `insights:write`

Ko aģents var darīt

Serveris pakļauj rīkus trīs līmeņos. Klientiem jāizvēlas zemākais līmenis, kas atbild uz jautājumu — tas ir lētāk, ātrāk un deterministiski.

1. līmenis — Datu rīki (ātri, deterministiski, tikai lasīšana)

Rīks	Atgriež
`get_period_summary`	Apkopotas metrikas par datumu diapazonu — pārdošana, COGS, EBIT, bruto peļņas norma, labākās kampaņas
`get_weekly_sales_data`	Nedēļu pa nedēļai pārdošanas dati ar aktīvajām kampaņām un izmaksu datiem
`get_channel_stats`	Veiktspējas metrikas pa mārketinga kanāliem — kampaņas un iegūšanas kanāli, nevis ēšanas uz vietas/piegādes sadalījums (tam izmantojiet `get_channel_breakdown`)
`get_daily_performance`	Dienu pa dienai pārdošana pa kanāliem un restorāniem
`get_product_performance`	Produktu/ēdienkartes pozīciju ranžēšana pēc pārdošanas un daudzuma ar kategoriju sadalījumu
`get_cfo_pnl_data`	P&L sadalījums — ieņēmumi, COGS, darbaspēks, OpEx, EBIT — CFO informācijas paneļa skatam
`get_restaurant_performance`	Pārdošanas sadalījums pa restorāniem/atrašanās vietām par datumu diapazonu, ar katras atrašanās vietas daļu no ķēdes kopsummas
`get_channel_breakdown`	Pārdošanas kanālu sadalījums (ēšana uz vietas / piegāde / Wolt / Bolt / paņemšana) ar € un % daļu — pārdošanas puses atbilstošais rīks; mārketinga kanāli atrodas `get_channel_stats`
`get_check_metrics`	Vidējais čeks (€, bez PVN), ēdieni uz čeku un čeku skaits par datumu diapazonu — ar sadalījumu pa pasūtījumu veidiem un restorāniem
`get_table_times`	Vidējais galda slēgšanas laiks (minūtēs) un pasūtījumu skaits — apkalpošanas ātruma signāls — ar izvēles pasūtījumu veida un restorāna sadalījumu
`get_waiter_times`	Vidējie galda slēgšanas laiki pa viesmīļiem vienam restorānam (nepieciešams `restaurant_id`)
`get_guest_feedback`	Viesu apmierinātība — NPS aptaujas rezultāti (ēdiens / apkalpošana / restorāns) un jaunākie Google atsauksmju vērtējumi pa restorāniem
`get_cash_position`	Pašreizējais naudas atlikums, iknedēļas izdevumu temps, skrejceļš un atlikumi pa juridiskajām personām
`get_goals_vs_actuals`	KPI mērķi (vidējais čeks, ēdieni uz čeku) un ikdienas pārdošanas budžets pret faktisko, ar pasūtījumu skaita izpildi
`get_monthly_sales_plan`	Uz nākotni vērsts ikmēneša pārdošanas plāns — ieņēmumu un pasūtījumu skaita budžets pa kanāliem un restorāniem, ieskaitot nākamos mēnešus
`get_marketing_spend`	Ikmēneša mārketinga izdevumi (no P&L) un kampaņu kalendārs par diapazonu
`list_restaurants`	Restorānu katalogs (id, kods, nosaukums, pilsēta) — atrisina nosaukumu vai kodu uz `restaurant_id`, pēc kura filtrē pārējie datu rīki
`get_menu_sales`	Ēdienu pārdošanas sadalījums pa gadiem pa restorāniem vai pilsētām (tikai pusdienas vai vispārīgi), ar izvēles kanāla filtru

2. līmenis — Speciālistu aģenti (vienas jomas LLM analīze)

Rīks	Atgriež
`consult_financial_analyst`	Tikai finanšu "kāpēc" analīze, kas balstīta perioda datos
`consult_marketing_strategist`	Tikai mārketinga cēloņsakarību un kampaņu atribūcijas analīze
`consult_market_research`	Tirgus konteksts — sezonalitāte, svētki, patērētāju uzvedības tendences

Speciālistu atbildes tiek aprēķinātas, nevis improvizētas: daudzpakāpju aritmētiku veic deterministisks servera puses kalkulators, nevis LLM mentālā matemātika, un katrs skaitlis satur ticamības etiķeti un avota atsauci. Peļņas ietekmes jautājumiem vispirms iegūstiet P&L bāzlīniju ar get_cfo_pnl_data un nododiet attiecīgos skaitļus (bāzlīnijas EBIT, izmaksas) uz consult_financial_analyst — speciālista paša rīki aptver tikai pārdošanas datus.

3. līmenis — Orķestrators (starpjomu sintēze)

Rīks	Atgriež
`ask_orchestrator`	Novirza starpjomu jautājumu visiem speciālistu aģentiem un sintezē vienu atbildi

Meklēšana un iegūšana (ChatGPT Deep Research, vispārīgi klienti)

Rīks	Atgriež
`search`	Atziņu un aģentu darbību vēstures saraksts, kas atbilst vaicājumam — `{id, title, url, snippet}`
`fetch`	Pilns dokumenta saturs pēc id no `search` — `{id, title, text, url, metadata}`

Rakstīšanas rīki (nepieciešams `insights:write` + `admin`/`analyst` loma)

Rīks	Darbība
`trigger_data_import`	Nekavējoties aktivizē konfigurētu ieplānotu failu iegūšanu (asinhroni — atgriež `job_id`)
`acknowledge_alert`	Atzīmē brīdinājumu kā apstiprinātu
`resolve_alert`	Atrisina brīdinājumu
`generate_report`	Ģenerē biznesa pārskatu — vadītāju kopsavilkumu, kampaņu veiktspēju, kanālu analīzi — par datumu diapazonu; asinhroni (atgriež `job_id`), pēc izvēles nosūta pa e-pastu
`regenerate_insights`	Atkārtoti palaiž atziņu ģeneratoru organizācijai (asinhroni)
`get_job_status`	Aptaujā asinhrona uzdevuma statusu

Uzvednes

weekly_business_review, margin_diagnosis — slīpsvītras komandu uzvednes ChatGPT Apps un citiem klientiem, kas atbalsta uzvednes.

Drošība un ierobežojumi

OAuth 2.1 + PKCE, publiskie klienti, rotējoši atjaunošanas tokeni. Piekļuves tokeni ir HS256 JWT, kas derīgi vienu stundu. Atjaunošanas tokeni ir derīgi 60 dienas, glabāti kā SHA-256 jaucējvērtības, vienreizlietojami rotācijas laikā.
Katras organizācijas vārteja ar mcp_enabled funkcijas karogu — pēc noklusējuma slēpts katrai organizācijai. Aktivizēšana notiek ar atbalsta pieteikumu, nevis pašapkalpošanās pārslēgu, lai klienti varētu pakāpeniski ieviest.
Ātruma ierobežojumi pa līmeņiem katram lietotājam. Datu rīki 60/min; speciālisti un orķestrators 10 reizes 5 minūtēs; rakstīšanas rīki 5 reizes 5 minūtēs.
Atsaukšana. Lietotāji var atsaukt jebkuru klientu jebkurā laikā no sava konta iestatījumiem (/account/connected-apps Insights pusē). Administratori var atsaukt visas organizācijas līmenī.
Auditācijas pieraksts. Katra rakstīšanas rīka izsaukums tiek reģistrēts auditācijas žurnālā ar source: "mcp", ieskaitot klienta nosaukumu, lietotāju un ievades datus.
Tenant izolācija datu bāzes līmenī. Katrs vaicājums tiek ierobežots līdz lietotāja organizācijai pirms tas atstāj lietojumprogrammu; serveris nevar atgriezt datus no cita tenant.

Aģentu izstrādātājiem

Atklāšanas URL: <INSIGHTS_MCP_URL>/.well-known/oauth-authorization-server (un ar /mcp sufiksu, saskaņā ar RFC 8414 §3.1).
Aizsargātā resursa metadati: <INSIGHTS_MCP_URL>/.well-known/oauth-protected-resource/mcp (saskaņā ar RFC 9728).
Dynamic Client Registration: POST <INSIGHTS_MCP_URL>/register — atvērta reģistrācija, taču katrai autorizācijai joprojām nepieciešama interaktīva piekrišana.
Tvērumi: insights:read (noklusējums) un insights:write (rakstīšanas rīkiem).
Transports: Streamable HTTP, MCP protokola versija 2025-06-18.

Ievērotie standarti: 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 serveris

Šajā lapā