Server MCP Insights

Fooodo Insights include un server remote Model Context Protocol per-tenant. Acesta expune analizele operaționale ale organizației tale și un set restrâns de acțiuni de scriere delimitate oricărui client AI care utilizează MCP — fără chei API, integrări personalizate sau copiere-lipire.

Cine îl poate folosi? Orice client Fooodo Insights cu acces admin, analyst sau viewer la un tenant care are activat flag-ul de funcționalitate mcp_enabled. Flag-ul este dezactivat implicit pentru fiecare organizație; contactează support@fooodo.com pentru a solicita activarea și a primi URL-ul MCP al tenant-ului tău.

Două servere MCP, o singură familie de produse. Această pagină acoperă serverul MCP Insights, care expune analize operaționale per-tenant prin OAuth 2.1. Un server MCP separat pentru manualul de marketing rulează la /api/mcp pe fooodo.com și este public — agenții îl folosesc pentru a afla ce este Fooodo și pentru a trimite solicitări de tip lead. Cele două suprafețe sunt deliberat separate: conținut de manual față de date ale clienților.

De ce MCP

MCP este standardul deschis pe care clienții AI îl folosesc pentru a comunica cu date și instrumente la distanță — echivalentul OAuth + REST pentru agenți. Un singur server MCP poate fi adăugat o singură dată și reutilizat de ChatGPT, Claude, Copilot, Gemini, Cursor, Windsurf, Zed și lista în creștere de clienți conformi.

Pentru clienții Fooodo Insights, aceasta înseamnă:

• Fără dependență de furnizor. Analistul tău poate pune aceeași întrebare din ChatGPT astăzi și din Gemini mâine fără a reconfigura nimic.
• Acțiuni delimitate și auditate. Instrumentele de scriere (ex. declanșare import de date, confirmare alertă) necesită scopul insights:write și rolul admin sau analyst. Fiecare scriere este înregistrată în jurnalul de audit cu source: "mcp".
• Izolarea tenant-ului. Instrumentele sunt limitate la organizația utilizatorului la nivelul bazei de date; accesul cross-tenant este imposibil.

Conectează-te din AI-ul tău

Serverul MCP Insights utilizează OAuth 2.1 cu Înregistrare Dinamică a Clientului, astfel încât fiecare client de mai jos folosește același flux cu un singur clic: lipește URL-ul tenant-ului tău, dă clic pe Conectare, autentifică-te cu contul tău Fooodo Insights, aprobă scopurile — gata.

Fragmentele de mai jos folosesc <INSIGHTS_MCP_URL> ca substituent. Înlocuiește-l cu URL-ul pe care suportul Fooodo ți-l trimite după activarea MCP pentru tenant-ul tău.

ChatGPT (Plus / Pro / Enterprise)

1. Deschide Settings → Connectors → Add custom connector (Modul Developer trebuie să fie activat).
2. URL server: <INSIGHTS_MCP_URL>.
3. Aprobă pagina de consimțământ când ți se solicită.

Claude.ai (Pro și superior)

1. Deschide Settings → Connectors → Add custom connector.
2. Nume: Fooodo Insights. URL server: <INSIGHTS_MCP_URL>.
3. Aprobă pagina de consimțământ.

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

Adaugă în fișierul .vscode/mcp.json al spațiului de lucru:

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

Dacă utilizezi Copilot Business/Enterprise, administratorul tău trebuie să activeze mai întâi politica MCP servers in Copilot.

Gemini CLI

Adaugă în configurația Gemini CLI:

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

Gemini Enterprise

În consola Google Cloud, înregistrează serverul ca sursă de date MCP personalizată:

Ce poate face agentul

Serverul expune instrumente în trei niveluri. Clienții ar trebui să aleagă nivelul cel mai de jos care răspunde la întrebare — este mai ieftin, mai rapid și determinist.

Nivelul 1 — Instrumente de date (rapide, deterministe, doar citire)

Nivelul 2 — Agenți specializați (analiză LLM pe un singur domeniu)

Nivelul 3 — Orchestrator (sinteză cross-domeniu)

Căutare și preluare (ChatGPT Deep Research, clienți generici)

Instrumente de scriere (necesită insights:write + rolul admin/analyst)

Prompturi

weekly_business_review, margin_diagnosis — prompturi de tip comandă slash pentru ChatGPT Apps și alți clienți care acceptă prompturi.

Securitate și limite

• OAuth 2.1 + PKCE, clienți publici, token-uri de reîmprospătare rotative. Token-urile de acces sunt JWT-uri HS256 valabile o oră. Token-urile de reîmprospătare sunt valabile 60 de zile, stocate ca hash-uri SHA-256, cu utilizare unică la rotație.
• Activare per-organizație prin flag-ul de funcționalitate mcp_enabled — dezactivat implicit pentru fiecare organizație. Activarea se face printr-un tichet de suport, nu printr-o opțiune self-service, astfel încât clienții pot etapiza implementarea.
• Limite de rată per utilizator, per nivel. Instrumente de date 60/min; specialist și orchestrator 10 la 5 min; instrumente de scriere 5 la 5 min.
• Revocare. Utilizatorii pot revoca orice client în orice moment din setările contului (/account/connected-apps pe partea Insights). Administratorii pot revoca la nivel de organizație.
• Jurnal de audit. Fiecare apel al unui instrument de scriere este înregistrat în jurnalul de audit cu source: "mcp", inclusiv numele clientului, utilizatorul și payload-ul de intrare.
• Izolarea tenant-ului la nivelul bazei de date. Fiecare interogare este limitată la organizația utilizatorului înainte de a părăsi aplicația; serverul nu poate returna date cross-tenant.

Pentru dezvoltatorii de agenți

• URL de descoperire: <INSIGHTS_MCP_URL>/.well-known/oauth-authorization-server (și cu sufixul /mcp, conform RFC 8414 §3.1).
• Metadate resursă protejată: <INSIGHTS_MCP_URL>/.well-known/oauth-protected-resource/mcp (conform RFC 9728).
• Înregistrare Dinamică a Clientului: POST <INSIGHTS_MCP_URL>/register — înregistrare deschisă, dar fiecare autorizare necesită în continuare consimțământ interactiv.
• Scopuri: insights:read (implicit) și insights:write (pentru instrumente de scriere).
• Transport: HTTP streamabil, versiunea protocolului MCP 2025-06-18.

Standarde respectate: MCP 2025-06-18, RFC 6749 (OAuth 2.0), RFC 7636 (PKCE), RFC 7591 (Înregistrare Dinamică a Clientului), RFC 8414 (Metadate Server de Autorizare), RFC 9728 (Metadate Resursă Protejată).