Strumenti

Il server MCP di Memberfy ha 188 strumenti, che coprono tutti i moduli della community: l'assistente fa ciò che l'app permette alla persona collegata, con il suo ruolo. L'assistente sceglie da solo quale usare in base alla tua richiesta; questa pagina e quelle di ogni tema servono a farti sapere cosa riesce a fare, con quale ruolo, e come chiederlo. I nomi sono in inglese, come li vede l'assistente, e sono gli stessi in ogni lingua; il titolo che compare in Claude o in ChatGPT è nella lingua di chi ha collegato.

#Per tema

Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo.

#Tutti gli strumenti

Ruolo minimo: il ruolo più basso con cui lo strumento compare. "Qualsiasi" include il membro. Finanza è indicato a parte perché non rientra nella scala degli altri ruoli.

#Quanti strumenti vede ogni ruolo

I 40 della call for papers compaiono a tutti perché il responsabile di una call può essere un membro qualsiasi, e qualsiasi membro propone, valuta o vota quando la call lo consente. Memberfy controlla ogni call con la regola del modulo. Vedi Call for papers.

Un collegamento autorizzato solo in lettura vede solo gli strumenti di lettura del ruolo.

Vedere uno strumento nell'elenco non garantisce che ogni chiamata passi: Memberfy controlla ogni azione come se fosse fatta dalla schermata. Un membro vede create_post, ma pubblicare in uno spazio con Chi può pubblicare = Staff viene rifiutato. Vedi Ruoli e permessi.

#Regole comuni

#Gli id

Gli strumenti parlano tramite id, e dove chiedono un id accettano anche il link copiato dall'app (vedi open_link). Quasi tutte le conversazioni iniziano con get_community_context, che restituisce le sezioni e gli spazi con gli id; gli elenchi restituiscono gli id di ciò che elencano. La descrizione di ogni strumento dice da dove viene ogni id, e l'assistente li concatena da solo: tu chiedi "pubblica nello spazio Avvisi", lui cerca l'id dello spazio Avvisi e pubblica.

#Paginazione

Gli elenchi accettano page (la pagina, a partire da 1) e limit (quanti per pagina). La risposta riporta gli elementi e il totale, così l'assistente sa se deve chiedere la pagina successiva.

#Prima la bozza

Tutto ciò che si vende nasce in bozza: create_product, il prodotto di create_course, il biglietto di create_event e le opzioni di create_plan. Niente va in vendita senza publish_product (o publish: true nel composto). Così puoi rivedere prima.

La creazione non dipende dalle informazioni aziendali approvate; la pubblicazione sì. In una community senza approvazione, il composto che ha chiesto di pubblicare non annulla nulla: il corso, l'evento o il piano resta in bozza, la risposta riporta il motivo in publish_blocked, e il passo successivo suggerito è compilare le informazioni aziendali e pubblicare dopo. Vedi Bozza prima dell'approvazione.

#Idempotenza nei composti

I tre composti accettano idempotency_key (fino a 100 caratteri). Ripetere la chiamata con la stessa chiave restituisce il risultato della prima, senza creare di nuovo. Serve quando il collegamento cade a metà e l'assistente non sa se la chiamata è andata a buon fine.

#Annullare quando un passaggio fallisce

I composti creano in ordine e, se un passaggio fallisce, eliminano ciò che avevano già creato (tranne quando ciò che è fallito è la pubblicazione senza informazioni aziendali approvate: allora resta tutto in bozza), dal più recente al più vecchio, e dicono quale passaggio è fallito: "Il passaggio "módulo 2" è fallito e tutto ciò che questa chiamata aveva creato è stato annullato." Se qualcosa non può essere annullato, la risposta elenca ciò che è rimasto, da controllare nel pannello.

#Prossimi passi

Quando ha senso continuare, la risposta dello strumento porta next_steps: fino a tre azioni suggerite, ognuna con lo strumento, il motivo (nella lingua di chi ha collegato) e, a volte, gli argomenti già pronti. Dipendono da cosa è tornato e dal tuo ruolo: entrano solo strumenti che puoi usare. L'assistente propone queste azioni prima di suggerire qualsiasi altra cosa, e nessuna avviene senza che tu la chieda.

#Errori

Quando Memberfy rifiuta, l'assistente riceve il suo messaggio, lo stesso della schermata:

#Versione del server e dell'elenco

Ogni deploy di Memberfy cambia la versione del server, e l'elenco di strumenti che riceve una connessione ha una propria impronta. È così che si capisce se un assistente ha l'elenco aggiornato.

Chiamare uno strumento che non è nell'elenco della connessione restituisce un errore di strumento (isError) che chiede alla persona di aprire una nuova conversazione o di ricollegarsi; se il nome è uno di quelli vecchi in portoghese, la risposta include renamed_to con il nome nuovo. La chiamata resta nell'audit come tool.unknown.

Il proprietario e gli amministratori confrontano l'ultimo elenco ricevuto da una connessione con quello attuale in GET /api/oauth/connections/{id}/diagnostics: il campo listUpToDate dice se è aggiornato. Vedi Audit.

#Chiedono conferma

Chiedono conferma solo gli strumenti che toccano il denaro e quelli che eliminano (quelli che iniziano con delete_, remove_, revoke_, withdraw_ o cancel_). Con l'etichetta Chiede conferma, non agiscono alla prima chiamata: restituiscono un riepilogo e un codice, e agiscono solo quando l'assistente ripete la chiamata con il codice, dopo il tuo sì. Tutti gli altri, compresi inviti, cambio di ruolo, impostazioni e rilascio di certificati, vengono eseguiti alla prima chiamata. La tabella qui sopra mostra l'etichetta di ciascuno. Vedi Denaro e conferma.

#Testo in Markdown

L'assistente scrive e legge il testo di Memberfy in Markdown. Memberfy lo converte nel testo formattato dell'app all'andata, e di nuovo in Markdown al ritorno: il post compare nell'app con grassetto ed elenchi, non con asterischi.

Cosa non passa all'app:

• Un'immagine dentro il testo diventa un link all'immagine. Per la copertina di un post o il banner di un evento, usa image_url (vedi Immagini).
• Una tabella diventa righe di testo, una per riga della tabella.
• Script, attributi di evento e link javascript: vengono rimossi.

Anche l'HTML già pronto è accettato e passa dallo stesso filtro. In lettura, gli strumenti restituiscono il testo formattato in Markdown e segnano il risultato con text_format: "markdown". Leggere e salvare di nuovo lo stesso testo non cambia nulla.

#Immagini

create_post, add_gallery_image, create_course, create_event, update_post, update_event e update_course accettano l'immagine in due modi:

• image_url: il link di un'immagine che si trova su internet. Memberfy la scarica e la conserva come se l'avessi caricata dal pannello.
• image_base64 (con image_type, facoltativo): il file stesso, fino a 5 MB. È la strada per un'immagine generata dall'assistente stesso nella conversazione. L'SVG è accettato e diventa PNG; un SVG che punta a file esterni viene rifiutato.

Un link a una pagina (e non all'immagine stessa) viene rifiutato con "il file non è un'immagine JPEG, PNG, WebP o GIF".

Nei composti, un'immagine non valida non annulla il resto: il corso o l'evento viene creato senza la copertina, e la risposta riporta il motivo in warnings ("Non è stato possibile usare l'immagine di …: l'immagine supera i 10 MB."). Chiedi di nuovo con un altro link, oppure metti l'immagine dal pannello. Negli strumenti che fanno una cosa sola (create_post, add_gallery_image), l'immagine non valida impedisce la creazione.

#Correlati

• Ricette
• Denaro e conferma
• Sicurezza e limiti