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

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

โดย groove79รุ่น 0.2.0i★ –iรันบนเครื่อง

ชื่อใน registryio.github.groove79/mcp-popbill

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

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

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังใหม่มาก↓ 63/สัปดาห์ · ★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: บัญชี การเงิน และภาษี
ต้องใส่ค่าเหล่านี้: POPBILL_LINK_ID, POPBILL_SECRET_KEY, POPBILL_CORP_NUM, OKAGENT_API_KEY

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: POPBILL_LINK_ID, POPBILL_SECRET_KEY, POPBILL_CORP_NUM, POPBILL_USER_ID, POPBILL_TEST, OKAGENT_API_KEY, KMCP_WRITE_MODE

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "popbill": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "ใส่ค่าของคุณ",
        "POPBILL_SECRET_KEY": "ใส่ค่าของคุณ",
        "POPBILL_CORP_NUM": "ใส่ค่าของคุณ",
        "POPBILL_USER_ID": "ใส่ค่าของคุณ",
        "POPBILL_TEST": "ใส่ค่าของคุณ",
        "OKAGENT_API_KEY": "ใส่ค่าของคุณ",
        "KMCP_WRITE_MODE": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add popbill --env POPBILL_LINK_ID='ใส่ค่าของคุณ' --env POPBILL_SECRET_KEY='ใส่ค่าของคุณ' --env POPBILL_CORP_NUM='ใส่ค่าของคุณ' --env POPBILL_USER_ID='ใส่ค่าของคุณ' --env POPBILL_TEST='ใส่ค่าของคุณ' --env OKAGENT_API_KEY='ใส่ค่าของคุณ' --env KMCP_WRITE_MODE='ใส่ค่าของคุณ' -- npx -y @appmonster/mcp-popbill

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "popbill": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "ใส่ค่าของคุณ",
        "POPBILL_SECRET_KEY": "ใส่ค่าของคุณ",
        "POPBILL_CORP_NUM": "ใส่ค่าของคุณ",
        "POPBILL_USER_ID": "ใส่ค่าของคุณ",
        "POPBILL_TEST": "ใส่ค่าของคุณ",
        "OKAGENT_API_KEY": "ใส่ค่าของคุณ",
        "KMCP_WRITE_MODE": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "popbill": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-popbill"
      ],
      "env": {
        "POPBILL_LINK_ID": "ใส่ค่าของคุณ",
        "POPBILL_SECRET_KEY": "ใส่ค่าของคุณ",
        "POPBILL_CORP_NUM": "ใส่ค่าของคุณ",
        "POPBILL_USER_ID": "ใส่ค่าของคุณ",
        "POPBILL_TEST": "ใส่ค่าของคุณ",
        "OKAGENT_API_KEY": "ใส่ค่าของคุณ",
        "KMCP_WRITE_MODE": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

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)

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 9 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub groove79 ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

ดาวมากกว่า 0% ของอีก 3031 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 63% ของอีก 3031 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 3031 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Popbill (세금계산서·알림톡) ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: POPBILL_LINK_ID, POPBILL_SECRET_KEY, POPBILL_CORP_NUM, OKAGENT_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.0) เข้า registry 17 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Finance Toolkit, SolidInvoice, Korea Tax Calculator

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Finance Toolkit

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

โดย JerBoumaใช้กันมาก↓ 15.5K/สัปดาห์★ 5.5Kอัปเดต วันนี้

บนเครื่องหรือคลาวด์

ติดตั้ง

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

โดย SolidInvoiceกำลังโต★ 981อัปเดต วันนี้

รันบนคลาวด์✓ solidinvoice.co

ติดตั้ง

Korea Tax Calculator

Korean tax calculation and tax-audit judgment MCP: 97 tools with statutory citations.

โดย UpstageAIกำลังโต↓ 3.2K/สัปดาห์★ 97อัปเดต วันนี้

รันบนเครื่อง

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ 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 (세금계산서·알림톡)

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README จากผู้ทำ

@appmonster/mcp-popbill

Tools

Setup

Issuing an invoice — what the agent sends

Notes

Development