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/mcp

Antes 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)

  1. Abra Settings › Connectors e escolha Add custom connector. Quando a Mookee estiver no diretório de conectores, pode escolhê-la aí.
  2. Dê-lhe o nome Mookee e cole o URL do servidor. Deixe vazios os campos do cliente OAuth: o Claude regista-se sozinho.
  3. Escolha Connect. Abre-se uma página da Mookee: inicie sessão, verifique que aplicação está a pedir e escolha Permitir.
  4. Numa conversa, ative o conector Mookee no menu de ferramentas.
https://mcp.app.mookee.io/mcp

Num plano Claude Team ou Enterprise, pode ser preciso que um proprietário adicione primeiro o conector para a organização.

Claude Code

  1. Execute o comando abaixo num terminal.
  2. 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/mcp

Outros clientes

  1. Adicione um servidor MCP remoto (Streamable HTTP) com o URL do servidor e sem cabeçalho Authorization.
  2. 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/mcp

O 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.

Ler a política de privacidade

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.
https://mcp.app.mookee.io/mcp?toolsets=only,audience,campaigns
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.

Suporte

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.