Superficie API e di integrazione
Come partner e sviluppatori si integrano con Fooodo — il server MCP pubblico, il connettore POS e i contratti white-label, cosa è aperto e cosa è chiuso oggi, e la roadmap di integrazione.
La superficie di integrazione pubblica di Fooodo è ridotta e mirata. Questa pagina documenta cosa è aperto oggi, cosa è chiuso e cosa è nella roadmap.
Cosa è aperto oggi
Server MCP
Fooodo esegue un server Model Context Protocol (MCP) su /api/mcp per consentire agli agenti AI di interrogare il manuale e di eseguire un numero limitato di azioni circoscritte per conto di un acquirente. Gli agenti leggono il manuale senza fare scraping dell'HTML e inviano richieste strutturate senza compilare moduli HTML — così gli assistenti di supporto ai partner, i copilot per la definizione dell'ambito di integrazione e gli agenti di procurement lato acquirente rimangono ancorati a dati canonici e raggiungono la casella di posta corretta.
# Connect from Claude Desktop, Cursor, or any MCP-compatible client:
mcp connect https://fooodo.com/api/mcpStrumenti di lettura (senza effetti collaterali):
| Strumento | Restituisce |
|---|---|
list_docs | Ogni pagina del manuale con slug, titolo e descrizione in una riga. |
get_doc({ slug }) | Il contenuto MDX elaborato di una singola pagina. |
search_docs({ query }) | Ricerca per sottostringa su titoli, descrizioni e contenuti, con uno snippet attorno a ogni corrispondenza. |
list_pos_connectors | Connettori POS attivi e la policy di definizione dell'ambito per cliente per gli altri. |
get_pricing_scope({ locations?, region? }) | Modello di ingaggio (abbonamento per sede, EUR), indicatori di segmento (Insights incluso da 5+ sedi, Enterprise da 150+) e un verdetto di idoneità per gli input dell'acquirente. Non restituisce un prezzo — la piattaforma viene quotata per cliente; questo strumento restituisce la forma dell'ingaggio affinché l'agente dell'acquirente possa qualificarsi prima di richiedere un preventivo. |
Strumento di azione (invia un'email al team Fooodo):
| Strumento | Funzione |
|---|---|
request_walkthrough({ name, email, variant?, company?, role?, locations?, message?, locale?, agent_origin? }) | Invia un'email di lead alle operations per conto dell'acquirente che l'agente rappresenta. Le risposte arrivano a email entro due giorni lavorativi. variant ha come valore predefinito demo; passare pricing per un preventivo, partner per interesse come rivenditore, developer per la definizione dell'ambito di integrazione API/MCP. agent_origin viene mostrato nell'email affinché le operations possano smistare i lead generati da agenti separatamente dalle submission dei moduli. |
Lo strumento di azione è soggetto a rate limiting per email dell'acquirente (3 all'ora) e l'intera superficie MCP è soggetta a rate limiting per IP (60 chiamate al minuto). Le email di lead vengono instradate a info@fooodo.com per impostazione predefinita.
Server MCP di Insights (per tenant)
Un server MCP separato viene fornito con ogni tenant Fooodo Insights. Mentre il server MCP del manuale descritto sopra espone i contenuti pubblici di Fooodo e l'azione di acquisizione lead, il server MCP di Insights espone le analisi operative del tenant stesso — riepiloghi per periodo, performance per canale e prodotto, dati P&L, tre agenti AI specializzati, l'orchestratore cross-domain e un insieme circoscritto di azioni di scrittura come avvia importazione dati e risolvi alert.
Il server utilizza OAuth 2.1 con Dynamic Client Registration su Streamable HTTP, quindi qualsiasi client compatibile con MCP si connette con lo stesso flusso in un clic. La funzionalità è disattivata per impostazione predefinita per ogni organizzazione; l'abilitazione e il provisioning dell'URL del tenant vengono gestiti tramite support@fooodo.com. Inventario completo degli strumenti, configurazione per client e dettagli di sicurezza: Server MCP di Insights.
Indice del sito ottimizzato per LLM
/llms.txt fornisce un indice piatto e strutturato di ogni pagina pubblica del sito marketing e del manuale. /llms-full.txt è lo stesso manuale concatenato come singolo documento Markdown per l'ingestione in un'unica soluzione. Entrambi sono i punti di accesso canonici se si vuole puntare un LLM su Fooodo.
Sitemap e Open Graph
Superfici standard — /sitemap.xml copre tutti i 7 locale marketing × le route pubbliche. Le immagini Open Graph e Twitter Card vengono generate per locale.
Cosa è chiuso oggi
L'API degli ordini dell'app menu e l'API dei pagamenti del servizio di pagamento non sono pubbliche. Operano su infrastruttura gestita per i nostri partner di deployment, protetta con credenziali per partner rilasciate durante l'onboarding.
Se sei un fornitore POS che desidera integrarsi con Fooodo, scrivi a hello@fooodo.com — il percorso di integrazione è oggi gestito manualmente, non in modalità self-serve.
Con cosa si integrano effettivamente i partner
Le forme di integrazione esistenti oggi, in ordine di utilizzo da parte dei partner:
Connettore POS (back-end)
L'integrazione più richiesta. Un nuovo connettore POS implementa lo stesso contratto in entrata e in uscita utilizzato da R-Keeper (vedi Integrazione R-Keeper). Il connettore è un pacchetto Laravel aggiunto all'app menu — non è un processo separato.
Superficie richiesta:
- Pull menu (prodotti, categorie, modificatori, prezzi, flag fiscali)
- Push ordine (crea, aggiorna, blocca, segna come pagato)
- Stato (ristorante online/offline, stato tavolo)
R-Keeper è l'unico connettore attivo in produzione oggi. Il contratto del connettore stesso è agnostico rispetto al POS — connettori POS aggiuntivi vengono definiti per cliente e quotati su richiesta. Se sei un fornitore POS interessato a collaborare su un connettore, contattaci tramite partners@fooodo.com.
Deployment white-label (front-end)
Alcuni rivenditori gestiscono un deployment Fooodo con il proprio brand. L'app rivolta ai clienti supporta la configurazione del brand a livello aziendale: logo, token colore, dominio, branding dei pagamenti. Si tratta di una superficie di configurazione, non di un'API.
Widget incorporati (leggeri)
Il widget AI Ask presente su questo sito può essere incorporato nei siti dei partner con un singolo tag script. Altri widget (anteprima menu, disponibilità tavoli) non sono ancora stati rilasciati ma sono nella roadmap.
Autenticazione e segreti
Quando i partner ottengono l'accesso API (pacchetti connettore POS, deployment white-label), l'autenticazione avviene tramite bearer token. I segreti vengono rilasciati per ambiente; staging e produzione utilizzano token separati. Non esiste un flusso OAuth oggi — i destinatari che utilizzano l'API sono troppo pochi per giustificarlo.
Webhook (in entrata, per i partner) — pianificati
Per i deployment dei partner, i webhook in uscita per gli eventi degli ordini sono nella roadmap di integrazione. L'insieme di eventi pianificato:
order.createdorder.paidorder.cancelledorder.errored
Gli eventi interni che alimentano questi esistono già lato app menu; il dispatcher in uscita viene configurato per partner durante l'onboarding anziché essere eseguito come servizio predefinito. Se hai bisogno del push degli eventi come parte della tua integrazione, segnalalo durante la definizione dell'ambito — lo aggiungiamo al tuo deployment come modulo opt-in.
Versionamento
Le API interne sono prive di versione — l'app menu e il servizio di pagamento vengono distribuiti insieme per Čili Pizza. Una volta che i partner esterni utilizzeranno l'API, introdurremo tag di versione. Non siamo ancora arrivati a quel punto.
Rate limit
Le API pubbliche del sito marketing (/api/ask, /api/mcp) sono soggette a rate limiting per IP. I limiti non sono attualmente pubblicati; sono dimensionati per un utilizzo normale da parte dei partner e verranno allentati per i partner con un accordo attivo.
Roadmap
In ordine approssimativo di priorità:
- Un secondo connettore POS — definito per cliente quando una catena si impegna in tal senso.
- Un SDK JS tipizzato per il flusso di embedding white-label.
- Un'API pubblica in sola lettura per le query sul menu (così i siti dei partner possono mostrare "il menu di oggi" senza fare scraping).
Se hai bisogno di uno di questi prima, scrivi a hello@fooodo.com — la richiesta dei partner tende ad accelerarne la realizzazione.
Sconti, coupon e fidelizzazione
Il manuale operativo per aumentare il traffico e alzare lo scontrino medio con Fooodo — sconti a finestra temporale, codici coupon, fidelizzazione tramite POS, cross-sell al checkout, mance e donazioni.
Fooodo Insights
Il livello di intelligenza decisionale AI per catene di ristoranti da 5 a 200 sedi — che collega ogni raccomandazione all'EBIT, mantiene gli esseri umani nel processo decisionale e illustra l'architettura a sei livelli che lo sostiene.