Ferramentas

O servidor MCP da Memberfy tem 188 ferramentas, que cobrem todos os módulos da comunidade: o assistente faz o que o app deixa a pessoa conectada fazer, com o papel dela. O assistente escolhe sozinho qual usar a partir do seu pedido; esta página e as de cada assunto servem para você saber o que ele consegue fazer, com que papel, e como pedir. Os nomes estão em inglês, como o assistente os vê, e são os mesmos em qualquer idioma; o título que aparece no Claude ou no ChatGPT vem no idioma de quem conectou.

#Por assunto

Cada ferramenta tem um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo.

#Todas as ferramentas

Papel mínimo: o menor papel com que a ferramenta aparece. "Qualquer" inclui o membro. O financeiro está listado à parte porque não entra na escada dos outros papéis.

#Quantas cada papel vê

As 40 da chamada de trabalhos aparecem para todos porque o dono de uma chamada pode ser um membro comum, e qualquer membro propõe, avalia ou vota quando a chamada deixa. A Memberfy confere cada chamada pela regra do módulo. Ver Chamada de trabalhos.

Uma conexão autorizada só para leitura vê só as ferramentas de leitura do papel.

Ver uma ferramenta na lista não garante que toda chamada passe: a Memberfy confere cada ação como se fosse feita na tela. Um membro vê create_post, mas publicar num espaço com Quem pode postar = Equipe é recusado. Ver Papéis e permissões.

#Regras comuns

#Os ids

As ferramentas falam por ids, e onde pedem um id aceitam também o link copiado do app (ver open_link). Quase todas as conversas começam por get_community_context, que devolve as seções e os espaços com os ids; as listagens devolvem os ids do que listam. A descrição de cada ferramenta diz de onde vem cada id, e o assistente encadeia sozinho: você pede "publique no espaço Avisos", ele procura o id do espaço Avisos e publica.

#Paginação

As listagens aceitam page (a página, começando em 1) e limit (quantos por página). A resposta traz os itens e o total, para o assistente saber se precisa pedir a próxima página.

#Rascunho primeiro

Tudo o que se vende nasce em rascunho: create_product, o produto do create_course, o ingresso do create_event e as opções do create_plan. Nada vai para a venda sem publish_product (ou publish: true na composta). Assim você revisa antes.

Criar não depende da informação comercial aprovada; publicar, sim. Numa comunidade sem aprovação, a composta que pediu para publicar não desfaz nada: o curso, o evento ou o plano fica em rascunho, a resposta traz o motivo em publish_blocked, e o próximo passo sugerido é preencher a informação comercial e publicar depois. Ver Rascunho antes da aprovação.

#Idempotência nas compostas

As três compostas aceitam idempotency_key (até 100 caracteres). Repetir a chamada com a mesma chave devolve o resultado da primeira, sem criar de novo. Serve para quando a conexão cai no meio e o assistente não sabe se a chamada passou.

#Desfazer quando um passo falha

As compostas criam em ordem e, se um passo falha, apagam o que já tinham criado (menos quando o que falhou foi publicar sem a informação comercial aprovada: aí fica tudo em rascunho), do mais novo para o mais antigo, e dizem qual passo falhou: "O passo "módulo 2" falhou e tudo o que esta chamada criou foi desfeito." Se algo não puder ser desfeito, a resposta lista o que sobrou para você conferir no painel.

#Próximos passos

Quando cabe uma continuação, a resposta da ferramenta traz next_steps: até três ações sugeridas, cada uma com a ferramenta, o motivo (no idioma de quem conectou) e, às vezes, os argumentos já prontos. Elas dependem do que voltou e do seu papel: só entram ferramentas que você pode usar. O assistente oferece essas ações antes de sugerir qualquer outra coisa, e nenhuma acontece sem você pedir.

#Erros

Quando a Memberfy recusa, o assistente recebe a mensagem dela, a mesma da tela:

#Versão do servidor e da lista

Cada deploy da Memberfy muda a versão do servidor, e a lista de ferramentas que uma conexão recebe tem uma impressão digital própria. É assim que se sabe se um assistente está com a lista em dia.

Chamar uma ferramenta que não está na lista da conexão devolve um erro de ferramenta (isError) pedindo para a pessoa abrir uma conversa nova ou reconectar; se o nome é um dos antigos em português, a resposta traz renamed_to com o nome novo. A chamada fica na auditoria como tool.unknown.

O proprietário e os administradores comparam a última lista que uma conexão recebeu com a atual em GET /api/oauth/connections/{id}/diagnostics: o campo listUpToDate diz se ela está em dia. Ver Auditoria.

#Pedem confirmação

Só pedem confirmação as ferramentas que mexem em dinheiro e as que apagam (as que começam com delete_, remove_, revoke_, withdraw_ ou cancel_). Com o selo Pede confirmação, elas não agem na primeira chamada: devolvem um resumo e um código, e só agem quando o assistente repete a chamada com o código, depois do seu sim. Todas as outras, inclusive convites, troca de papel, configurações e emissão de certificados, rodam na primeira chamada. A tabela acima mostra o selo de cada uma. Ver Dinheiro e confirmação.

#Texto em Markdown

O assistente escreve e lê o texto da Memberfy em Markdown. A Memberfy converte para o texto formatado do app na ida, e de volta para Markdown na volta: o post aparece no app com negrito e lista, e não com asteriscos.

O que não passa para o app:

• Imagem dentro do texto vira um link para a imagem. Para a capa de um post ou o banner de um evento, use image_url (veja Imagens).
• Tabela vira linhas de texto, uma por linha da tabela.
• Script, atributos de evento e links javascript: são removidos.

HTML pronto também é aceito e passa pelo mesmo filtro. Na leitura, as ferramentas devolvem o texto formatado em Markdown e marcam o resultado com text_format: "markdown". Ler e gravar de novo o mesmo texto não muda nada.

#Imagens

create_post, add_gallery_image, create_course, create_event, update_post, update_event e update_course aceitam a imagem de dois jeitos:

• image_url: o link de uma imagem que está na internet. A Memberfy baixa e guarda como se você a tivesse enviado pelo painel.
• image_base64 (com image_type, opcional): o arquivo em si, até 5 MB. É o caminho para uma imagem que o próprio assistente gerou na conversa. SVG é aceito e vira PNG; SVG que aponta para arquivos externos é recusado.

Um link de página (e não da imagem em si) é recusado com "o arquivo não é uma imagem JPEG, PNG, WebP ou GIF".

Nas compostas, uma imagem ruim não desfaz o resto: o curso ou o evento é criado sem a capa, e a resposta traz o motivo em warnings ("Não deu para usar a imagem de …: a imagem passa de 10 MB."). Peça de novo com outro link, ou ponha a imagem pelo painel. Nas ferramentas de uma coisa só (create_post, add_gallery_image), a imagem ruim impede a criação.

#Relacionados

• Receitas
• Dinheiro e confirmação
• Segurança e limites