Programadores
Servidor MCP da Mookee
Ligue o Claude ou outro assistente de IA à Mookee. Pode consultar os seus contactos e conversas, explicar os resultados das suas campanhas e configurar os seus espaços de trabalho, com exatamente o acesso que tem no painel. Pede a sua autorização antes de tudo o que envie mensagens, movimente dinheiro ou elimine.
URL do servidor
https://mcp.app.mookee.io/mcpAntes de ligar
- Uma conta Mookee que seja membro de pelo menos um espaço de trabalho. Inicia sessão como habitualmente (e-mail e palavra-passe, Google ou Apple), com autenticação multifator se o seu espaço a exigir.
- Qualquer plano Mookee, incluindo um espaço novo em modo sandbox. O assistente pode fazer o que a sua função e o seu plano permitem no painel.
- Um cliente de IA compatível com servidores MCP remotos e OAuth: Claude (web, computador e telemóvel), Claude Code, Cursor, ChatGPT e outros.
Ligar
Claude (claude.ai, computador e telemóvel)
- Abra Settings › Connectors e escolha Add custom connector. Quando a Mookee estiver no diretório de conectores, pode escolhê-la aí.
- Dê-lhe o nome Mookee e cole o URL do servidor. Deixe vazios os campos do cliente OAuth: o Claude regista-se sozinho.
- Escolha Connect. Abre-se uma página da Mookee: inicie sessão, verifique que aplicação está a pedir e escolha Permitir.
- Numa conversa, ative o conector Mookee no menu de ferramentas.
https://mcp.app.mookee.io/mcpNum plano Claude Team ou Enterprise, pode ser preciso que um proprietário adicione primeiro o conector para a organização.
Claude Code
- Execute o comando abaixo num terminal.
- No Claude Code, execute /mcp, escolha mookee e inicie sessão no navegador que se abre.
claude mcp add --transport http mookee https://mcp.app.mookee.io/mcpOutros clientes
- Adicione um servidor MCP remoto (Streamable HTTP) com o URL do servidor e sem cabeçalho Authorization.
- O cliente descobre o início de sessão na primeira resposta do servidor e abre a página da Mookee no seu navegador.
https://mcp.app.mookee.io/mcpO que pode fazer
Cerca de 165 ferramentas cobrem as áreas do painel. Cada uma chama a mesma API da Mookee que o painel usa, em seu nome.
- Espaços de trabalho
- Espaços, estado do onboarding, conta, domínio personalizado.
- Remetentes
- Números de telefone, ativação do WhatsApp, limites e estado.
- Audiência
- Contactos, etiquetas, segmentos, importações e exportações.
- Caixa de entrada
- Conversas, envio de uma mensagem, por responder, respostas sugeridas, chamadas, mensagens em espera.
- Campanhas
- Campanhas, modelos de mensagem, ficheiros multimédia, estimativa de custo e duração, agendamento, resultados.
- Páginas de subscrição
- Formulários de subscrição, árvores de canais e os seus funis.
- Agente de IA
- Definições do agente, prompt principal e as suas versões, base de conhecimento, automatizações, detetores, chat de teste.
- Estatísticas
- Estatísticas do painel, desempenho das campanhas, atribuição, pesquisa no espaço.
- Loja
- Produtos, escalões, lançamentos musicais, links de pagamento, encomendas e bilhetes.
- Definições
- Definições do espaço, equipa e funções, domínio de e-mail e aquecimento, webhooks, plano e créditos.
- Integrações
- Fontes de dados como Stripe, Tito ou Delight.
Algumas coisas ficam no painel de propósito: pagar, comprar números de telefone, segredos como chaves de API e credenciais de integrações, o registo do WhatsApp da Meta e o carregamento de áudio. O assistente avisa quando uma tarefa precisa de uma delas.
Exemplos de pedidos
- “Que campanhas do mês passado tiveram a melhor taxa de cliques e o que tinham em comum?”
- “Mostra-me as conversas que ainda esperam resposta e sugere uma resposta para cada uma.”
- “Quantos contactos com a etiqueta VIP consigo alcançar no WhatsApp? Cria um segmento com eles.”
- “Estima o custo e a duração de enviar um lembrete a todos os que têm bilhete para o concerto de sábado.”
- “Cria um formulário de subscrição para a newsletter do nosso festival, em português e inglês.”
- “Porque é que a minha última campanha parou antes de chegar a todos?”
Permissões e confirmações
- Cada chamada é executada em seu nome. Um espaço do qual não é membro, ou uma ação que a sua função ou o seu plano não permitem, é recusado exatamente como no painel.
- As ações que enviam mensagens a pessoas reais, movimentam dinheiro ou não podem ser desfeitas não alteram nada da primeira vez: a ferramenta responde com o que aconteceria e só atua quando o assistente a chama de novo depois de ter dito que sim. Isto abrange enviar uma mensagem, iniciar ou agendar uma campanha, reembolsar ou cancelar uma encomenda, e qualquer eliminação.
- As ferramentas só de leitura estão marcadas como tal, e cada ferramenta que elimina dados está marcada como destrutiva, para que o seu cliente lhe possa perguntar antes de a usar.
- Uma alteração feita pelo assistente é uma alteração feita por si, como guardar no painel. Se um colega tiver o mesmo elemento aberto, o assistente assume a edição e informa-o.
Dados e privacidade
- O servidor MCP não tem base de dados. Guarda apenas o que o início de sessão precisa, nos servidores da Mookee: o registo do seu cliente de IA (eliminado após 90 dias sem uso), os inícios de sessão pendentes (10 minutos) e os códigos de utilização única (5 minutos).
- Os tokens de acesso duram uma hora e os de atualização 30 dias, e nenhum sobrevive à sua sessão Mookee. Transportam essa sessão cifrada (AES-256-GCM); o servidor não guarda nenhuma cópia.
- O servidor nunca vê a sua conversa com o assistente. Recebe apenas os argumentos de cada chamada a uma ferramenta e não os regista. Os registos de pedidos (hora, caminho, estado e o seu id de utilizador quando uma chamada falha) são guardados durante 10 dias.
- O que consulta ou altera através do servidor são os seus dados Mookee, abrangidos pela política de privacidade da Mookee, e a Mookee regista as alterações como faz para o painel. O que o seu fornecedor de IA faz com os resultados das ferramentas rege-se pelas condições dele.
Desligar
- Remova ou desligue o conector Mookee no seu cliente de IA. Nada de novo pode ser emitido sem iniciar sessão outra vez, e o último token de acesso deixa de funcionar em menos de uma hora.
- Quando a sua sessão Mookee expira, todas as ligações que a usam param, e inicia sessão de novo para voltar a ligar.
- Para cortar uma ligação de imediato, escreva ao suporte: eliminamos o registo do cliente, o que revoga os seus tokens de atualização.
Resolução de problemas
- O cliente pede-me sempre para iniciar sessão
- A sua sessão Mookee expirou ou foi terminada. Volte a ligar e inicie sessão; o conector passa a funcionar com a nova sessão.
- Uma ferramenta diz que não tenho permissão
- A ação exige uma função ou um plano que não tem nesse espaço, exatamente como no painel. Um proprietário do espaço pode alterar a sua função nas definições.
- Não foi enviado nada
- As ferramentas de envio esperam pela sua concordância: a primeira chamada só descreve o que aconteceria. Diga que sim na conversa e o assistente chama-a de novo.
- O meu cliente limita o número de ferramentas
- Acrescente uma lista toolsets ao URL para servir só algumas áreas, por exemplo a de baixo. Áreas: workspace, senders, audience, inbox, campaigns, optin, agent, analytics, agent-advanced, calls, delayed, shop, settings, integrations.
- Outra coisa não está clara
- Peça ao assistente para ler o guia Mookee dessa área: explica os valores predefinidos, o que significa cada estado e as causas habituais de um problema. Ou contacte o suporte.
https://mcp.app.mookee.io/mcp?toolsets=only,audience,campaignsSuporte
Escreva-nos com o que pediu ao assistente e o que ele respondeu, ou use o chat de suporte do seu painel. Questões de privacidade: contact@mookee.io.