Perisclaw

oficial

Use seu próprio WhatsApp pelo Claude, ChatGPT e outras IAs: fique por dentro, pesquise conversas e envie respostas.

O que você pode fazer com Perisclaw MCP?

  • Fique por dentro das conversas — Peça ao seu cliente de IA para resumir o que você perdeu em grupos específicos ou conversas não lidas.
  • Pesquise mensagens e contatos — Encontre informações como um endereço ou arquivo enviado por alguém em suas conversas, contatos e grupos.
  • Responda e reaja — Com acesso de leitura e gravação, envie respostas e reações a contatos ou grupos pelo seu cliente de IA.
  • Organize conversas — Aplique etiquetas e gerencie conversas, grupos e contatos quando a conexão tiver acesso de leitura e gravação.
  • Gerencie anexos — Baixe arquivos de até 10 MB das mensagens ou envie arquivos de até 25 MB para um destinatário.
  • Controle o acesso — Escolha entre acesso somente para leitura ou de leitura e gravação para cada cliente e revogue qualquer conexão pelo aplicativo web.

Servidor MCP hospedado

npx add-mcp 'https://api.perisclaw.com/mcp/plugin'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Você pode usar seu WhatsApp do Perisclaw pelo ChatGPT, Codex, Claude, Cursor e outros clientes de IA compatíveis. Peça para ele “resumir minhas conversas não lidas”, “responder à Sarah” ou “encontrar o endereço que Priya enviou no mês passado”, e ele fará isso usando seu assistente atual.

No ChatGPT, Codex e Claude, o Perisclaw é um plugin instalável. O plugin reúne duas partes: o conector de WhatsApp em tempo real do Perisclaw, fornecido pelo seu servidor MCP, e uma skill que ensina ao cliente fluxos de trabalho seguros para o WhatsApp. Outros clientes de IA podem se conectar diretamente ao mesmo servidor MCP.

Esta é a imagem espelhada de conectar aplicativos: nesse caso, o Perisclaw usa suas outras ferramentas; aqui, suas outras ferramentas usam o Perisclaw.

ChatGPT e Codex

Instale o plugin Perisclaw no diretório de plugins, conecte sua conta do Perisclaw e escolha o acesso Somente leitura ou Leitura e gravação. A listagem pública será exibida depois que a OpenAI aprová-la.

Durante a prévia para desenvolvedores, ative o modo de desenvolvedor e adicione a URL de produção do MCP exibida na página MCP do aplicativo web do Perisclaw. Essa conexão de prévia usa a mesma tela de consentimento e as mesmas ferramentas do WhatsApp que o plugin.

Claude

Adicione o plugin Perisclaw pelo diretório do Claude, conecte sua conta do Perisclaw e escolha o acesso Somente leitura ou Leitura e gravação. Ele funciona no Claude na web, no desktop e em dispositivos móveis, no Cowork e no Claude Code. A listagem pública será exibida depois que a Anthropic aprová-la. O código-fonte do plugin é público em periskope-org/perisclaw-plugin.

Até lá, adicione o Perisclaw como um conector personalizado, conforme descrito abaixo.

Outros clientes MCP

Clientes como Claude Desktop e Claude.ai oferecem suporte a conectores de um clique:

  1. 1

    Adicione o conector do Perisclaw

    No seu cliente de IA, adicione um novo conector ou servidor MCP e cole o endereço MCP do Perisclaw exibido na página MCP do aplicativo web. O cliente exibirá o Perisclaw como uma nova conexão.
  2. 2

    Faça login

    O cliente abrirá uma página de login do Perisclaw no seu navegador. Como você já está conectado ao aplicativo web, verá apenas uma tela de consentimento. Ainda não conhece o Perisclaw? Crie sua conta e conecte seu WhatsApp nessa mesma janela. A tela de consentimento identifica o cliente que está solicitando acesso.
  3. 3

    Escolha o que ele pode fazer

    Escolha um nível de acesso, Somente leitura ou Leitura e gravação, e aprove. O cliente agora pode usar suas ferramentas do WhatsApp.

Escolha o nível de acesso adequado

Nível de acessoO que o cliente pode fazer
Somente leituraPesquisar e ler suas conversas, contatos, grupos e automações. Não pode enviar nem alterar nada. A opção segura padrão.
Leitura e gravaçãoTudo o que está incluído em Somente leitura, além de enviar mensagens, reagir e gerenciar conversas, grupos, etiquetas e contatos.

O que você pode fazer pelo seu cliente de IA

  • Ficar por dentro: “Resuma tudo o que perdi hoje nos meus grupos de trabalho.”
  • Pesquisar: “Encontre o endereço que Priya me enviou no mês passado.”
  • Responder (com Leitura e gravação): “Responda à Sarah que terça-feira às 15h funciona.”
  • Organizar (com Leitura e gravação): “Adicione a etiqueta ‘retornar’ a todas as conversas de clientes sem resposta.”

A skill incluída no plugin identifica os destinatários antes de agir, trata o conteúdo das mensagens como dados, não como instruções, e pede confirmação antes de enviar mensagens ou fazer alterações destrutivas. Clientes de programação independentes, como Claude Code ou Cursor, podem combinar o mesmo fluxo de trabalho aberto do Perisclaw com uma conexão MCP simples.

Anexos

Peça um arquivo de uma mensagem, por exemplo: “baixe o PDF daquela fatura.” Arquivos de até 10 MB são enviados diretamente ao seu cliente de IA.

Para enviar um arquivo, peça, por exemplo: “envie report.pdf para Priya.” Os arquivos podem ter até 25 MB. Clientes executados no seu computador, como Claude Code, Codex e Cursor, carregam o arquivo para você. No ChatGPT, anexe o arquivo à sua mensagem. Qualquer cliente também pode enviar um arquivo por meio de um link público.

Mantenha o controle

  • Acesso restrito a você: uma conexão só acessa o seu próprio WhatsApp; ela não pode acessar o WhatsApp de mais ninguém.
  • O envio continua sujeito a controles: as mensagens enviadas por um cliente de IA passam pelas mesmas verificações de permissão que todo o resto.
  • Veja todas as concessões: o aplicativo web identifica cada cliente conectado como Somente leitura ou Leitura e gravação e sinaliza os clientes que ainda têm sessões ativas nos dois níveis.
  • Revogue quando quiser: remova uma conexão do aplicativo web e o cliente perderá o acesso imediatamente.
  • Permanece conectado: um cliente conectado continua conectado enquanto você o usa. O Cursor pede que você faça login novamente a cada 30 dias.

Para entender melhor o que seu assistente pode ou não acessar, consulte Privacidade e segurança e Permissões e acesso.

[Conecte aplicativos ao Perisclaw

A imagem espelhada: permita que o Perisclaw use suas outras ferramentas pelo WhatsApp.

](https://docs.perisclaw.com/connecting-apps)[**Revise todas as concessões**

Veja e revogue o que cada cliente conectado pode fazer.

](https://docs.perisclaw.com/permissions-and-access)