OK Agent

팝빌 MCP 서버 — 전자세금계산서 발행·알림톡 AI 자동화

팝빌 API를 MCP로 연결해, AI 에이전트가 전자세금계산서 발행·취소·검색, 홈택스 매출·매입 수집, 카카오 알림톡 발송을 할 수 있게 해 주는 무료 오픈소스 서버입니다.

@appmonster/mcp-popbill무료 · MIT 오픈소스GitHub →

무엇을 할 수 있나

도구하는 일
popbill_check_account팝빌 연동·계정 상태 확인
popbill_issue_taxinvoice전자세금계산서 즉시 발행결재 필요
popbill_cancel_taxinvoice발행 취소결재 필요
popbill_get_taxinvoice세금계산서 상세
popbill_search_taxinvoices기간별 검색
popbill_hometax_request홈택스 매출·매입 수집 요청
popbill_hometax_results홈택스 수집 결과
popbill_list_alimtalk_templates알림톡 템플릿 목록
popbill_send_alimtalk카카오 알림톡 발송결재 필요
popbill_get_alimtalk_result알림톡 전송 결과

설치 (1분)

Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.

Claude Desktop · Cursor · Windsurf

MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.

{
  "mcpServers": {
    "popbill": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "…",
        "POPBILL_SECRET_KEY": "…",
        "POPBILL_CORP_NUM": "…"
      }
    }
  }
}

Claude Code

claude mcp add popbill -e POPBILL_LINK_ID=… -e POPBILL_SECRET_KEY=… -e POPBILL_CORP_NUM=… -- npx -y @appmonster/mcp-popbill

필요한 키와 발급처

필수
POPBILL_LINK_ID — 팝빌 연동 아이디
필수
POPBILL_SECRET_KEY — 팝빌 비밀키
필수
POPBILL_CORP_NUM — 사업자등록번호(하이픈 없이)
선택
POPBILL_USER_ID — 팝빌 회원 아이디
선택
POPBILL_TEST — true면 테스트베드(기본 권장)

발급: 팝빌 개발자센터. 연동 신청으로 LinkID와 비밀키를 받습니다. 세금계산서 발행에는 팝빌에 공동인증서 등록이, 알림톡에는 카카오 채널 연결과 템플릿 승인이 필요합니다.

이렇게 시켜 보세요

쓰기 작업은 사람이 결재합니다

전자세금계산서 즉시 발행, 발행 취소, 카카오 알림톡 발송은(는) 되돌리기 어려운 작업이라 바로 실행되지 않습니다. 기본으로는 바뀔 내용을 먼저 보여주고 대화창에서 확인을 받습니다. 설정에 OKAGENT_API_KEY를 넣으면 승인 요청이 휴대폰 카카오톡으로 와서, 자리를 비워도 탭 한 번으로 승인하거나 거부할 수 있고 기록도 남습니다.

카카오로 무료 시작OK Agent 알아보기월 200건 무료 · 카드 등록 없음

자주 묻는 질문

세금계산서를 AI가 바로 발행하나요?

발행은 국세청으로 바로 전송되는 작업이라 쓰기 도구로 분류됩니다. 공급가·거래처를 먼저 보여주고 확인을 받으며, OK Agent를 연결하면 카카오톡 승인 후에만 발행됩니다.

테스트로 먼저 발행해 볼 수 있나요?

POPBILL_TEST=true(테스트베드)로 시작하면 실제 국세청 전송 없이 시험할 수 있습니다.

팝빌 요금은요?

서버는 무료입니다. 세금계산서·알림톡 건당 요금은 팝빌 요금제를 따릅니다.

함께 쓰면 좋은 서버