AI 에이전트

푸시 알림 받기: 에이전트 작업이 끝나면.

장시간 실행되는 LLM 에이전트를 계속 지켜볼 필요는 없어야 해요. 작업이 끝나거나, 승인을 기다리며 멈추거나, 실패하면 휴대폰이 울려요. 그러니 자리를 떠나도 알림이 꼭 올 거라고 믿으셔도 돼요.

<1초 내 푸시 전달MCP 도구 또는 RESTClaude Code · LangChain · cron 업데이트
기능

자리를 비운 채 실행되는 에이전트를 위해 만들었어요

경로는 둘이지만 결과는 같아요. 에이전트가 MCP 도구를 호출하거나 POST 요청을 한 번 보내면, 휴대폰이 울려요.

MCP 서버 기본 제공

Claude Code, Claude Desktop, Cursor 같은 MCP 클라이언트가 create_message 도구를 호출해 푸시 알림을 보내요.

일반 HTTP 대안

MCP 클라이언트가 없나요? 인증된 POST 요청을 messages API로 한 번 보내면, 어떤 에이전트나 스크립트에서든 같은 일을 할 수 있어요.

Stop 훅 지원

Stop 훅에서 알림을 보내 에이전트가 끝나는 순간 바로 전달되도록 하세요. 확인할 시점을 기억할 필요가 없어요.

메시지에 상태 포함

메시지에 에이전트 상태와 결과 텍스트를 함께 담아 보내세요. "승인 필요" 같은 내용이 한눈에 들어와요.

에이전트별 채널

에이전트나 프로젝트마다 별도의 애플리케이션을 두면 리팩터링 봇과 크론 작업의 알림이 각자의 채널로 나뉘어요.

1초 이내 전달

푸시 알림은 1초 안에 도착해요. 오래 걸리던 작업이 끝나거나 입력을 기다리며 멈추면 즉시 알 수 있어요.

시작하기

에이전트 알림을 손 없이 받는 3단계

1

MCP 또는 HTTP 선택

API 키를 만들거나, 코드 없이 쓰려면 클라이언트에 Pocket Alert MCP 서버를 추가하세요.

2

완료 시 전송

create_message를 호출하거나, LangChain 콜백이나 에이전트 도구에서 title과 message를 POST 하세요.

3

자리 비우기

실패와 승인 요청은 에이전트별 애플리케이션으로 나눠 받으세요. 이제 에이전트가 일하는 동안 자리를 떠나도 괜찮아요.

에이전트를 휴대폰에 연결하기

1. API 키 발급받기

API Keys 페이지에서 키를 만드세요. 에이전트는 이 키를 Token 헤더에 담아 보내요.

2. LangChain 콜백에서 POST 보내기 (Python)

import requests
from langchain.callbacks.base import BaseCallbackHandler

class PocketAlert(BaseCallbackHandler):
    def on_agent_finish(self, finish, **kwargs):
        requests.post(
            "https://api.pocketalert.app/v1/messages",
            headers={"Token": "YOUR_API_KEY"},
            json={"title": "Agent finished", "message": finish.return_values["output"][:200]},
        )

agent.invoke({"input": task}, config={"callbacks": [PocketAlert()]})

3. 에이전트가 호출하는 OpenAI 도구로 만들기 (Node)

async function notifyHuman({ title, message }) {
  await fetch("https://api.pocketalert.app/v1/messages", {
    method: "POST",
    headers: { Token: "YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({ title, message, level: "high" }),
  });
}

notifyHuman을 함수나 도구로 등록하면, 에이전트가 승인이 필요하거나 오류가 났을 때 이 함수를 호출해요.

4. 코드 없이 MCP 사용하기

create_message 도구를 호출하도록 하세요. 직접 작성할 코드는 없어요.

문서에서 대상 설정, 애플리케이션, 나머지 MCP 도구를 자세히 확인할 수 있어요.

FAQ

궁금한 점을 답해드려요

두 가지 방법이 있어요. Claude Code, Claude Desktop, Cursor 같은 MCP 클라이언트에서는 create_message 도구를 호출하면 푸시 알림이 휴대폰으로 바로 도착해요. 그 밖의 환경에서는 messages API에 HTTP POST 요청을 한 번 보내면 돼요. 보통 작업이 끝날 때 실행되는 Stop 훅을 트리거로 씁니다.

클라이언트에 Pocket Alert MCP 서버를 추가하고, title과 message를 담아 create_message를 호출하세요. 코드도 curl도 필요 없어요. 에이전트가 파일이나 스크린샷을 보내야 한다면 create_message_with_attachment도 쓸 수 있어요.

에이전트마다 별도의 애플리케이션을 만드세요. 그러면 리팩터링 봇의 "승인 필요" 알림과 야간 파이프라인의 "작업 완료" 알림이 서로 다른 채널로 도착해요. 승인 요청이나 실패 내용이 한눈에 들어오도록 제목을 작성하세요.

에이전트나 프로젝트마다 별도의 애플리케이션을 만드세요. 리팩터링 봇과 야간 데이터 파이프라인의 알림이 각각 다른 채널로 도착하므로, 본문을 읽지 않아도 어떤 작업이 보낸 알림인지 알 수 있어요.

전달은 1초 안에 이뤄져요. 코딩 에이전트가 15분 동안 작업하는 사이 커피를 마시러 자리를 비웠다면, 자리에 돌아오기 전에 알림이 도착해 있을 거예요.

메시지마다 중요도를 함께 보내세요. 일상적인 "작업 완료" 알림은 무음(소리와 진동 없음, 기록에는 남음)으로 보내고, 실패나 승인 요청은 높음으로 보내면 시간에 민감한 푸시로 도착해 iPhone 집중 모드도 뚫고 들어와요. MCP create_message 도구도 같은 level 필드를 받으니, 에이전트가 메시지마다 알림 강도를 정할 수 있어요.

에이전트가 끝나면 휴대폰으로 알려 주세요.

API 키를 만들어 Stop 훅이나 MCP 도구에 연결하고, 자리에서 편하게 벗어나세요.