korea-invoice-mcp

Let AI agents issue Korea NTS e-tax invoices (전자세금계산서) — issue via your own POPBiLL/Linkhub account (merchant-owned LinkID, certificate stays in your…

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Create Invoice: Issue a Korean 전자세금계산서 (electronic tax invoice) in ONE step (registIssue = 즉시발행) through POPBiLL, and register it. The invoice is issued to the buyer immediately; POPBiLL transmits it
  • Query Invoice: Look up a single 전자세금계산서 by its 문서관리번호 (mgt_key) — GET /Taxinvoice/{MgtKeyType}/{MgtKey}. MgtKeyType selects whose box: SELL (you issued it as the seller — default), BUY (you received i
  • Send To Nts: FORCE immediate 국세청 (NTS) transmission of an already-issued 전자세금계산서 — POST /Taxinvoice/{MgtKeyType}/{MgtKey} (override NTS). Normally POPBiLL transmits an issued invoice to NTS automatica

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Let AI agents issue Korea NTS e-tax invoices (전자세금계산서) — issue via your own POPBiLL/Linkhub account (merchant-owned LinkID, certificate stays in your account), query status, force NTS transmission. Stateless remote MCP server: per-request HMAC token minting, VAT 10% computed locally, never stores data.

Как подключить

Как подключить korea-invoice-mcp к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://korea-invoice-mcp--wishpool.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить korea-invoice-mcp к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://korea-invoice-mcp--wishpool.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить korea-invoice-mcp к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://korea-invoice-mcp--wishpool.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (3)

Технические названия из tools/list. Нужны только разработчикам.

create_invoiceIssue a Korean 전자세금계산서 (electronic tax invoice) in ONE step (registIssue = 즉시발행) through POPBiLL, and register it. The invoice is issued to the buyer immediately; POPBiLL transmits it to 국세청 (NTS / National Tax Service) automatically the NEXT day (익일전송) unless you call send_to_nts to force it now. The invoicer (seller) 사업자번호, name and CEO come from you; the buyer (invoicee) and the line items come in the arguments. 부가세 (VAT) is computed for you server-side: taxType 과세 = 10% (per-line tax = floor(supplyCost x 0.1), 원 단위 절사), 영세/면세 = 0. A unique 문서관리번호 (mgt_key) is generated automatically if you do not pass one (rule: "K" + base36 timestamp + random, uppercased, <=24 chars, unique per business). Returns the mgt_key and the assigned ntsConfirmNum (국세청 승인번호). Required credential headers (set once in your MCP client, per-request, never stored): x-popbill-linkid + x-popbill-secretkey (your OWN Linkhub keys, free from linkhub.co.kr 파트너 신청) + x-popbill-corpnum (your 10-digit 사업자번호, the invoicer/seller — the invoice is issued FROM this business). Optional header x-popbill-mode: test (default = POPBILL_TEST, no fiscal effect) | prod (production, real fiscal effect, live 국세청 transmission). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.
query_invoiceLook up a single 전자세금계산서 by its 문서관리번호 (mgt_key) — GET /Taxinvoice/{MgtKeyType}/{MgtKey}. MgtKeyType selects whose box: SELL (you issued it as the seller — default), BUY (you received it as the buyer), TRUSTEE (you issued it as an entrusted agent / 수탁). Returns the document stateCode and a readable state: 200 발행완료 (issued), 300 국세청 전송대기 (queued for NTS — next-day auto-send unless send_to_nts is called), 320 국세청 전송완료 (NTS transmission succeeded — terminal success), 330 국세청 전송실패 (failed), 400 발행취소 (cancelled), plus the ntsConfirmNum, issue/NTS-send timestamps and totals. Required credential headers (set once in your MCP client, per-request, never stored): x-popbill-linkid + x-popbill-secretkey (your OWN Linkhub keys, free from linkhub.co.kr 파트너 신청) + x-popbill-corpnum (your 10-digit 사업자번호, the invoicer/seller — the invoice is issued FROM this business). Optional header x-popbill-mode: test (default = POPBILL_TEST, no fiscal effect) | prod (production, real fiscal effect, live 국세청 transmission). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.
send_to_ntsFORCE immediate 국세청 (NTS) transmission of an already-issued 전자세금계산서 — POST /Taxinvoice/{MgtKeyType}/{MgtKey} (override NTS). Normally POPBiLL transmits an issued invoice to NTS automatically the NEXT DAY (익일전송); call this only when you need it sent to the tax authority right now instead of waiting for the next-day batch. It does NOT issue the invoice (create_invoice already did that) and does NOT change the invoice content. Returns whether NTS transmission was accepted; poll query_invoice for stateCode 320 (전송완료). Required credential headers (set once in your MCP client, per-request, never stored): x-popbill-linkid + x-popbill-secretkey (your OWN Linkhub keys, free from linkhub.co.kr 파트너 신청) + x-popbill-corpnum (your 10-digit 사업자번호, the invoicer/seller — the invoice is issued FROM this business). Optional header x-popbill-mode: test (default = POPBILL_TEST, no fiscal effect) | prod (production, real fiscal effect, live 국세청 transmission). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.