Configurando o Claude Desktop com o MemberPress

O MemberPress AI Foundation permite que o Área de Trabalho do Claude O aplicativo se comunica com um site MemberPress. Uma vez conectado, o Claude Desktop lê os dados do MemberPress e executa tarefas comuns por meio de conversas cotidianas, sem que ninguém precise escrever código.

Este guia orienta o administrador do site durante todo o processo de configuração. Ele aborda a instalação do complemento AI Foundation e, em seguida, a conexão do Claude Desktop por meio do assistente Assistente de configuração do MCP e o Conectores de mesa Claude painel. Nenhum arquivo de configuração é editado em nenhum momento.

Observação: Anthropic bills Claude Desktop’s AI usage through the Claude account, not MemberPress. MemberPress AI Credits are separate and do not apply to Claude Desktop. See Créditos de IA abaixo.

O que essa configuração oferece

Um aplicativo Claude Desktop conectado pode ler dados sobre membros, associações, transações, assinaturas, cursos e outros dados do MemberPress. Com o acesso de gravação habilitado, ele também pode realizar ações comuns, como criar membros, processar reembolsos ou gerenciar assinaturas.

A conexão utiliza o Protocolo de Contexto de Modelo (MCP). O MCP é um padrão aberto que permite que clientes de IA acessem dados externos por meio de uma interface previsível. O AI Foundation inclui um servidor MCP no MemberPress. O Claude Desktop se conecta a esse servidor assim que o administrador autoriza o acesso.

O Visão geral e guia de configuração do MemberPress AI Foundation aborda o protocolo, o servidor e os escopos disponíveis com mais detalhes.

Antes de começar

O site precisa atender a esses requisitos para que a conexão funcione:

• Um trabalho Instalação do MemberPress no WordPress 6.5 ou superior;
• Uma licença MemberPress ativa (necessária para baixar o complemento do AI Foundation);
• PHP 8.0 ou superior no servidor (a maioria dos planos de hospedagem atuais atende a esse requisito);
• Um ativo Área de Trabalho do Claude installation on the administrator’s computer.

Importante: O administrador responsável por essa configuração precisa do gerenciar_opções Recurso do WordPress. Os usuários com a função padrão de Administrador já a possuem por padrão.

Instalação do MemberPress AI Foundation

A AI Foundation é instalada por meio do fluxo de trabalho padrão de complementos MemberPress.

Instalação padrão

1. Confirme se a licença MemberPress está ativa em MemberPress > Configurações > Licença;
2. Navegue até MemberPress > Complementos;
3. Localize o Fundação de IA cartão;
4. Clique em Instalar o complemento. O plugin é baixado e ativado automaticamente;
5. Confirme que Configurações de IA aparece na barra lateral de administração do WordPress, na seção MemberPress.

Instalação manual

Utilize este método quando o site não conseguir acessar diretamente os servidores de download do MemberPress:

1. Baixe o plug-in do AI Foundation a partir do Portal da conta MemberPress;
2. No WordPress, acesse Plug-ins > Adicionar novo > Fazer upload de plug-in;
3. Selecione o arquivo ZIP baixado e, em seguida, clique em Instalar agora;
4. Clique em Ativar o plug-in.

Confirmando a instalação

Após a ativação, verifique duas coisas:

• MemberPress > Configurações de IA aparece na barra lateral de administração;
• Assistente de configuração do MCP é a primeira aba da página “Configurações de IA”.

Se alguma dessas verificações falhar, significa que o plug-in não foi ativado corretamente. Consulte Erros do MCP e resolução de problemas para as etapas do diagnóstico.

As guias de configurações de IA

O Painel > MemberPress > Configurações de IA A página possui quatro abas. Três delas são responsáveis pela configuração da conexão:

• Assistente de configuração do MCP — orienta cada nova conexão por meio de quatro etapas;
• Clientes conectados ao MCP — lista todas as conexões ativas e revoga qualquer uma delas;
• Configurações do MCP — define o nível de acesso isso limita o que as novas conexões podem fazer.

A quarta aba, Créditos de IA, manages the credit balance for MemberPress’s own AI features. See Créditos de IA abaixo.

Defina primeiro o nível de acesso

O nível de acesso está definido em Configurações do MCP, e não no assistente. Isso limita o que qualquer novo que a conexão pode solicitar. Existem duas opções:

• Somente leitura — as novas conexões só podem ler dados MemberPress;
• Acesso total — novas conexões podem ler dados e executar ações de gravação, como criar membros ou processar reembolsos.

O nível de acesso é o único controle que determina se os escopos de gravação serão oferecidos durante a conexão. Defina-o antes de executando o assistente.

Para definir o nível de acesso:

1. Navegue até Painel > MemberPress > Configurações de IA > Configurações do MCP;
2. Escolha Somente leitura ou Acesso total sob “Nível máximo de acesso para novas conexões”;
3. Clique em Atualizar configurações.

Observação: O nível de acesso afeta apenas novas conexões. Ele nunca altera o acesso de uma conexão já existente.

Dica: Comece com Somente leitura para uma primeira conexão. Aumente o nível de acesso posteriormente, caso o Claude Desktop precise fazer alterações no site.

Conectando o Claude Desktop

A conexão atravessa duas superfícies: a Assistente de configuração do MCP no WordPress e no Conectores painel no Claude Desktop. O assistente, em Painel > MemberPress > Configurações de IA > Assistente de configuração do MCP, inicia uma nova conexão sempre que é executado, de modo que pode ser utilizado novamente sempre que outro cliente precisar se conectar. Siga as etapas na ordem.

Passo 1: Abra o assistente

1. Navegue até Painel > MemberPress > Configurações de IA > Assistente de configuração do MCP;
2. Revise o Bem-vindo tela, que exibe os detalhes do servidor MCP e quaisquer conexões existentes;
3. Clique em Começar a usar.

Observação: Quando já existe pelo menos uma conexão, o botão exibe Adicionar outra conexão em vez de Começar a usar. O assistente pode ser executado novamente a qualquer momento para adicionar uma nova conexão.

Etapa 2: Verifique o nível de acesso

The wizard’s Acesso o passo indica “Escolha o nível de acesso” e reflete o nível de acesso definido nas Configurações do MCP. Ele não oferece a opção de “Somente leitura” ou “Acesso total” — essa escolha foi feita na seção anterior.

Quando o nível de acesso é Somente Leitura, a etapa mostra um único escopo concedido:

• Leia tudo — Consultar membros, assinaturas, transações, regras e relatórios. Acesso sempre concedido.

Uma mensagem explica que os escopos de gravação não estão disponíveis: “O administrador do site definiu o nível máximo de acesso como ”Somente leitura’. Não é possível atribuir permissões de gravação a novas conexões até que esse nível seja aumentado nas configurações do MCP.”

Quando o nível de acesso é “Acesso total”, essa etapa adiciona caixas de seleção de escopo de gravação, todas marcadas por padrão. Desmarque qualquer escopo que esta conexão não precise:

• Editar conteúdo — Criar regras de acesso e cupons;
• Gerenciar membros — Criar e atualizar membros, gerenciar subcontas corporativas;
• Operações de faturamento (alto impacto) — Realizar transações de reembolso, cancelar, suspender ou retomar assinaturas;
• Importações em grande volume (alto impacto) — Criar membros em massa a partir de um array JSON;
• Gerenciar webhooks — Criar e excluir webhooks, ativar ou desativar lembretes por e-mail;
• Progresso no curso — Marcar as aulas como concluídas e zerar o progresso dos alunos (requer o complemento “Cursos”).

Importante: O Operações de faturamento e Importações em grande volume as miras têm um de alto impacto sinalizador. Elas permitem reembolsos, alterações na assinatura e criação em massa de membros. Conceda-as apenas a um contato de confiança.

Clique em Continuar para avançar para a etapa “Conectar”.

Etapa 3: Copie a URL do servidor

The wizard’s Conectar o passo indica “Conecte seu cliente de IA”. Ele exibe a URL do servidor MCP e um painel para cada cliente compatível.

1. Clique no botão Cópia ao lado do botão URL do servidor MCP;
2. Mantenha esta aba do WordPress aberta. O assistente será concluído assim que o Claude Desktop autorizar a conexão.

Etapa 4: Adicione o conector no Claude Desktop

Mude para o aplicativo Claude Desktop no mesmo computador.

1. Abra o Claude Desktop e clique em Personalizar na barra lateral;

2. Selecione Conectores;
3. Clique em Adicionar conector personalizado (o + (controle).

Na caixa de diálogo que se abre:

1. Entrar MemberPress como nome do conector;
2. Cole a URL copiada no URL do servidor MCP remoto campo;
3. Deixe o opcional ID do cliente OAuth e Segredo do cliente OAuth campos em branco — eles ficam recolhidos sob Configurações avançadas, e não há necessidade de expandi-las;
4. Leia o aviso sobre a confiança e, em seguida, clique em Adicionar.

Etapa 5: Conectar e autorizar

1. No novo MemberPress conector, clique Conectar;

2. Uma janela do navegador é aberta com o “Autorizar o pedido” tela. Ela exibe o aplicativo (Claude), o nível de acesso concedido e o destino do redirecionamento (claude.ai);
3. Faça login no site MemberPress caso não haja nenhuma sessão ativa;
4. Clique em Aprovar para conceder acesso, ou Negar para cancelar.

Após a aprovação, o navegador exibe um “Conectado” página e retorna automaticamente à área de trabalho do Claude. Se o redirecionamento não ocorrer, clique em Abrir o aplicativo para desktop.

Etapa 6: Confirme a conexão

1. No Claude Desktop, o MemberPress O conector agora aparece como conectado e exibe as ferramentas disponíveis;
2. The connector’s Permissões da ferramenta A lista mostra o que foi carregado: uma conexão somente leitura carrega 39 ferramentas somente para leitura; uma conexão com acesso total também inclui 15 ferramentas de gravação/exclusão. Cada ferramenta vem configurada por padrão para “Precisa de aprovação”, por isso o Claude Desktop pede confirmação antes de executar qualquer um deles;
3. Volte ao assistente do WordPress, que agora exibe o “You’re All Set!” tela com um resumo da conexão.

The wizard’s Feito Esta etapa apresenta três botões: Testar conexão, Gerenciar conexõese Feito. Clique em Feito para terminar.

Verificando a conexão

Confirme se a conexão funciona a partir do Claude Desktop:

1. Abra o Claude Desktop e inicie uma nova conversa;
2. Confirme o memberpress_* as ferramentas aparecem na lista de ferramentas disponíveis (por exemplo, lista_de_membros_do_memberpress);
3. Faça uma pergunta simples de teste, como, por exemplo, “Liste os cinco membros mais recentes do site MemberPress.”;
4. Aprovar a chamada da ferramenta quando o Claude Desktop a solicitar;
5. Confirme se o Claude Desktop retorna os dados.

Observação: Se as ferramentas não forem exibidas ou se a consulta de teste falhar, consulte Erros do MCP e resolução de problemas para problemas comuns.

Alteração do nível de acesso de uma conexão existente

A connection’s access level is fixed when it is created. It cannot be raised or lowered in place. To change it, replace the connection:

1. No Claude Desktop, abra Personalizar > Conectores > MemberPress e clique em Desconectar;
2. No WordPress, defina o novo nível de acesso em MemberPress > Configurações de IA > Configurações do MCP e clique em Atualizar configurações;
3. De volta ao Claude Desktop, clique em Conectar no conector MemberPress novamente e, em seguida, aprove a autorização. Isso cria uma nova conexão no novo nível de acesso.

Importante: Desconectar no Claude Desktop não remove a conexão antiga do lado do MemberPress. Após reconectar, existem duas linhas do MemberPress em Clientes conectados ao MCP, ambos mostrando Ativo — a mais antiga simplesmente não está mais vinculada ao cliente. Revogue a linha antiga (veja abaixo) tanto por motivos de manutenção quanto de segurança.

Para revogar a linha anterior, abra Clientes conectados ao MCP, identifique a conexão anterior por meio de seu Carimbo de data/hora associado e Nível de acessoe clique em Revogar. The old row’s Status stays Ativo Após a desconexão do lado do cliente — o Claude Desktop não notifica o site —, portanto, revogá-la aqui é a única maneira de encerrá-la.

Gerenciamento de conexões

Todas as conexões ativas aparecem em Painel > MemberPress > Configurações de IA > Clientes conectados ao MCP. A tabela lista as conexões OAuth (do assistente) e as sessões com senha de aplicativo em uma única visualização.

Cada linha apresenta as seguintes colunas:

• Nome do cliente;
• Proprietário;
• Nível de acesso;
• Conectado (a data e hora em que a conexão foi criada);
• Última utilização;
• Status;
• Ações (incluindo Revogar).

Um chip de autenticação registra como cada conexão foi autenticada — por exemplo, OAUTH para conexões do assistente ou SENHA DO APLICATIVO para sessões com senha de aplicativo.

Observação: Os escopos não podem ser editados em uma conexão existente. Para alterar as permissões de uma conexão, revogue-a e crie uma nova, conforme descrito acima.

Revogação de uma conexão

Para remover uma conexão do Claude Desktop:

1. Navegue até Painel > MemberPress > Configurações de IA > Clientes conectados ao MCP;
2. Localize a linha correspondente à conexão;
3. Clique em Revogar naquela linha;
4. Confirme a mensagem que diz: “Tem certeza de que deseja revogar este token? Essa ação não pode ser revertida.”.

Observação: A conexão deixa de funcionar imediatamente. O Claude Desktop não consegue se autenticar na próxima solicitação. Reconecte-se por meio do assistente e do painel “Conectores” para restaurar o acesso.

Aviso: Revogar um Senha do aplicativo A linha usa uma mensagem de confirmação diferente e exclui todos Senha do aplicativo WordPress desse usuário. Outras integrações REST executadas por esse usuário deixarão de funcionar. A mensagem de confirmação avisa sobre isso antes que a ação seja executada.

Uma observação sobre senhas de aplicativos

A WordPress Senha do aplicativo também é possível conectar um cliente MCP ao MemberPress. As conexões com senha de aplicativo são limitado ao acesso de leitura, regardless of the user’s WordPress capabilities. Write access requires the wizard and the OAuth flow described above.

Créditos de IA

AI Credits power MemberPress’s own AI features. Claude Desktop does not use them. Its AI usage is billed through the Claude account by Anthropic, and MCP tool calls from Claude Desktop do not consume AI Credits.

O Créditos de IA guia em Painel > MemberPress > Configurações de IA > Créditos de IA mostra o saldo atual e a opção de comprar mais. Use-o para recarregar créditos para os recursos de IA do MemberPress que dependem deles.

Para obter uma explicação completa sobre o sistema de Créditos de IA, consulte o Visão geral e guia de configuração do MemberPress AI Foundation.

Outros clientes de IA

O Claude Desktop é um dos vários clientes compatíveis com MCP que se conectam ao MemberPress. O procedimento é o mesmo para todos; apenas as etapas do lado do cliente diferem. O Assistente de configuração do MCP detalhes de conexão de navios para mais quatro clientes:

• Cursor;
• VS Code (por meio do GitHub Copilot);
• Windsurf;
• Claude Code (a CLI).

O Conectando clientes de IA ao MemberPress A referência para desenvolvedores aborda cada um deles, juntamente com todo o vocabulário de escopo e os fluxos de tokens OAuth e Bearer.

Resumo

Instale o AI Foundation a partir de MemberPress > Complementos, em seguida, defina o nível de acesso em Configurações do MCP. Execute o Assistente de configuração do MCP para copiar a URL do servidor, adicionar um conector personalizado no Claude Desktop e aprovar a autorização. A conexão aparece então em Clientes conectados ao MCP, which is also where to revoke it. To change a connection’s access level, disconnect, raise or lower the access level, reconnect, and revoke the old row.