Insights MCP serveris

Fooodo Insights pateikia kiekvienam nuomininkui atskirą nuotolinį Model Context Protocol serverį. 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 nuomininko, 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 nuomininko MCP URL.

Du MCP serveriai, viena produktų šeima. Šis puslapis aprašo Insights MCP serverį, kuris per OAuth 2.1 atskleidžia kiekvieno nuomininko veiklos analitiką. 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. Šie du paviršiai yra sąmoningai atskirti: 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ą per ChatGPT šiandien ir per 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".
• Nuomininko izoliacija. Įrankiai yra apriboti vartotojo organizacija duomenų bazės lygiu; prieiga tarp nuomininkų 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 nuomininko 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ų nuomininkui.

ChatGPT (Plus / Pro / Enterprise)

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

Claude.ai (Pro ir aukštesnės versijos)

1. Atidarykite Settings → Connectors → Add custom connector.
2. Pavadinimas: Fooodo Insights. Serverio URL: <INSIGHTS_MCP_URL>.
3. 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ą:

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ška.

1 lygis — Duomenų įrankiai (greiti, deterministiški, tik skaitymas)

2 lygis — Specialistų agentai (vienos srities LLM analizė)

3 lygis — Orkestrantas (tarpdomaininė sintezė)

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

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

Raginimai

weekly_business_review, margin_diagnosis — pasvirojo brūkšnio komandų raginimai ChatGPT programoms ir kitiems raginimus palaikančiems 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.
• Lygio greičio apribojimai vienam vartotojui. Duomenų įrankiai — 60/min; specialistų ir orkestrantų — 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ą.
• Nuomininko izoliacija duomenų bazės lygiu. Kiekviena užklausa yra apribota vartotojo organizacija prieš paliekant programą; serveris negali grąžinti tarpnuomininkinių 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).