# Visão geral do MCP

> O servidor MCP da Memberfy deixa o Claude, o ChatGPT, o Cursor e o Claude Code operarem a sua comunidade numa conversa, com o seu papel, numa comunidade só, e com confirmação antes de mexer em dinheiro ou apagar. O que é, para que serve, como funciona, o que dá e o que não dá para fazer, e um exemplo do pedido ao resultado.

O **MCP** (Model Context Protocol) é o padrão aberto que os assistentes de IA usam para operar outros sistemas. A Memberfy tem um servidor MCP em **`https://api.memberfy.net/mcp`**: conectado a ele, o seu assistente deixa de só dar conselhos sobre a comunidade e passa a fazer o trabalho dentro dela. Você descreve o que quer numa conversa; ele lê o que precisa, cria na ordem certa e diz o que fez.

## Para que serve

Quem vive de comunidade passa boa parte do tempo montando coisas: o espaço do curso novo, os módulos e as aulas, a página de venda, o evento do mês com o ingresso, o plano com mensal e anual, o cupom da campanha. Cada uma dessas coisas é uma sequência de telas e formulários. Com o MCP, é um pedido.

| Quem | O que pede ao assistente | O que acontece na Memberfy |
|---|---|---|
| Escola online | "Monte o curso *Excel do Zero* com 4 módulos e 3 aulas em cada, e um produto de R$ 297 em até 10×" | Um espaço de Cursos, o curso, 4 módulos, 12 aulas e o produto em rascunho, que libera o espaço |
| Mentoria em grupo | "Crie o plano *Mentoria* com mensal de R$ 390 e anual de R$ 3.900, com contrato de 6 meses no mensal" | Duas opções de cobrança e o plano com as duas, em rascunho |
| Comunidade de eventos | "Crie o encontro presencial de 15/11 às 19h em São Paulo, com 80 ingressos de R$ 60" | O espaço de Eventos, o evento e o ingresso com estoque de 80 |
| Coworking | "Quem entrou na comunidade esta semana? Escreva uma boas-vindas no Feed citando cada um" | A lista dos novos membros e o post no Feed |
| Qualquer comunidade com vendas | "Quanto vendemos nos últimos 90 dias, por produto? Faça um gráfico" | O resumo de vendas, que o assistente transforma em tabela ou gráfico |

O assistente também lê: membros, espaços, posts e comentários, eventos e participantes, cursos, planos, produtos, cupons e, para quem tem acesso, vendas, assinaturas, extrato, saldo e saques. Responder "quem confirmou presença no evento de quinta?" passa a ser uma pergunta, não uma busca no painel.

## Como funciona

<div class="flow">
<div class="flow-row"><span class="flow-node">Você pede</span><span class="flow-arrow">→</span><span class="flow-node">O assistente escolhe as ferramentas</span><span class="flow-arrow">→</span><span class="flow-node">A Memberfy executa com o seu papel</span><span class="flow-arrow">→</span><span class="flow-node">O assistente conta o resultado</span></div>
</div>

### Três regras que definem tudo

**1. O assistente age com o seu papel.** Ele entra como você, com o papel que você tem naquela comunidade, conferido a cada chamada. Um moderador conectado consegue fixar posts e criar eventos, mas não criar planos; um membro consegue publicar e comentar onde já podia. Se o seu papel mudar no painel, o assistente muda junto; se você sair da comunidade, a conexão para de funcionar. O MCP não tem regra de permissão própria: cada ação passa pelas mesmas verificações da tela. Ver [Papéis e permissões](/conceitos/papeis-e-permissoes).

**2. Uma conexão, uma comunidade.** Ao conectar, você escolhe **uma** comunidade, e o assistente só enxerga e só mexe nela. Para trabalhar em outra, você faz outra conexão. Ver [Autorizar e desconectar](/mcp/autorizar-e-desconectar).

**3. Revogável a qualquer momento.** Em **Minha Conta › Assistentes de IA** (`/account?tab=assistants`), um clique em **Desconectar** corta o acesso na hora. O proprietário e os administradores também veem e desconectam qualquer assistente com acesso à comunidade, em **Configurações › Assistentes de IA**.

### As ferramentas

O servidor oferece **188 ferramentas**, organizadas por assunto, e cobre todos os módulos da comunidade: o que o app deixa você fazer, o assistente faz pela conversa. Ele só vê as que o seu papel pode usar: a lista de um membro é bem menor que a de um proprietário.

| Assunto | O que dá para fazer | Exemplos |
|---|---|---|
| [Comunidade e estrutura](/mcp/ferramentas-comunidade) | O contexto da conexão, seções e espaços (criar, reordenar, excluir, quem vê), abrir um link do app, as configurações da comunidade | `get_community_context`, `create_space`, `update_space_access` |
| [Conteúdo e engajamento](/mcp/ferramentas-conteudo) | Buscar, publicar, editar, mover e excluir posts e comentários, reagir, fixar, galeria | `create_post`, `move_post`, `create_comment` |
| [Cursos](/mcp/ferramentas-cursos) | Montar um curso inteiro, editar e excluir módulos e aulas, matrícula e progresso | `create_course`, `update_lesson` |
| [Eventos](/mcp/ferramentas-eventos) | Criar eventos com ingresso, editar, transmissão ao vivo, ver quem vai | `create_event`, `start_live_stream` |
| [Membros](/mcp/ferramentas-membros) | Convidar uma pessoa ou uma turma, trocar papéis, remover, grupos, tags e organograma | `invite_members`, `update_member_role`, `create_group` |
| [Vendas e planos](/mcp/ferramentas-vendas) | Planos, opções, adicionais, produtos, preços, cupons e downsell, em rascunho até a aprovação | `create_plan`, `update_coupon` |
| [Assinaturas](/mcp/ferramentas-assinaturas) | Quem assina o quê, cortesias, descontos, extensões e cancelamentos; as suas assinaturas | `list_subscriptions`, `manage_my_subscription` |
| [Financeiro](/mcp/ferramentas-financeiro) | Vendas, extrato, saldo, saques e a taxa | `get_sales_summary`, `request_payout` |
| [Certificados](/mcp/ferramentas-certificados) | Modelos com a pré-visualização na conversa, emissão para a turma, revogação | `create_certificate_template`, `issue_certificate` |
| [Chamada de trabalhos](/mcp/ferramentas-chamada) | O ciclo inteiro: abrir a chamada, comitê, notas, decisão, negociação, agenda e votação; e o lado de quem propõe | `create_call_for_papers`, `review_proposal`, `submit_proposal` |
| [Relatórios e gráficos](/mcp/relatorios-e-graficos) | Vendas, MRR, membros ativos, engajamento e ranking, eventos e cursos, com o gráfico na conversa | `sales_report`, `community_overview` |

Cada ferramenta só consulta, altera algo na hora ou pede a sua confirmação antes de agir; o selo de cada uma está na lista.

A lista completa, com o papel mínimo de cada uma, está em [Ferramentas](/mcp/ferramentas).

Depois de mostrar dados ou concluir uma ação, a Memberfy sugere ao assistente até três próximos passos que combinam com o que voltou e com o seu papel. Ver [Próximos passos](/mcp/ferramentas#proximos-passos). No Claude, oito pedidos frequentes também estão prontos no menu: ver [Receitas prontas no menu](/mcp/conectar-o-claude#receitas-prontas-no-menu).

### Dinheiro e exclusões só com o seu sim

Nenhuma ferramenta de dinheiro ou de exclusão age na primeira chamada. Ela devolve um **resumo** (o cupom, o desconto, a validade; o preço atual e o novo; o valor do saque e o saldo) e um código de confirmação. O assistente mostra o resumo, você responde "sim", e só então ele repete a chamada com o código. O código vale **10 minutos**, serve **uma vez** e só funciona com **os mesmos valores** do resumo. O resto (convites, papéis, configurações, certificados) roda na primeira chamada, como um clique no painel. Ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao).

### O que nunca sai

O assistente vê o que o seu papel vê, e nada além. Em valores, aparece a [taxa da plataforma](/pagamentos/taxa-da-plataforma); custos internos de processamento não fazem parte de nenhuma resposta, nem para o proprietário.

## Um exemplo, do pedido ao resultado

A Marina é proprietária da comunidade *Planilhas que Pensam*, conectou o Claude e escreveu:

> Monte o curso "Excel do Zero" no espaço de cursos que já existe: 3 módulos (Fundamentos, Fórmulas, Tabelas dinâmicas), com 3 aulas de vídeo em cada. Crie também o produto para vender o curso por R$ 297 em até 10×, mas deixe em rascunho.

O que o assistente fez, ferramenta por ferramenta:

| # | Ferramenta | Para quê | Resultado |
|---|---|---|---|
| 1 | `get_community_context` | Saber em que comunidade e com que papel está, e achar as seções e os espaços | Proprietária; seção *Aprender* com o espaço *Cursos* (módulo `courses`) |
| 2 | `create_course` | Montar tudo de uma vez, com `space_id` do espaço *Cursos*, os 3 módulos com 3 aulas `video` cada, e `sale` com `price: 297`, `max_installments: 10` | O curso, 3 módulos, 9 aulas e o produto *Excel do Zero* em rascunho, que libera o espaço *Cursos* |

E respondeu:

> Pronto. Criei o curso **Excel do Zero** no espaço *Cursos*, com os módulos Fundamentos, Fórmulas e Tabelas dinâmicas e 3 aulas em cada (9 no total). O produto **Excel do Zero**, de R$ 297,00 em até 10× no cartão, está em **rascunho**: quando quiser vender, é só pedir para publicar. As aulas ainda não têm conteúdo; isso você coloca pelo painel.

Na Memberfy, a Marina encontra o curso no espaço, e o produto em **Monetização › Produtos**, em rascunho. Se ela disser "pode publicar", o assistente chama `publish_product`. Se no meio da montagem algum passo tivesse falhado (por exemplo, o espaço indicado não fosse de cursos), o `create_course` teria desfeito tudo o que já tinha criado e explicado o motivo, sem deixar um curso pela metade.

Mais pedidos prontos, com a sequência esperada de ferramentas, estão em [Receitas](/mcp/receitas).

## O que dá e o que não dá para fazer

| Dá | Ainda não dá |
|---|---|
| Criar seções, espaços, posts, comentários e reações; fixar posts | Agendar um post para depois |
| Criar, editar e excluir cursos, módulos e aulas (título, tipo, duração) | Gravar o conteúdo de uma aula (texto, vídeo) |
| Criar eventos online, presenciais ou híbridos, com ingresso | Inscrever automaticamente quem comprou o ingresso na lista de participantes |
| Criar opções de cobrança, produtos e planos com adicionais; publicar e despublicar; mudar o seu próprio plano (com confirmação) | Trocar o plano de outro assinante |
| Criar cupons, alterar preços, pedir e cancelar saques, cancelar assinaturas (com confirmação) | Fazer reembolsos |
| Convidar uma pessoa ou uma turma, trocar papéis, organizar grupos, tags e o organograma (com confirmação para remover alguém) | Moderar vários itens numa chamada só (o assistente modera um por vez) |
| Ler vendas, assinaturas, extrato, saldo e saques; mudar nome, cores, logo, SEO, idioma e regras de entrada | Mudar o domínio e as integrações |
| Criar modelos de certificado e emitir para uma turma; decidir propostas da chamada de trabalhos; mudar o ranking e a loja | Mudar o plano de outro assinante (cada um muda o seu) |

O que ainda não dá continua no painel, como sempre. Ver [Problemas comuns](/mcp/problemas-comuns#o-que-ainda-nao-da-para-fazer).

## Quem pode usar

Qualquer pessoa com conta na Memberfy e um papel numa comunidade: o que o assistente consegue fazer depende desse papel.

| Papel | Na prática |
|---|---|
| **Proprietário** e **administrador** | Tudo o que o MCP oferece: montar estrutura, cursos, eventos, planos, cupons; ver e mexer em dinheiro, com confirmação |
| **Moderador** | Ler a comunidade e os membros, publicar, comentar, fixar posts, criar eventos sem ingresso |
| **Financeiro** | Ler vendas, assinaturas, extrato, saldo e saques; cancelar assinaturas, com confirmação; publicar e comentar |
| **Membro** | Ler o que já vê, publicar onde já podia, comentar e reagir |

## Por onde começar

1. Conecte o seu assistente: [Claude](/mcp/conectar-o-claude), [ChatGPT](/mcp/conectar-o-chatgpt) ou [Claude Code e Cursor](/mcp/conectar-claude-code-e-cursor).
2. Peça primeiro algo de leitura, para conferir a conexão: *"Em que comunidade você está conectado, e com que papel?"*.
3. Experimente uma [receita](/mcp/receitas).
4. Leia [Segurança e limites](/mcp/seguranca) antes de dar acesso a outras pessoas da equipe.

## Perguntas frequentes

**Preciso saber programar?**
Não. No Claude e no ChatGPT, conectar é colar um endereço e clicar em **Permitir**. A [API](/api/introducao) é para quem quer integrar com código; o MCP é para quem quer conversar.

**O assistente lembra o que fez ontem?**
Quem lembra é o assistente, conforme a conversa. A Memberfy guarda o resultado: o que foi criado está no painel, e cada ação do assistente fica registrada e aparece para o proprietário e os administradores em **Membros › Logs**. Ver [Registros de atividades](/membros/registros-de-atividades).

**O assistente pode apagar coisas?**
Pode, com a sua confirmação. Há ferramentas para excluir posts, comentários, seções, espaços, eventos, cursos, grupos, tags, certificados e mais (todas começam com `delete_`, `remove_`, `revoke_`, `withdraw_` ou `cancel_`), e nenhuma age na primeira chamada: ela mostra o que vai ser excluído, você responde "sim" e só então o assistente repete a chamada com o código. É a mesma confirmação em duas etapas do que mexe em dinheiro; ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao). As ferramentas compostas desfazem só o que elas mesmas acabaram de criar, quando um passo falha.

**E se o assistente entender errado?**
O que não envolve dinheiro nem exclusão é feito na hora, como se você tivesse clicado: confira o resultado e corrija pelo painel ou pedindo de novo. O que envolve dinheiro ou apaga só acontece depois do seu sim ao resumo.

**Tem custo?**
O servidor MCP faz parte da Memberfy. O assistente (Claude, ChatGPT, Cursor) tem os planos dele.

## Relacionados

- [Ferramentas](/mcp/ferramentas)
- [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao)
- [Segurança e limites](/mcp/seguranca)
- [Problemas comuns](/mcp/problemas-comuns)