Fooodo / Dokumentācija

Insights MCP serveris

Pievienojiet ChatGPT, Claude, Copilot vai Gemini savam Fooodo Insights nomniekam, izmantojot attālo Model Context Protocol serveri.

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

Fooodo Insights nodrošina katram nomniekam atsevišķu attālo Model Context Protocol serveri. Tas pakļauj jūsu organizācijas darbības analītiku un nelielu skaitu ierobežotu rakstīšanas darbību 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 nomniekam, kuram ir ieslēgts mcp_enabled funkcijas karogs. Pēc noklusējuma karogs ir izslēgts katrai organizācijai; sazinieties ar support@fooodo.com, lai pieprasītu aktivizāciju un saņemtu sava nomnieka MCP URL.

Divi MCP serveri, viena produktu saime. Šī lapa aptver Insights MCP serveri, kas pakļauj katram nomniekam paredzētu 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 atdalī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 atbilstošo 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ēram, 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".
  • Nomnieku izolācija. Rīki ir ierobežoti lietotāja organizācijas līmenī datu bāzes slānī; piekļuve starp nomniekiem nav iespējama.

Pievienojiet no sava AI

Insights MCP serveris izmanto OAuth 2.1 ar dinamisko klientu reģistrāciju, 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 nomnieka URL, noklikšķiniet uz Savienot, piesakieties ar savu Fooodo Insights kontu, apstipriniet tvērumus — gatavs.

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

ChatGPT (Plus / Pro / Enterprise)

  1. Atveriet Settings → Connectors → Add custom connector (jābūt ieslēgtam izstrādātāja režīmam).
  2. Servera URL: <INSIGHTS_MCP_URL>.
  3. Apstipriniet piekrišanas lapu, kad tiek prasīts.

Claude.ai (Pro un augstāk)

  1. Atveriet Settings → Connectors → Add custom connector.
  2. Nosaukums: Fooodo Insights. Servera URL: <INSIGHTS_MCP_URL>.
  3. 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:

LauksVērtība
Servera URL<INSIGHTS_MCP_URL>
AutentifikācijaOAuth 2.0 (dinamiskā klientu reģistrācija)
Nepieciešamie tvērumiinsights: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īksAtgriež
get_period_summaryApkopotie rādītāji par datumu diapazonu — pārdošana, COGS, EBIT, bruto peļņas norma, labākās kampaņas
get_weekly_sales_dataNedēļu pa nedēļai pārdošanas dati ar aktīvajām kampaņām un izmaksu datiem
get_channel_statsVeiktspējas rādītāji pa kanāliem (ēšana uz vietas, piegāde, virtuālā virtuve u.c.)
get_daily_performanceDienu pa dienai pārdošana pa kanāliem un restorāniem
get_product_performanceProduktu/ēdienkartes pozīciju ranžēšana pēc peļņas normas un apjoma
get_cfo_pnl_dataP&L sadalījums — ieņēmumi, COGS, darbaspēks, OpEx, EBIT — CFO informācijas paneļa skatam

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

RīksAtgriež
consult_financial_analystTikai finanšu "kāpēc" analīze, kas balstīta perioda datos
consult_marketing_strategistTikai mārketinga cēloņsakarību un kampaņu atribūcijas analīze
consult_market_researchTirgus konteksts — sezonalitāte, svētki, patērētāju uzvedības tendences

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

RīksAtgriež
ask_orchestratorNovirza 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īksAtgriež
searchIeskatu un aģentu darbību vēstures saraksts, kas atbilst vaicājumam — {id, title, url, snippet}
fetchPilns dokumenta saturs pēc id no search{id, title, text, url, metadata}

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

RīksDarbība
trigger_data_importNekavējoties aktivizē konfigurētu ieplānotu failu iegūšanu (asinhroni — atgriež job_id)
acknowledge_alertAtzīmē brīdinājumu kā apstiprinātu
resolve_alertAtrisina brīdinājumu
generate_reportĢenerē PDF pārskatu (asinhroni)
regenerate_insightsAtkārtoti palaiž ieskatu ģeneratoru organizācijai (asinhroni)
get_job_statusAptaujā asinhrona uzdevuma statusu

Uzvednes

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

Drošība un ierobežojumi

  • OAuth 2.1 + PKCE, publiskie klienti, rotējošie atjaunināšanas tokeni. Piekļuves tokeni ir HS256 JWT, kas derīgi vienu stundu. Atjaunināšanas tokeni ir derīgi 60 dienas, glabāti kā SHA-256 jaucējvērtības, vienreizlietojami rotācijas laikā.
  • Organizācijas līmeņa vārteja ar mcp_enabled funkcijas karogu — pēc noklusējuma izslēgts 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ālistu un orķestratora rīki 10 reizes 5 min laikā; rakstīšanas rīki 5 reizes 5 min laikā.
  • 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. Katrs rakstīšanas rīka izsaukums tiek reģistrēts auditācijas žurnālā ar source: "mcp", iekļaujot klienta nosaukumu, lietotāju un ievades lietderīgo slodzi.
  • Nomnieku izolācija datu bāzes slānī. Katrs vaicājums tiek ierobežots ar lietotāja organizāciju, pirms tas atstāj lietojumprogrammu; serveris nevar atgriezt starpnomnieku datus.

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).
  • Dinamiskā klientu reģistrācija: 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 (pēc noklusējuma) un insights:write (rakstīšanas rīkiem).
  • Transports: Straumējams HTTP, MCP protokola versija 2025-06-18.

Ievērotie standarti: MCP 2025-06-18, RFC 6749 (OAuth 2.0), RFC 7636 (PKCE), RFC 7591 (dinamiskā klientu reģistrācija), RFC 8414 (autorizācijas servera metadati), RFC 9728 (aizsargātā resursa metadati).

Šajā lapā