# Visión general del MCP

> El servidor MCP de Memberfy permite que Claude, ChatGPT, Cursor y Claude Code gestionen tu comunidad desde una conversación, con tu rol, en una sola comunidad y con confirmación antes de tocar el dinero o borrar. Qué es, para qué sirve, cómo funciona, qué se puede y qué no se puede hacer, y un ejemplo de la petición al resultado.

El **MCP** (Model Context Protocol) es el estándar abierto que usan los asistentes de IA para operar otros sistemas. Memberfy tiene un servidor MCP en **`https://api.memberfy.net/mcp`**: conectado a él, tu asistente deja de limitarse a dar consejos sobre la comunidad y pasa a hacer el trabajo dentro de ella. Describes lo que quieres en una conversación; él lee lo que necesita, crea en el orden correcto y te cuenta lo que ha hecho.

## Para qué sirve

Quien vive de una comunidad dedica buena parte del tiempo a montar cosas: el espacio del curso nuevo, los módulos y las lecciones, la página de venta, el evento del mes con su entrada, el plan con mensual y anual, el cupón de la campaña. Cada una de esas cosas es una secuencia de pantallas y formularios. Con el MCP, es una petición.

| Quién | Qué le pide al asistente | Qué ocurre en Memberfy |
|---|---|---|
| Escuela online | "Monta el curso *Excel desde Cero* con 4 módulos y 3 lecciones en cada uno, y un producto de R$ 297 en hasta 10 cuotas" | Un espacio de Cursos, el curso, 4 módulos, 12 lecciones y el producto en borrador, que da acceso al espacio |
| Mentoría en grupo | "Crea el plan *Mentoría* con mensual de R$ 390 y anual de R$ 3.900, con contrato de 6 meses en el mensual" | Dos opciones de cobro y el plan con ambas, en borrador |
| Comunidad de eventos | "Crea el encuentro presencial del 15/11 a las 19 h en São Paulo, con 80 entradas de R$ 60" | El espacio de Eventos, el evento y la entrada con un stock de 80 |
| Coworking | "¿Quién ha entrado en la comunidad esta semana? Escribe una bienvenida en el Feed mencionando a cada uno" | La lista de los miembros nuevos y la publicación en el Feed |
| Cualquier comunidad con ventas | "¿Cuánto hemos vendido en los últimos 90 días, por producto? Haz un gráfico" | El resumen de ventas, que el asistente convierte en tabla o gráfico |

El asistente también lee: miembros, espacios, publicaciones y comentarios, eventos y participantes, cursos, planes, productos, cupones y, para quien tiene acceso, ventas, suscripciones, extracto, saldo y retiros. Responder "¿quién ha confirmado asistencia al evento del jueves?" pasa a ser una pregunta, no una búsqueda en el panel.

## Cómo funciona

<div class="flow">
<div class="flow-row"><span class="flow-node">Tú pides</span><span class="flow-arrow">→</span><span class="flow-node">El asistente elige las herramientas</span><span class="flow-arrow">→</span><span class="flow-node">Memberfy ejecuta con tu rol</span><span class="flow-arrow">→</span><span class="flow-node">El asistente te cuenta el resultado</span></div>
</div>

### Tres reglas que lo definen todo

**1. El asistente actúa con tu rol.** Entra como tú, con el rol que tienes en esa comunidad, comprobado en cada llamada. Un moderador conectado puede fijar publicaciones y crear eventos, pero no crear planes; un miembro puede publicar y comentar donde ya podía. Si tu rol cambia en el panel, el asistente cambia con él; si sales de la comunidad, la conexión deja de funcionar. El MCP no tiene reglas de permisos propias: cada acción pasa por las mismas comprobaciones que la pantalla. Consulta [Roles y permisos](/conceitos/papeis-e-permissoes).

**2. Una conexión, una comunidad.** Al conectar, eliges **una** comunidad, y el asistente solo ve y solo actúa en ella. Para trabajar en otra, haces otra conexión. Consulta [Autorizar y desconectar](/mcp/autorizar-e-desconectar).

**3. Revocable en cualquier momento.** En **Mi Cuenta › Asistentes de IA** (`/account?tab=assistants`), un clic en **Desconectar** corta el acceso al instante. El propietario y los administradores también ven y desconectan cualquier asistente con acceso a la comunidad, en **Configuración › Asistentes de IA**.

### Las herramientas

El servidor ofrece **188 herramientas**, organizadas por tema, y cubre todos los módulos de la comunidad: lo que la app te deja hacer, el asistente lo hace desde la conversación. Solo ve las que tu rol puede usar: la lista de un miembro es mucho más corta que la de un propietario.

| Tema | Qué se puede hacer | Ejemplos |
|---|---|---|
| [Comunidad y estructura](/mcp/ferramentas-comunidade) | El contexto de la conexión, secciones y espacios (crear, reordenar, eliminar, quién los ve), abrir un enlace de la app, la configuración de la comunidad | `get_community_context`, `create_space`, `update_space_access` |
| [Contenido e interacción](/mcp/ferramentas-conteudo) | Buscar, publicar, editar, mover y eliminar publicaciones y comentarios, reaccionar, fijar, galería | `create_post`, `move_post`, `create_comment` |
| [Cursos](/mcp/ferramentas-cursos) | Montar un curso entero, editar y eliminar módulos y lecciones, matrícula y progreso | `create_course`, `update_lesson` |
| [Eventos](/mcp/ferramentas-eventos) | Crear eventos con entrada, editarlos, transmisión en directo, ver quién va | `create_event`, `start_live_stream` |
| [Miembros](/mcp/ferramentas-membros) | Invitar a una persona o a una clase, cambiar roles, quitar, grupos, etiquetas y organigrama | `invite_members`, `update_member_role`, `create_group` |
| [Ventas y planes](/mcp/ferramentas-vendas) | Planes, opciones, adicionales, productos, precios, cupones y downsell, en borrador hasta la aprobación | `create_plan`, `update_coupon` |
| [Suscripciones](/mcp/ferramentas-assinaturas) | Quién está suscrito a qué, cortesías, descuentos, extensiones y cancelaciones; tus suscripciones | `list_subscriptions`, `manage_my_subscription` |
| [Finanzas](/mcp/ferramentas-financeiro) | Ventas, extracto, saldo, retiros y la comisión | `get_sales_summary`, `request_payout` |
| [Certificados](/mcp/ferramentas-certificados) | Plantillas con la vista previa en la conversación, emisión para la clase, revocación | `create_certificate_template`, `issue_certificate` |
| [Convocatoria de ponencias](/mcp/ferramentas-chamada) | El ciclo completo: abrir la convocatoria, comité, puntuaciones, decisión, negociación, agenda y votación; y el lado de quien propone | `create_call_for_papers`, `review_proposal`, `submit_proposal` |
| [Informes y gráficos](/mcp/relatorios-e-graficos) | Ventas, MRR, miembros activos, interacción y ranking, eventos y cursos, con el gráfico en la conversación | `sales_report`, `community_overview` |

Cada herramienta solo consulta, modifica algo al momento o pide tu confirmación antes de actuar; el sello de cada una está en la lista.

La lista completa, con el rol mínimo de cada una, está en [Herramientas](/mcp/ferramentas).

Después de mostrar datos o terminar una acción, Memberfy sugiere al asistente hasta tres próximos pasos que encajan con lo que se devolvió y con tu rol. Ver [Próximos pasos](/mcp/ferramentas#proximos-pasos). En Claude, ocho peticiones frecuentes también están listas en el menú: ver [Recetas listas en el menú](/mcp/conectar-o-claude#recetas-listas-en-el-menu).

### Dinero y eliminaciones solo con tu sí

Ninguna herramienta de dinero o de eliminación actúa en la primera llamada. Devuelve un **resumen** (el cupón, el descuento, la validez; el precio actual y el nuevo; el importe del retiro y el saldo) y un código de confirmación. El asistente te muestra el resumen, respondes "sí", y solo entonces repite la llamada con el código. El código vale **10 minutos**, sirve **una vez** y solo funciona con **los mismos valores** del resumen. El resto (invitaciones, roles, configuración, certificados) se ejecuta en la primera llamada, como un clic en el panel. Consulta [Dinero y confirmación](/mcp/dinheiro-e-confirmacao).

### Lo que nunca sale

El asistente ve lo que ve tu rol, y nada más. En importes, aparece la [comisión de la plataforma](/pagamentos/taxa-da-plataforma); los costes internos de procesamiento no forman parte de ninguna respuesta, ni siquiera para el propietario.

## Un ejemplo, de la petición al resultado

Marina es propietaria de la comunidad *Hojas de Cálculo que Piensan*, ha conectado Claude y ha escrito:

> Monta el curso "Excel desde Cero" en el espacio de cursos que ya existe: 3 módulos (Fundamentos, Fórmulas, Tablas dinámicas), con 3 lecciones de vídeo en cada uno. Crea también el producto para vender el curso por R$ 297 en hasta 10 cuotas, pero déjalo en borrador.

Lo que hizo el asistente, herramienta por herramienta:

| # | Herramienta | Para qué | Resultado |
|---|---|---|---|
| 1 | `get_community_context` | Saber en qué comunidad y con qué rol está, y encontrar las secciones y los espacios | Propietaria; sección *Aprender* con el espacio *Cursos* (módulo `courses`) |
| 2 | `create_course` | Montarlo todo de una vez, con `space_id` del espacio *Cursos*, los 3 módulos con 3 lecciones `video` cada uno, y `sale` con `price: 297`, `max_installments: 10` | El curso, 3 módulos, 9 lecciones y el producto *Excel desde Cero* en borrador, que da acceso al espacio *Cursos* |

Y respondió:

> Listo. He creado el curso **Excel desde Cero** en el espacio *Cursos*, con los módulos Fundamentos, Fórmulas y Tablas dinámicas y 3 lecciones en cada uno (9 en total). El producto **Excel desde Cero**, de R$ 297,00 en hasta 10 cuotas con tarjeta, está en **borrador**: cuando quieras vender, solo tienes que pedirme que lo publique. Las lecciones aún no tienen contenido; eso lo añades desde el panel.

En Memberfy, Marina encuentra el curso en el espacio, y el producto en **Monetización › Productos**, en borrador. Si dice "puedes publicarlo", el asistente llama a `publish_product`. Si en medio del montaje algún paso hubiera fallado (por ejemplo, que el espacio indicado no fuera de cursos), `create_course` habría deshecho todo lo que ya había creado y habría explicado el motivo, sin dejar un curso a medias.

Más peticiones listas, con la secuencia esperada de herramientas, en [Recetas](/mcp/receitas).

## Qué se puede y qué no se puede hacer

| Se puede | Todavía no se puede |
|---|---|
| Crear secciones, espacios, publicaciones, comentarios y reacciones; fijar publicaciones | Programar una publicación para más tarde |
| Crear, editar y eliminar cursos, módulos y lecciones (título, tipo, duración) | Guardar el contenido de una lección (texto, vídeo) |
| Crear eventos online, presenciales o híbridos, con entrada | Inscribir automáticamente en la lista de participantes a quien compró la entrada |
| Crear opciones de cobro, productos y planes con adicionales; publicar y despublicar; cambiar tu propio plan (con confirmación) | Cambiar el plan de otro suscriptor |
| Crear cupones, cambiar precios, pedir y cancelar retiros, cancelar suscripciones (con confirmación) | Hacer reembolsos |
| Invitar a una persona o a una clase, cambiar roles, organizar grupos, etiquetas y el organigrama (con confirmación para quitar a alguien) | Moderar varios elementos en una sola llamada (el asistente modera uno por uno) |
| Leer ventas, suscripciones, extracto, saldo y retiros; cambiar nombre, colores, logo, SEO, idioma y reglas de entrada | Cambiar el dominio y las integraciones |
| Crear plantillas de certificado y emitir para una clase; decidir propuestas de la convocatoria de ponencias; cambiar el ranking y la tienda | Cambiar el plan de otro suscriptor (cada uno cambia el suyo) |

Lo que todavía no se puede sigue en el panel, como siempre. Consulta [Problemas comunes](/mcp/problemas-comuns#lo-que-todavia-no-se-puede-hacer).

## Quién puede usarlo

Cualquier persona con cuenta en Memberfy y un rol en una comunidad: lo que el asistente puede hacer depende de ese rol.

| Rol | En la práctica |
|---|---|
| **Propietario** y **Administrador** | Todo lo que ofrece el MCP: montar estructura, cursos, eventos, planes, cupones; ver y mover dinero, con confirmación |
| **Moderador** | Leer la comunidad y los miembros, publicar, comentar, fijar publicaciones, crear eventos sin entrada |
| **Finanzas** | Leer ventas, suscripciones, extracto, saldo y retiros; cancelar suscripciones, con confirmación; publicar y comentar |
| **Miembro** | Leer lo que ya ve, publicar donde ya podía, comentar y reaccionar |

## Por dónde empezar

1. Conecta tu asistente: [Claude](/mcp/conectar-o-claude), [ChatGPT](/mcp/conectar-o-chatgpt) o [Claude Code y Cursor](/mcp/conectar-claude-code-e-cursor).
2. Pide primero algo de lectura, para comprobar la conexión: *"¿A qué comunidad estás conectado y con qué rol?"*.
3. Prueba una [receta](/mcp/receitas).
4. Lee [Seguridad y límites](/mcp/seguranca) antes de dar acceso a otras personas del equipo.

## Preguntas frecuentes

**¿Tengo que saber programar?**
No. En Claude y en ChatGPT, conectar es pegar una dirección y hacer clic en **Permitir**. La [API](/api/introducao) es para quien quiere integrar con código; el MCP es para quien quiere conversar.

**¿El asistente recuerda lo que hizo ayer?**
Quien recuerda es el asistente, según la conversación. Memberfy guarda el resultado: lo que se creó está en el panel, y cada acción del asistente queda registrada y aparece para el propietario y los administradores en **Miembros › Registros**. Consulta [Registros de actividad](/membros/registros-de-atividades).

**¿El asistente puede borrar cosas?**
Sí, con tu confirmación. Hay herramientas para eliminar publicaciones, comentarios, secciones, espacios, eventos, cursos, grupos, etiquetas, certificados y más (todas empiezan por `delete_`, `remove_`, `revoke_`, `withdraw_` o `cancel_`), y ninguna actúa en la primera llamada: muestra qué se va a eliminar, respondes "sí" y solo entonces el asistente repite la llamada con el código. Es la misma confirmación en dos pasos que se usa para el dinero; consulta [Dinero y confirmación](/mcp/dinheiro-e-confirmacao). Las herramientas compuestas solo deshacen lo que ellas mismas acaban de crear, cuando un paso falla.

**¿Y si el asistente entiende mal?**
Lo que no implica dinero ni eliminación se hace al momento, como si hubieras hecho clic: revisa el resultado y corrígelo desde el panel o pidiéndolo de nuevo. Lo que implica dinero o borra solo ocurre después de tu sí al resumen.

**¿Tiene coste?**
El servidor MCP forma parte de Memberfy. El asistente (Claude, ChatGPT, Cursor) tiene sus propios planes.

## Relacionados

- [Herramientas](/mcp/ferramentas)
- [Dinero y confirmación](/mcp/dinheiro-e-confirmacao)
- [Seguridad y límites](/mcp/seguranca)
- [Problemas comunes](/mcp/problemas-comuns)
