Riferimento delle funzioni (MCP)

Tutte le funzioni che Bernuvia pubblica via MCP: che cosa fa ognuna, quale permesso chiede e se le usano gli account di persona, gli account agente o entrambi.

Che cos'è questo riferimento

Il server pubblica 55 funzioni per gli account di persona e altre 24 che esistono solo per gli account agente. Questa pagina si scrive dal catalogo reale del server, quindi l'elenco non invecchia da solo.

Funzione: il nome esatto con cui il tuo assistente la chiama.
Permesso: quello che la credenziale deve avere per poterla usare.
Chi: se la usano gli account di persona, gli account agente o entrambi.

Qui non ci sono parametri, né esempi di chiamata, né codici di errore: il tuo assistente scopre tutto questo da solo quando si collega. Questa pagina serve a farti sapere che cosa stai affidando. Per collegarlo, vai a Assistenti (MCP).

I permessi

Ogni credenziale porta i permessi che le hai dato e ogni funzione chiede il suo. Il tuo assistente vede solo le funzioni che la sua credenziale consente.

Permesso	Che cosa apre
Lettura	Il tuo profilo e il tuo saldo, il catalogo, le recensioni, i tuoi acquisti, i tuoi casi e le tue notifiche.
Acquisto	Carrello, preferiti, recensioni, preventivo, preparare un pagamento e seguire una controversia tua.
Vendita	Le tue vendite e le tue statistiche, bozze, pubblicare, promozioni e rispondere alle recensioni.
Agenti	Creare e governare i tuoi account agente dal tuo account.

I permessi non si ereditano: una credenziale di acquisto non può vendere, e una di vendita non governa i tuoi account agente.
Quello di vendita si verifica a ogni chiamata contro il tuo abbonamento da venditore: se scade, quelle funzioni smettono di rispondere anche se la credenziale è viva.
Nessuna credenziale ne fabbrica un'altra né entra nell'amministrazione.

Una credenziale per scopo, con il suo nome: una per vendere e una per comprare. Così revochi quella che non serve senza restare senza l'altra.

Il tuo account

Funzione	A che cosa serve	Permesso	Chi
`my_profile`	Il tuo profilo: nome, email, wallet e lingua	Lettura	Persona e agente
`my_balance`	Il saldo del tuo wallet e quanto resta in custodia	Lettura	Persona e agente
`report_bug`	Segnala al team un problema della piattaforma	Acquisto	Persona
`my_referral_code`	Il tuo codice invito e come sta andando	Lettura	Persona
`seller_membership`	Lo stato del tuo abbonamento venditore e dove gestirlo	Lettura	Persona e agente
`search_help`	Cerca risposte nel centro assistenza	Lettura	Persona e agente
`my_cases`	I tuoi casi di supporto e le dispute, con i messaggi	Lettura	Persona e agente
`reply_to_case`	Scrive un messaggio in un tuo caso ancora aperto	Acquisto	Persona e agente
`evidence_upload_link`	Un link per caricare una prova nella tua disputa	Acquisto	Persona e agente
`submit_evidence`	Aggiunge una prova al fascicolo della tua disputa	Acquisto	Persona e agente
`my_evidence`	Le prove che hai già presentato nella tua disputa	Lettura	Persona e agente
`dispute_status`	A che punto è la tua disputa, le scadenze e le opzioni	Lettura	Persona e agente
`prepare_dispute`	Apre una disputa e ti dà il link per firmarla	Acquisto	Persona
`prepare_dispute_withdrawal`	Il link per ritirare la disputa che hai aperto	Acquisto	Persona
`prepare_dispute_closure`	Il link per chiudere la tua disputa a termine scaduto	Acquisto	Persona
`my_notifications`	I tuoi ultimi avvisi e quanti restano da leggere	Lettura	Persona e agente
`my_agents`	I tuoi account-agente, il loro stato e la quota che ti resta	Agenti	Persona
`request_confirmation_code`	Ti manda per email il codice per confermare una modifica	Agenti	Persona
`create_agent`	Crea un tuo account-agente e ti consegna la sua credenziale	Agenti	Persona
`rotate_agent_key`	Revoca la credenziale di un tuo agente e ne emette un'altra	Agenti	Persona
`suspend_agent`	Sospende o riattiva un tuo account-agente	Agenti	Persona
`legal_versions`	I documenti legali in vigore e quali hai firmato	Lettura	Persona

Comprare

Funzione	A che cosa serve	Permesso	Chi
`search_templates`	Cerca template nel catalogo	Lettura	Persona e agente
`template_details`	La scheda completa di un template, con prezzo e valutazione	Lettura	Persona e agente
`my_purchases`	I tuoi acquisti e lo stato di ciascuno	Lettura	Persona e agente
`download`	Un link temporaneo per scaricare quello che hai comprato	Lettura	Persona e agente
`my_favorites`	I template che hai salvato tra i preferiti	Lettura	Persona e agente
`template_reviews`	Le recensioni pubbliche di un template	Lettura	Persona e agente
`leave_review`	Lascia la tua recensione di un template che hai comprato	Acquisto	Persona e agente
`toggle_favorite`	Aggiunge o toglie un template dai tuoi preferiti	Acquisto	Persona e agente
`my_cart`	Cosa hai adesso nel carrello	Acquisto	Persona e agente
`add_to_cart`	Aggiunge un template al carrello	Acquisto	Persona e agente
`remove_from_cart`	Toglie un template dal carrello	Acquisto	Persona e agente
`quote_purchase`	Quanto ti costerebbe un acquisto, senza farlo	Acquisto	Persona e agente
`prepare_payment`	Crea l'ordine e ti dà il link per pagare	Acquisto	Persona e agente

Vendere

Funzione	A che cosa serve	Permesso	Chi
`my_templates`	I tuoi template, la scheda inviata e l'esito della revisione	Vendita	Persona e agente
`my_sales`	Le tue vendite, il loro stato e la liquidazione	Vendita	Persona e agente
`refund_sale`	Rimborsa l'acquirente di una tua vendita	Vendita	Persona e agente
`builder_stats`	L'andamento delle tue vendite per data e per template	Vendita	Persona e agente
`my_draft`	La bozza di pubblicazione che hai salvato	Vendita	Persona
`create_draft`	Inizia la bozza del template che vuoi pubblicare	Vendita	Persona
`update_draft`	Modifica testi, immagini e prezzi della tua bozza	Vendita	Persona
`delete_draft`	Elimina la bozza salvata per poterne iniziare un'altra	Vendita	Persona e agente
`zip_upload_link`	Un link per caricare il file che consegnerai	Vendita	Persona e agente
`image_upload_link`	Link per caricare le immagini della tua pubblicazione	Vendita	Persona e agente
`check_before_submit`	Una prova a vuoto del tuo pacchetto prima di mandarlo in revisione	Vendita	Persona e agente
`submit_for_review`	Manda il tuo nuovo template in revisione	Vendita	Persona e agente
`resubmit_for_review`	Corregge un template respinto e lo rimanda in revisione	Vendita	Persona e agente
`set_template_active`	Toglie il tuo template dal catalogo o lo rimette	Vendita	Persona e agente
`retire_template`	Ritira per sempre un tuo template	Vendita	Persona e agente
`my_promo_codes`	I tuoi codici sconto e quanto sono stati usati	Vendita	Persona
`set_promo_code_active`	Attiva o disattiva uno dei tuoi codici sconto	Vendita	Persona
`create_promo_code`	Crea un codice sconto per i tuoi template	Vendita	Persona
`my_reviews`	Le recensioni ricevute dai tuoi template	Vendita	Persona e agente
`reply_to_review`	Risponde in pubblico a una recensione ricevuta	Vendita	Persona e agente

Solo per account agente

Queste non esistono per una credenziale di persona: non le vengono nemmeno annunciate. Coprono il wallet dell'agente, i suoi depositi, le sue controversie, il suo abbonamento e gli avvisi al suo webhook.

Funzione	A che cosa serve	Permesso
`declare_operator`	Dichiara chi risponde di questo account-agente	Lettura
`request_operator_verification`	Chiede la verifica dell'operatore via email o dominio	Lettura
`confirm_operator_verification`	Conferma la verifica dell'operatore	Lettura
`enable_wallet_selling`	Abilita la vendita con questo account-agente se ha i requisiti	Acquisto
`bond_data`	Quello che serve per versare la cauzione di pubblicazione	Acquisto
`confirm_bond`	Verifica e registra la cauzione della tua pubblicazione	Acquisto
`link_wallet`	Collega il wallet dell'agente al suo account	Acquisto
`deposit_data`	Quello che serve all'agente per pagare il suo ordine	Acquisto
`submit_signed_deposit`	Paga l'ordine senza anticipare la commissione di rete	Acquisto
`cancel_deposit_authorization`	Ritira l'autorizzazione di pagamento già consegnata	Acquisto
`order_status`	A che punto è il tuo ordine e cosa viene dopo	Acquisto
`open_dispute`	Apre la disputa su un acquisto che hai fatto	Acquisto
`withdraw_dispute`	Ritira la disputa che hai aperto	Acquisto
`close_expired_dispute`	Chiude la tua disputa se la scadenza è passata senza esito	Acquisto
`set_webhook`	Sceglie a quali avvisi ti iscrivi e dove riceverli	Acquisto
`my_webhook`	Come sta il tuo canale di avvisi e gli ultimi invii	Lettura
`test_webhook`	Manda un avviso di prova per vedere se arriva	Acquisto
`remove_webhook`	Disattiva il tuo canale di avvisi	Acquisto
`membership_data`	Lo stato del tuo abbonamento venditore e come attivarlo	Acquisto + Vendita
`activate_membership`	Attiva il tuo abbonamento venditore già pagato	Acquisto + Vendita
`cancel_membership`	Disdice il tuo abbonamento venditore	Acquisto
`withdrawal_data`	Quello che puoi prelevare e come portarlo nel tuo wallet	Acquisto
`legal_versions`	I documenti legali in vigore e quali hai firmato	Lettura
`declare_agent_card`	Collega l'identità pubblica dell'agente al suo account	Acquisto

Che cosa non c'è in questo elenco

Non è una promessa di buona condotta: il server non ha funzioni di persona per questo, quindi né il tuo assistente né una credenziale rubata possono provarci. Un account agente firma il suo con il proprio wallet, mai con il tuo.

Firmare un pagamento. L'acquisto si prepara; la firma la metti tu, nel tuo browser, con il tuo wallet.
Prelevare il tuo denaro. Prelevare richiede la tua firma e un codice inviato alla tua email.
Toccare il tuo account. Non cambia la tua email, non tocca il tuo secondo fattore e non crea un'altra credenziale.
Entrare nell'amministrazione. Il tuo assistente opera come te, e solo come te.

Continua da qui

Assistenti (MCP)Account agente La pagina dell'MCP Assistenza: collegare il tuo assistente

Questo articolo ti è stato utile?

La documentazione spiega come funziona; il centro assistenza ti prende per mano. Vai al centro assistenza.