Popbill (세금계산서·알림톡)

Name: Popbill (세금계산서·알림톡)
Author: groove79

제작자: groove79버전 0.2.0i★ 0i내 컴퓨터에서 실행

레지스트리 이름io.github.groove79/mcp-popbill

설치 방법

What it does

Popbill MCP: Korean e-tax invoices (issue/cancel/search, Hometax sync) + KakaoTalk 알림톡. 팝빌 MCP.

Connects 내 컴퓨터에서 실행
Account or key Needs POPBILL_SECRET_KEY, OKAGENT_API_KEY · 2 settings to fill in (POPBILL_LINK_ID, POPBILL_CORP_NUM)
Category 회계, 재무 및 세금

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 14일

먼저: 어떤 AI를 쓰시나요?

Claude웹 · 앱 · 모바일ChatGPT웹Claude Code터미널Cursor코드 에디터VS Code코드 에디터기타다른 앱

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있지만 먼저 준비가 필요해요

Popbill (세금계산서·알림톡) 키가 필요해요 (제작자 사이트에서 만들기) · 설정 2개 입력 필요 (POPBILL_LINK_ID, POPBILL_CORP_NUM) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

Node.js 설치
한 번만 하면 Node.js가 필요한 모든 서버에 쓸 수 있어요
Node.js 다운로드 페이지 열기 ↗
완료
Popbill (세금계산서·알림톡)에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
Popbill (세금계산서·알림톡) 사이트 열기 ↗
완료
3
설정 2개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- POPBILL_LINK_ID Popbill API link id (developers.popbill.com)
- POPBILL_CORP_NUM Member business number (10 digits)
설명은 아직 영어 원문입니다.
완료
컴퓨터용 Claude 앱 설정 파일 열기
SettingsDeveloperEdit Config
완료

이 설정을 붙여 넣고 저장

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

키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요

완료

Claude를 끄고 다시 열기
완료
해 보기
Popbill (세금계산서·알림톡)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ Claude가 Popbill (세금계산서·알림톡)을 쓰고 있다고 하거나 답에 Popbill (세금계산서·알림톡) 도구 이름이 나오면 연결된 거예요

추가 설정 3개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

POPBILL_USER_ID Popbill member user id
POPBILL_TEST true = test server (default true)
KMCP_WRITE_MODE approval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT는 아직 Popbill (세금계산서·알림톡)에 연결할 수 없어요

Popbill (세금계산서·알림톡)는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요

대신 이렇게 할 수 있어요

A · Popbill (세금계산서·알림톡)에 연결되는 앱 쓰기

Claude 단계 보기 →Popbill (세금계산서·알림톡) 키가 필요해요 (제작자 사이트에서 만들기) · 설정 2개 입력 필요 (POPBILL_LINK_ID, POPBILL_CORP_NUM) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
Claude Code 단계 보기 →Popbill (세금계산서·알림톡) 키가 필요해요 (제작자 사이트에서 만들기) · 설정 2개 입력 필요 (POPBILL_LINK_ID, POPBILL_CORP_NUM) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
Cursor 단계 보기 →Popbill (세금계산서·알림톡) 키가 필요해요 (제작자 사이트에서 만들기) · 설정 2개 입력 필요 (POPBILL_LINK_ID, POPBILL_CORP_NUM) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
VS Code 단계 보기 →Popbill (세금계산서·알림톡) 키가 필요해요 (제작자 사이트에서 만들기) · 설정 2개 입력 필요 (POPBILL_LINK_ID, POPBILL_CORP_NUM) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)

B · 회계, 재무 및 세금에서 ChatGPT에 연결되는 다른 서버

같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요

Finance Toolkit✓ ChatGPT
SolidInvoice✓ ChatGPT
Finlab AI✓ ChatGPT

Claude Code에 연결할 수 있지만 먼저 준비가 필요해요

Popbill (세금계산서·알림톡) 키가 필요해요 (제작자 사이트에서 만들기) · 설정 2개 입력 필요 (POPBILL_LINK_ID, POPBILL_CORP_NUM) · 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)

Node.js 설치
한 번만 하면 Node.js가 필요한 모든 서버에 쓸 수 있어요
Node.js 다운로드 페이지 열기 ↗
완료
Popbill (세금계산서·알림톡)에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
Popbill (세금계산서·알림톡) 사이트 열기 ↗
완료
3
설정 2개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- POPBILL_LINK_ID Popbill API link id (developers.popbill.com)
- POPBILL_CORP_NUM Member business number (10 digits)
설명은 아직 영어 원문입니다.
완료
터미널 열기
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
완료
5
이 명령을 붙여 넣고 Enter
```
claude mcp add --scope user popbill --env POPBILL_LINK_ID=your-value --env POPBILL_SECRET_KEY=your-value --env POPBILL_CORP_NUM=your-value --env OKAGENT_API_KEY=your-value -- npx -y @appmonster/mcp-popbill
```
Enter 전에 “your-value”를 내 키로 바꾸세요
키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요
완료
Claude Code에서 /mcp 입력
Popbill (세금계산서·알림톡)이 목록에 있고 연결됨으로 보이면 돼요
완료
해 보기
Popbill (세금계산서·알림톡)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ Claude Code가 Popbill (세금계산서·알림톡)을 쓰고 있다고 하거나 답에 Popbill (세금계산서·알림톡) 도구 이름이 나오면 연결된 거예요

추가 설정 3개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

POPBILL_USER_ID Popbill member user id
POPBILL_TEST true = test server (default true)
KMCP_WRITE_MODE approval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Cursor에 연결할 수 있지만 먼저 준비가 필요해요

Node.js 설치
한 번만 하면 Node.js가 필요한 모든 서버에 쓸 수 있어요
Node.js 다운로드 페이지 열기 ↗
완료
Popbill (세금계산서·알림톡)에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
Popbill (세금계산서·알림톡) 사이트 열기 ↗
완료
3
설정 2개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- POPBILL_LINK_ID Popbill API link id (developers.popbill.com)
- POPBILL_CORP_NUM Member business number (10 digits)
설명은 아직 영어 원문입니다.
완료
이 버튼으로 Cursor 열기
Cursor에서 열기
Cursor가 설치를 확인하면 Install을 누르세요
완료
키 입력
Popbill (세금계산서·알림톡) 설정에서 POPBILL_SECRET_KEY, OKAGENT_API_KEY, POPBILL_LINK_ID, POPBILL_CORP_NUM가 비어 있어요. 내 키를 넣고 저장하세요
키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요
완료
Cursor에서 AI 채팅을 Agent 모드로 열기
완료
해 보기
Popbill (세금계산서·알림톡)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ Cursor가 Popbill (세금계산서·알림톡)을 쓰고 있다고 하거나 답에 Popbill (세금계산서·알림톡) 도구 이름이 나오면 연결된 거예요

추가 설정 3개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

POPBILL_USER_ID Popbill member user id
POPBILL_TEST true = test server (default true)
KMCP_WRITE_MODE approval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

VS Code에 연결할 수 있지만 먼저 준비가 필요해요

Node.js 설치
한 번만 하면 Node.js가 필요한 모든 서버에 쓸 수 있어요
Node.js 다운로드 페이지 열기 ↗
완료
Popbill (세금계산서·알림톡)에 가입하고 키 만들기
제작자 사이트에서 가입하고 다음 단계에 쓸 API 키를 만드세요. 요금과 무료 요금제는 제작자 사이트에서 확인하세요.
Popbill (세금계산서·알림톡) 사이트 열기 ↗
완료
3
설정 2개 입력
이것은 프로그램 설정이며 키가 아닙니다. 가입할 필요 없이 제작자 설명대로 입력하세요.
- POPBILL_LINK_ID Popbill API link id (developers.popbill.com)
- POPBILL_CORP_NUM Member business number (10 digits)
설명은 아직 영어 원문입니다.
완료
이 버튼으로 VS Code 열기
VS Code에서 열기
VS Code가 설치를 확인하면 Install을 누르세요
완료
키 입력
Popbill (세금계산서·알림톡) 설정에서 POPBILL_SECRET_KEY, OKAGENT_API_KEY, POPBILL_LINK_ID, POPBILL_CORP_NUM가 비어 있어요. 내 키를 넣고 저장하세요
키는 앱 입력란에만 붙여 넣고, 채팅에 붙이거나 다른 사람에게 보내지 마세요
완료
VS Code에서 AI 채팅을 Agent 모드로 열기
완료
해 보기
Popbill (세금계산서·알림톡)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐
✓ VS Code가 Popbill (세금계산서·알림톡)을 쓰고 있다고 하거나 답에 Popbill (세금계산서·알림톡) 도구 이름이 나오면 연결된 거예요

추가 설정 3개 (입력하지 않아도 사용 가능)

위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.

POPBILL_USER_ID Popbill member user id
POPBILL_TEST true = test server (default true)
KMCP_WRITE_MODE approval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

설명은 아직 영어 원문입니다.

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Popbill (세금계산서·알림톡)을 쓰는 사람에게 물어보세요💬 토론 →

개발자용: 터미널 명령과 JSON 설정

컴퓨터에 설치

Claude Code

claude mcp add --scope user popbill --env POPBILL_LINK_ID=your-value --env POPBILL_SECRET_KEY=your-value --env POPBILL_CORP_NUM=your-value --env OKAGENT_API_KEY=your-value -- npx -y @appmonster/mcp-popbill

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "popbill": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "your-value",
        "POPBILL_SECRET_KEY": "your-value",
        "POPBILL_CORP_NUM": "your-value",
        "OKAGENT_API_KEY": "your-value"
      }
    }
  }
}

직접 입력할 값

POPBILL_LINK_ID 필수 env
Popbill API link id (developers.popbill.com)
POPBILL_SECRET_KEY 비밀 필수 env
Popbill API secret key
POPBILL_CORP_NUM 필수 env
Member business number (10 digits)
POPBILL_USER_ID env
Popbill member user id
POPBILL_TEST env
true = test server (default true)
OKAGENT_API_KEY 비밀 필수 env
OK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.
KMCP_WRITE_MODE env
approval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

설명은 아직 영어 원문입니다.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

한눈에 보기

GitHub 스타 i: 0
주간 다운로드i: 63/주
라이선스 i: MIT
연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
최신 버전i: 0.2.0
카테고리i: 회계, 재무 및 세금
레지스트리 공개i: 2026년 10월 23일
코드 마지막 변경i: 2026년 11월 13일
제작자: groove79
패키지: npm: @appmonster/mcp-popbill
저장소: groove79/kmcp
웹사이트: appmonster.co.kr
레지스트리 상태: 활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

내 컴퓨터에서 실행하는 앱

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

모든 앱과 장단점 →

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 14일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 groove79 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
✓ 통과
계속 관리되고 있음
코드 마지막 변경: 어제
✓ 통과
라이선스 있음
MIT 사용
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

Google로 로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

Google로 로그인하고 리뷰 쓰기

회계, 재무 및 세금 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 3213개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 3213개 중 58%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 3213개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Popbill (세금계산서·알림톡), 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: POPBILL_SECRET_KEY, OKAGENT_API_KEY

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 어제 변경됐고, 최신 버전(0.2.0)은 22일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: CCXT, Finance Toolkit, AKQuant

같은 카테고리의 다른 것

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

CCXT

Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets

제작자: ccxt널리 사용됨↓ 667/주★ 4.5만 저장소 전체의 별2개월 전 업데이트

내 컴퓨터에서 실행

설치

Finance Toolkit

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

제작자: JerBouma널리 사용됨↓ 1.6만/주★ 5.5천5일 전 업데이트

컴퓨터 또는 클라우드

설치

AKQuant

Write and backtest trading strategies with AKQuant: API lookup, strategy checks, backtest runs

제작자: akfamily널리 사용됨↓ 3.3천/주★ 2.6천어제 업데이트

내 컴퓨터에서 실행

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

@appmonster/mcp-popbill

MCP server for Popbill (팝빌) — the Korean e-document platform that fronts Hometax. One server gives an agent:

전자세금계산서: search, read, issue (saved + issued + reported to the NTS in one call), cancel
홈택스 수집: pull sales/purchase invoices issued anywhere (not only via Popbill) for bookkeeping and VAT prep
카카오 알림톡: official KakaoTalk business notifications with approved templates (SMS fallback)

All writes cost Popbill points and/or reach the 국세청 or real phones, so every write tool runs through the human approval hook (OK Agent) when configured.

Tools

Tool	Access	What it does
`popbill_check_account`	read	회원 여부·포인트 잔액
`popbill_search_taxinvoices`	read	매출/매입 세금계산서 검색 (기간·상태·텍스트)
`popbill_get_taxinvoice`	read	세금계산서 상세 + 보기 URL
`popbill_issue_taxinvoice`	write	정발행 즉시발행 — 품목에서 공급가액·세액·합계 자동 계산
`popbill_cancel_taxinvoice`	write	발행취소 (국세청 전송 전)
`popbill_hometax_request`	read	홈택스 수집 작업 요청 → jobId (팝빌 홈택스수집 정액제 별도 신청 필요 — 테스트 연동키에도 기본 미포함)
`popbill_hometax_results`	read	수집 상태/결과 (collecting · done · failed)
`popbill_list_alimtalk_templates`	read	승인 템플릿 목록 (변수 확인용)
`popbill_send_alimtalk`	write	알림톡 발송 (≤1,000명, SMS 대체 발송)
`popbill_get_alimtalk_result`	read	발송 결과 (수신자별)

Setup

https://developers.popbill.com → API 연동 신청 → LinkID / SecretKey (test 연동은 즉시, 운영은 심사).
https://www.popbill.com 에서 사업자로 가입. 세금계산서 발행은 공동인증서 등록, 홈택스 수집은 홈택스 인증서 또는 부서사용자 등록, 알림톡은 카카오 채널 + 템플릿 승인 + 발신번호 등록이 각각 필요합니다 (팝빌 사이트에서 1회).
MCP client config:

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

POPBILL_TEST=true(default) uses Popbill's test server — invoices never reach the NTS, 알림톡 never reaches phones, and every tool description is tagged [TEST SERVER]. Switch to false only with the approval hook on:

"OKAGENT_API_KEY": "ok_…"

Without it, write tools still never run blind: the first call returns a preview and a confirm_token, and the agent re-calls only after you agree in the chat. With an OK Agent key (free, 200/month) the request goes to your phone instead — approve on KakaoTalk, with a log. KMCP_WRITE_MODE=direct turns the check off for scripts you fully trust.

Popbill restricts API calls by IP by default (POPBILL_IP_RESTRICT, default on — register your IP in 팝빌 > 연동관리, or set false for roaming machines).

Issuing an invoice — what the agent sends

"mgtKey": "INV-20261021-001", "writeDate": "20261021", "invoicer": { "corpNum": "123-45-67890", "corpName": "앱몬스터", "ceoName": "윤유성", "email": "me@appmonster.co.kr" }, "invoicee": { "corpNum": "987-65-43210", "corpName": "거래처", "ceoName": "김대표", "email": "ap@client.co.kr" }, "items": [{ "name": "앱 개발", "supplyCost": 3000000 }] }

→ 공급가액 3,000,000 / 세액 300,000 / 합계 3,300,000, issued, emailed, NTS confirmation number returned. Pair with kr_check_business (public-data server) to verify the buyer's number first.

Notes

This package wraps the official popbill Node SDK (promise-ified); tests inject fakes, no network.
알림톡 content must match the approved template byte-for-byte after variable substitution — read it with popbill_list_alimtalk_templates first.
Hometax collection is async: request → poll results. A job for 6 months of purchases typically finishes in under a minute.

Development

pnpm --filter @appmonster/mcp-popbill test

Popbill (세금계산서·알림톡)

What it does

설치

Node.js 설치