Herramientas

El servidor MCP de Memberfy tiene 188 herramientas, que cubren todos los módulos de la comunidad: el asistente hace lo que la app deja hacer a la persona conectada, con su rol. El asistente elige solo cuál usar a partir de tu petición; esta página y las de cada tema sirven para que sepas lo que puede hacer, con qué rol y cómo pedirlo. Los nombres están en inglés, tal y como los ve el asistente, y son los mismos en cualquier idioma; el título que aparece en Claude o en ChatGPT viene en el idioma de quien conectó.

#Por tema

Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen.

#Todas las herramientas

Rol mínimo: el menor rol con el que aparece la herramienta. "Cualquiera" incluye al miembro. Finanzas aparece aparte porque no entra en la escalera de los demás roles.

#Cuántas ve cada rol

Las 40 de la convocatoria de ponencias aparecen para todos porque el responsable de una convocatoria puede ser un miembro cualquiera, y cualquier miembro propone, evalúa o vota cuando la convocatoria lo permite. Memberfy comprueba cada convocatoria con la regla del módulo. Consulta Convocatoria de ponencias.

Una conexión autorizada solo para lectura ve únicamente las herramientas de lectura del rol.

Ver una herramienta en la lista no garantiza que todas las llamadas pasen: Memberfy comprueba cada acción como si se hiciera en la pantalla. Un miembro ve create_post, pero publicar en un espacio con Quién puede publicar = Equipo se rechaza. Consulta Roles y permisos.

#Reglas comunes

#Los ids

Las herramientas hablan por ids, y donde piden un id aceptan también el enlace copiado de la app (consulta open_link). Casi todas las conversaciones empiezan por get_community_context, que devuelve las secciones y los espacios con sus ids; los listados devuelven los ids de lo que listan. La descripción de cada herramienta dice de dónde viene cada id, y el asistente los encadena solo: tú pides "publica en el espacio Avisos", él busca el id del espacio Avisos y publica.

#Paginación

Los listados aceptan page (la página, empezando por 1) y limit (cuántos por página). La respuesta trae los elementos y el total, para que el asistente sepa si tiene que pedir la página siguiente.

#Primero, borrador

Todo lo que se vende nace en borrador: create_product, el producto de create_course, la entrada de create_event y las opciones de create_plan. Nada sale a la venta sin publish_product (o publish: true en la compuesta). Así lo revisas antes.

Crear no depende de que la información empresarial esté aprobada; publicar, sí. En una comunidad sin aprobación, la compuesta que pidió publicar no deshace nada: el curso, el evento o el plan queda en borrador, la respuesta trae el motivo en publish_blocked, y el siguiente paso sugerido es completar la información empresarial y publicar después. Consulta Borrador antes de la aprobación.

#Idempotencia en las compuestas

Las tres compuestas aceptan idempotency_key (hasta 100 caracteres). Repetir la llamada con la misma clave devuelve el resultado de la primera, sin crear nada de nuevo. Sirve para cuando la conexión se corta a mitad y el asistente no sabe si la llamada llegó.

#Deshacer cuando un paso falla

Las compuestas crean en orden y, si un paso falla, borran lo que ya habían creado (salvo cuando lo que falló fue publicar sin la información empresarial aprobada: entonces todo queda en borrador), del más nuevo al más antiguo, y dicen qué paso falló: "El paso "módulo 2" falló y se deshizo todo lo que esta llamada creó." Si algo no se puede deshacer, la respuesta enumera lo que ha quedado para que lo revises en el panel.

#Próximos pasos

Cuando tiene sentido continuar, la respuesta de la herramienta trae next_steps: hasta tres acciones sugeridas, cada una con la herramienta, el motivo (en el idioma de quien conectó) y, a veces, los argumentos ya listos. Dependen de lo que se devolvió y de tu rol: solo entran herramientas que puedes usar. El asistente ofrece estas acciones antes de sugerir cualquier otra cosa, y ninguna ocurre sin que la pidas.

#Errores

Cuando Memberfy rechaza algo, el asistente recibe su mensaje, el mismo de la pantalla:

#Versión del servidor y de la lista

Cada despliegue de Memberfy cambia la versión del servidor, y la lista de herramientas que recibe una conexión tiene su propia huella. Así se sabe si un asistente tiene la lista al día.

Llamar a una herramienta que no está en la lista de la conexión devuelve un error de herramienta (isError) que pide a la persona abrir una conversación nueva o volver a conectar; si el nombre es uno de los antiguos en portugués, la respuesta incluye renamed_to con el nombre nuevo. La llamada queda en la auditoría como tool.unknown.

El propietario y los administradores comparan la última lista que recibió una conexión con la actual en GET /api/oauth/connections/{id}/diagnostics: el campo listUpToDate dice si está al día. Consulta Auditoría.

#Piden confirmación

Solo piden confirmación las herramientas que tocan el dinero y las que borran (las que empiezan por delete_, remove_, revoke_, withdraw_ o cancel_). Con el sello Pide confirmación, no actúan en la primera llamada: devuelven un resumen y un código, y solo actúan cuando el asistente repite la llamada con el código, después de tu sí. Todas las demás, incluidas las invitaciones, el cambio de rol, la configuración y la emisión de certificados, se ejecutan en la primera llamada. La tabla de arriba muestra el sello de cada una. Consulta Dinero y confirmación.

#Texto en Markdown

El asistente escribe y lee el texto de Memberfy en Markdown. Memberfy lo convierte al texto con formato de la app a la ida, y de vuelta a Markdown a la vuelta: la publicación aparece en la app con negrita y listas, y no con asteriscos.

Lo que no pasa a la app:

• Una imagen dentro del texto se convierte en un enlace a la imagen. Para la portada de una publicación o el banner de un evento, usa image_url (consulta Imágenes).
• Una tabla se convierte en líneas de texto, una por fila.
• Los scripts, los atributos de evento y los enlaces javascript: se eliminan.

También se acepta HTML ya hecho, que pasa por el mismo filtro. En la lectura, las herramientas devuelven el texto con formato en Markdown y marcan el resultado con text_format: "markdown". Leer y volver a guardar el mismo texto no cambia nada.

#Imágenes

create_post, add_gallery_image, create_course, create_event, update_post, update_event y update_course aceptan la imagen de dos maneras:

• image_url: el enlace de una imagen que está en internet. Memberfy la descarga y la guarda como si la hubieras subido desde el panel.
• image_base64 (con image_type, opcional): el archivo en sí, hasta 5 MB. Es el camino para una imagen que el propio asistente ha generado en la conversación. Se acepta SVG, que se convierte en PNG; un SVG que apunta a archivos externos se rechaza.

Un enlace de una página (y no de la imagen en sí) se rechaza con "el archivo no es una imagen JPEG, PNG, WebP o GIF".

En las compuestas, una imagen que no sirve no deshace el resto: el curso o el evento se crea sin la portada, y la respuesta trae el motivo en warnings ("No se pudo usar la imagen de …: la imagen supera los 10 MB."). Vuelve a pedirlo con otro enlace, o pon la imagen desde el panel. En las herramientas de una sola cosa (create_post, add_gallery_image), la imagen que no sirve impide la creación.

#Relacionados

• Recetas
• Dinero y confirmación
• Seguridad y límites