Il server MCP di Foodzilla
Foodzilla parla il Model Context Protocol, quindi un assistente IA può lavorare nell'account di un professionista o nel diario di un cliente attraverso un'interfaccia standard invece che raschiando pagine. È un endpoint HTTPS, OAuth 2.1 con PKCE e più di 60 strumenti.
https://api.foodzilla.io/mcpCerchi cosa fa più che come funziona? Vedi la panoramica di Autopilot
Cos'è il Model Context Protocol
MCP è uno standard aperto per collegare gli assistenti IA ai sistemi che contengono i dati veri. L'assistente chiede al server quali strumenti ha, il server risponde con nomi e argomenti tipizzati, e l'assistente li chiama. Sostituisce lo schema in cui un assistente tira a indovinare dentro una pagina web o un endpoint non documentato.
Per uno studio di nutrizione conta più che altrove. Un pasto descritto da un cliente deve entrare nel suo diario con i valori di un database alimentare vero, non con un numero inventato dal modello, e deve entrare nella sua scheda e in nessun'altra. Strumenti tipizzati e scope per account sono ciò che lo garantisce.
Riferimento di connessione
Tutto quello che serve per puntare un client MCP su Foodzilla.
- Endpoint
- https://api.foodzilla.io/mcp
- Trasporto
- HTTP in streaming, JSON-RPC 2.0 via POST
- Autorizzazione
- Authorization code OAuth 2.1 con PKCE, registrazione dinamica dei client
- Discovery
- /.well-known/oauth-protected-resource/mcp
- Scope
- autopilot, coach, openid, offline_access
- Piano
- Professional o superiore per i professionisti
autopilotUn cliente seguito. Il suo piano e il suo diario, nient'altro.
coachUn professionista che lavora sul proprio account. Ricette, modelli, moduli, prenotazioni, contenuti, negozio, impostazioni e abbonamento. Nessun accesso a schede cliente.
Un token porta uno dei due, mai entrambi. Quale si decide nella pagina di consenso, e a chi è professionista e ha anche una scheda cliente viene chiesto con quale si sta collegando.
Cosa riceve una richiesta non autenticata
Un 401 con un header WWW-Authenticate che indica l'URL dei metadati della risorsa, che è il modo in cui un client MCP fatto bene trova da solo il server di autorizzazione.
Gli strumenti
61 al momento. I nomi sono stabili. Tutto ciò che sovrascrive o spende soldi è marcato distruttivo, così il tuo assistente chiede prima di eseguirlo.
Scope cliente
16 strumentiRegistrazione
log_food, log_planned_meal, log_water, log_exercise, log_sleep, log_weight, delete_food_log
Il loro piano
get_plan, get_todays_meals, get_recipe
Guardare indietro
get_day, get_progress, get_recent_foods, get_profile, get_status
Account
sign_out_everywhere
log_food accetta o un elenco di alimenti, abbinati ai database Foodzilla con valori reali per ingrediente, o semplici numeri per qualcosa che nessun database contiene. Una riga che il database non conosce fa fallire l'intera chiamata e la nomina, invece di registrare una stima.
Scope professionista
46 strumentiRicette
generate_recipe, import_recipe_from_url, update_recipe_draft, discard_recipe_draft, save_recipe, list_my_recipes
Modelli di piano
generate_plan_template, list_my_templates, describe_plan_settings
Raccolte e alimenti
create_collection, add_recipes_to_collection, list_collections, add_food, add_foods, import_food_from_url, import_food_from_text
Moduli e prenotazioni
create_form, update_form, list_forms, get_booking_setup, set_availability, create_appointment_type, update_appointment_type
Contenuti
create_post, update_post, publish_post, pin_post, list_posts
Negozio
get_store, update_store, create_store_plan, update_store_plan, publish_store, unpublish_store
Impostazioni
get_app_experience, set_app_experience, update_my_profile, get_invoice_settings, update_invoice_settings
Account e fatturazione
get_my_account, get_subscription, preview_plan_change, change_plan, activate_subscription, extend_trial
Chi sta sotto Professional si collega con cinque di questi: quelli di account e abbonamento, così l'assistente può quotare un passaggio di piano e applicarlo. Il resto compare appena il piano sale, sulla stessa connessione.
Collegare un assistente
Niente da installare e nessuna chiave da generare. Al resto pensa il flusso OAuth.
Claude
- 1Impostazioni, poi Connettori, poi Aggiungi connettore personalizzato.
- 2Incolla https://api.foodzilla.io/mcp come URL.
- 3Accedi con l'email e la password di Foodzilla quando si apre la pagina.
- 4Controlla l'account indicato nella pagina di consenso, poi premi Connetti.
ChatGPT
- 1Impostazioni, poi Connettori, poi Avanzate, e attiva la modalità sviluppatore. Foodzilla non è ancora nella directory dei connettori.
- 2Aggiungi un connettore con https://api.foodzilla.io/mcp come URL.
- 3Accedi con l'email e la password di Foodzilla.
- 4Controlla l'account indicato nella pagina di consenso, poi premi Connetti.
- 5Apri una chat con il connettore attivo.
Qualsiasi altra cosa parli MCP
Puntala sull'endpoint. Si registra da sola con la registrazione dinamica dei client, trova il server di autorizzazione dai metadati della risorsa protetta ed esegue il flusso authorization code con PKCE. Chiedi offline_access se vuoi che la connessione duri più del token di accesso.
Limiti e consumo
Contato a settimana
Ogni piano ha un limite settimanale che si azzera il lunedì. Letture, scritture e chiamate che consumano tempo di modello sono contate separatamente, così una settimana di molte letture non si mangia il budget per generare ricette.
I clienti condividono un fondo
I tuoi clienti attingono a un unico limite comune invece che a uno ciascuno. Così un solo cliente chiacchierone non può spendere la settimana dello studio.
Cresce col piano
White Label porta quattro volte il limite di Professional. Team ne porta sette volte, per professionista.
Visibile in percentuale
La scheda Autopilot in Foodzilla mostra quanto se n'è andato della settimana. Al limite lo strumento risponde dicendolo, invece di fallire in silenzio.
Cosa rifiuta il server
- Un token professionista che chiede la scheda di un cliente. Non c'è nessuno strumento che accetti un id cliente, quindi non c'è niente da puntare.
- Un token cliente che vada oltre il suo diario e il suo piano. Una ricetta è leggibile solo se è nel piano di quel cliente, il che impedisce di percorrere la libreria chiamata dopo chiamata.
- Un token di una connessione che il professionista ha poi disconnesso, anche se è ancora dentro la sua durata.
- Un token di una concessione precedente dopo una riconnessione, così disconnettere e ricollegare non riporta in vita una vecchia chiave di nascosto.
- Qualsiasi cosa su un account il cui piano non comprende più Autopilot. L'idoneità è controllata a ogni chiamata, non solo al consenso.
- Un cliente il cui professionista ha spento l'accesso dei clienti.
I dati personali restano fuori dai log del server. Nessun nome di cliente o professionista, nessuna email, nessun numero di telefono.
Funzionalità Correlate
Esplora altri strumenti pensati per i professionisti della nutrizione
API per Sviluppatori
Collega il tuo sito o il tuo CRM a Foodzilla e iscrivi i membri automaticamente.
Scopri di piùDatabase Nutrizionali
Accesso a USDA, CoFID, FSANZ e altri database alimentari.
Scopri di piùPersonalizzazione App
Attiva o disattiva funzionalità per ogni cliente.
Scopri di piùPortale Clienti
Un accesso web sicuro dove i clienti compilano moduli, leggono le note condivise e monitorano i progressi.
Scopri di piùEsportazione Dati
Esporta dati in CSV o genera report PDF professionali.
Scopri di piùDiario Alimentare
Tracciamento IA con riconoscimento fotografico e analisi nutrienti.
Scopri di più