Perisclaw

공식

Claude, ChatGPT 및 기타 AI에서 내 WhatsApp을 사용하세요. 대화를 따라잡고, 채팅을 검색하고, 답장을 보내세요.

Perisclaw MCP(으)로 무엇을 할 수 있나요?

대화 따라잡기 — AI 클라이언트에 특정 그룹이나 대화에서 놓친 내용을 요약해 달라고 요청하세요.
메시지 및 연락처 검색 — 대화, 연락처, 그룹에서 누군가 지난달에 보낸 주소 같은 정보를 찾아보세요.
메시지에 답장하기 — 읽기 및 쓰기 권한이 있으면 클라이언트가 지정한 연락처에 답장을 보내도록 하세요.
라벨로 정리하기 — 읽기 및 쓰기 권한이 있으면 답변하지 않은 클라이언트 대화에 후속 조치를 위한 라벨을 지정하세요.
첨부 파일 처리하기 — 메시지에서 파일을 다운로드하거나(최대 10 MB), 수신자에게 파일을 보내세요(최대 25 MB).
접근 권한 제어하기 — 클라이언트별로 읽기 전용 또는 읽기 및 쓰기를 선택하고, 웹 앱에서 언제든지 연결을 해제하세요.

호스팅형 MCP 서버

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

Claude Code, Codex, Cursor 등에 설치됩니다

문서

ChatGPT, Codex, Claude, Cursor 및 기타 호환 AI 클라이언트에서 Perisclaw WhatsApp을 사용할 수 있습니다. “읽지 않은 채팅을 요약해 줘,” “Sarah에게 답장해 줘,” 또는 *“지난달에 Priya가 보낸 주소를 찾아 줘”*라고 요청하면 기존 어시스턴트를 통해 작업을 처리합니다.

ChatGPT, Codex, Claude에서 Perisclaw는 설치 가능한 플러그인입니다. 이 플러그인에는 Perisclaw의 MCP server로 구동되는 실시간 WhatsApp 커넥터와 클라이언트에 안전한 WhatsApp 워크플로를 알려 주는 스킬, 두 가지가 포함되어 있습니다. 다른 AI 클라이언트는 동일한 MCP server에 직접 연결할 수 있습니다.

이는 앱 연결의 반대입니다. 앱 연결에서는 Perisclaw가 다른 도구를 사용하고, 여기서는 다른 도구가 Perisclaw를 사용합니다.

ChatGPT 및 Codex

Perisclaw 플러그인은 ChatGPT의 Plugins 디렉터리에 등록되어 있습니다.

위 링크를 열거나 ChatGPT 사이드바에서 Plugins로 이동해 Perisclaw(Hashlabs Holdings Inc.)를 검색합니다.
Install plugin을 클릭합니다. ChatGPT에서 연결하라는 메시지가 표시되면 Perisclaw에 로그인하고 Read only 또는 Read & write를 선택합니다.
채팅에서 ＋ 메뉴를 열고 Perisclaw를 선택한 다음 *“오늘 답장해야 할 메시지가 뭐야?”*라고 물어봅니다.

Codex에서는 /plugins을 실행하고 Perisclaw를 연 다음 Install plugin을 클릭하고 새 스레드를 시작합니다. Perisclaw 웹 앱의 MCP 페이지에서 MCP 주소를 ~/.codex/config.toml에 추가할 수도 있습니다.

Claude

Claude 디렉터리에서 Perisclaw 플러그인을 추가하고 Perisclaw 계정을 연결한 다음 Read only 또는 Read & write 액세스를 선택합니다. 웹, 데스크톱, 모바일의 Claude와 Cowork, Claude Code에서 사용할 수 있습니다. 이 플러그인은 Anthropic의 검토를 받고 있으며, 승인되면 디렉터리에 표시됩니다. 플러그인 소스는 periskope-org/perisclaw-plugin에서 공개되어 있습니다.

그때까지는 Perisclaw를 사용자 지정 커넥터로 추가하세요. Claude에서 Customize → Connectors를 연 다음 Add → Add custom connector를 선택합니다. 이름을 Perisclaw로 지정하고, MCP 페이지에서 MCP 주소를 복사해 MCP server URL에 붙여 넣은 다음 Continue를 클릭합니다. 이어서 로그인하고 액세스 수준을 선택합니다.

기타 MCP 클라이언트

Claude Desktop 및 Claude.ai와 같은 클라이언트는 원클릭 커넥터를 지원합니다.

1
Perisclaw 커넥터 추가
AI 클라이언트에서 새 커넥터 또는 MCP server를 추가하고 웹 앱의 MCP 페이지에 있는 Perisclaw MCP 주소를 붙여 넣습니다. 클라이언트에 Perisclaw가 새 연결로 표시됩니다.
2
로그인
클라이언트가 브라우저에서 Perisclaw 로그인 페이지를 엽니다. 이미 웹 앱에 로그인되어 있으므로 동의 화면만 표시됩니다. Perisclaw를 처음 사용하시나요? 같은 창에서 계정을 만들고 WhatsApp을 연결하세요. 동의 화면에는 액세스를 요청하는 클라이언트가 표시됩니다.
3
허용할 작업 선택
액세스 수준인 Read only 또는 Read & write를 선택한 다음 승인합니다. 이제 클라이언트에서 WhatsApp 도구를 사용할 수 있습니다.

적절한 액세스 수준 선택

액세스 수준	클라이언트에서 할 수 있는 작업
Read only	채팅, 연락처, 그룹, Automations를 검색하고 읽습니다. 메시지를 보내거나 내용을 변경할 수 없습니다. 안전한 기본 설정입니다.
Read & write	Read only의 모든 기능에 더해 메시지 전송, 반응 추가, 채팅, 그룹, 라벨, 연락처 관리가 가능합니다.

AI 클라이언트에서 할 수 있는 작업

따라잡기: “오늘 업무 그룹에서 놓친 내용을 모두 요약해 줘.”
검색: “지난달에 Priya가 보낸 주소를 찾아 줘.”
답장(Read & write 사용 시): “Sarah에게 화요일 3시가 괜찮다고 답장해 줘.”
정리(Read & write 사용 시): “답변하지 않은 고객 채팅에 모두 ‘후속 조치’ 라벨을 붙여 줘.”

플러그인에 포함된 스킬은 작업 전에 수신자를 확인하고, 메시지 내용을 지시가 아닌 데이터로 취급하며, 메시지를 보내거나 파괴적인 변경을 하기 전에 확인을 요청합니다. Claude Code나 Cursor와 같은 독립형 코딩 클라이언트에서는 일반 MCP 연결에 동일한 공개 Perisclaw 워크플로 스킬을 추가할 수 있습니다.

첨부 파일

*“그 청구서에 있는 PDF를 다운로드해 줘”*처럼 메시지에 첨부된 파일을 요청하세요. 최대 10 MB 파일은 AI 클라이언트로 바로 전송됩니다.

파일을 보내려면 *“report.pdf를 Priya에게 보내 줘”*처럼 요청하세요. 파일 크기는 최대 25 MB까지 가능합니다. Claude Code, Codex, Cursor처럼 컴퓨터에서 실행되는 클라이언트는 파일을 대신 업로드합니다. ChatGPT에서는 메시지에 파일을 첨부하세요. 모든 클라이언트에서 공개 링크의 파일도 보낼 수 있습니다.

제어 권한 유지

본인에게만 범위가 한정됩니다: 연결은 본인의 WhatsApp에만 접근하며 다른 사람의 WhatsApp에는 접근할 수 없습니다.
전송은 계속 제한됩니다: AI 클라이언트에서 보내는 메시지에도 다른 모든 작업과 동일한 권한 확인이 적용됩니다.
모든 권한 부여 내역 확인: 웹 앱에는 연결된 각 클라이언트가 Read only인지 Read & write인지 표시되며, 두 수준 모두에서 활성 세션이 남아 있는 클라이언트도 표시됩니다.
언제든지 권한 취소: 웹 앱에서 연결을 삭제하면 클라이언트는 즉시 액세스 권한을 잃습니다.
로그인 상태 유지: 연결된 클라이언트는 사용하는 동안 로그인 상태를 유지합니다. Cursor에서는 30일마다 다시 로그인해야 합니다.

어시스턴트가 접근할 수 있는 항목과 접근할 수 없는 항목에 대한 자세한 내용은 개인정보 보호 및 보안과 권한 및 액세스을 참조하세요.

[Perisclaw에 앱 연결하기

반대 방향으로, WhatsApp에서 Perisclaw가 다른 도구를 사용하도록 합니다.

](https://docs.perisclaw.com/connecting-apps)[**모든 권한 부여 내역 검토**

연결된 각 클라이언트가 할 수 있는 작업을 확인하고 권한을 취소합니다.

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