Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Bewertungen und Benutzerkonten folgen in einem späteren Schritt.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

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

von groove79Version 0.2.0i★ –iLäuft auf deinem Computer
Name in der Registryio.github.groove79/mcp-popbill

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft auf deinem Computer
  • Transport: stdio
  • Kategorie: Buchhaltung, Finanzen & Steuern
  • Das musst du eintragen: POPBILL_LINK_ID, POPBILL_SECRET_KEY, POPBILL_CORP_NUM, OKAGENT_API_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

  • Basischecks: 1 von 1 bestanden
  • Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
  • Das trägst du selbst ein: POPBILL_LINK_ID, POPBILL_SECRET_KEY, POPBILL_CORP_NUM, POPBILL_USER_ID, POPBILL_TEST, OKAGENT_API_KEY, KMCP_WRITE_MODE

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

  • npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "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",
        "POPBILL_USER_ID": "your-value",
        "POPBILL_TEST": "your-value",
        "OKAGENT_API_KEY": "your-value",
        "KMCP_WRITE_MODE": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add popbill --env POPBILL_LINK_ID=your-value --env POPBILL_SECRET_KEY=your-value --env POPBILL_CORP_NUM=your-value --env POPBILL_USER_ID=your-value --env POPBILL_TEST=your-value --env OKAGENT_API_KEY=your-value --env KMCP_WRITE_MODE=your-value -- npx -y @appmonster/mcp-popbill

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "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",
        "POPBILL_USER_ID": "your-value",
        "POPBILL_TEST": "your-value",
        "OKAGENT_API_KEY": "your-value",
        "KMCP_WRITE_MODE": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "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",
        "POPBILL_USER_ID": "your-value",
        "POPBILL_TEST": "your-value",
        "OKAGENT_API_KEY": "your-value",
        "KMCP_WRITE_MODE": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

  • POPBILL_LINK_ID erforderlich env
    Popbill API link id (developers.popbill.com)
  • POPBILL_SECRET_KEY geheim erforderlich env
    Popbill API secret key
  • POPBILL_CORP_NUM erforderlich 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 geheim 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)

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 10. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto groove79 bestätigt, dem das Repo gehört

  • … Noch nicht geprüft

    Wird noch gepflegt

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • … Noch nicht geprüft

    Hat eine Lizenz

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

  • Mehr Sterne als 0 % der anderen 3073 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 62 % der anderen 3073 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 3073 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

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

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: POPBILL_LINK_ID, POPBILL_SECRET_KEY, POPBILL_CORP_NUM, OKAGENT_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.2.0) kam vor 18 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Finance Toolkit, SolidInvoice, Korea Tax Calculator

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Finance Toolkit

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

von JerBoumaWeit verbreitet↓ 15.541/Wo.★ 5496Aktualisiert gestern

Computer oder Cloud

SolidInvoice

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

von SolidInvoiceWachsend★ 981Aktualisiert gestern

Läuft in der Cloud✓ solidinvoice.co

Korea Tax Calculator

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

von UpstageAIWachsend↓ 3172/Wo.★ 97Aktualisiert heute

Läuft auf deinem Computer

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

@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

ToolAccessWhat it does
popbill_check_accountread회원 여부·포인트 잔액
popbill_search_taxinvoicesread매출/매입 세금계산서 검색 (기간·상태·텍스트)
popbill_get_taxinvoiceread세금계산서 상세 + 보기 URL
popbill_issue_taxinvoicewrite정발행 즉시발행 — 품목에서 공급가액·세액·합계 자동 계산
popbill_cancel_taxinvoicewrite발행취소 (국세청 전송 전)
popbill_hometax_requestread홈택스 수집 작업 요청 → jobId (팝빌 홈택스수집 정액제 별도 신청 필요 — 테스트 연동키에도 기본 미포함)
popbill_hometax_resultsread수집 상태/결과 (collecting · done · failed)
popbill_list_alimtalk_templatesread승인 템플릿 목록 (변수 확인용)
popbill_send_alimtalkwrite알림톡 발송 (≤1,000명, SMS 대체 발송)
popbill_get_alimtalk_resultread발송 결과 (수신자별)

Setup

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