ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที รีวิวและบัญชีผู้ใช้จะมาในขั้นถัดไป
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · อธิบายเป็นภาษาคน

Ru MCP

โดย InvoiceBoxรุ่น 0.2.1i★ –iรันบนเครื่อง
ชื่อใน registryru.invoicebox/mcp-server

ติดตั้ง

ภาพรวม

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

MCP-сервер Инвойсбокса: счета, отгрузки и возвраты по просьбе человека

สามเสาของ PopNx MCP

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

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

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

  • การเชื่อมต่อ: รันบนเครื่อง
  • ช่องทาง (transport): stdio
  • หมวด: อื่น ๆ
  • ต้องใส่ค่าเหล่านี้: INVOICEBOX_API_TOKEN, INVOICEBOX_MERCHANT_ID

ติดตั้ง

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

ก่อนติดตั้ง

  • ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
  • รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
  • ค่าที่คุณต้องใส่เอง: INVOICEBOX_API_TOKEN, INVOICEBOX_MERCHANT_ID, INVOICEBOX_ENV, INVOICEBOX_TOOLSETS, INVOICEBOX_STATE_DIR

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

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

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

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

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

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

{
  "mcpServers": {
    "invoicebox": {
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "ใส่ค่าของคุณ",
        "INVOICEBOX_MERCHANT_ID": "ใส่ค่าของคุณ",
        "INVOICEBOX_ENV": "ใส่ค่าของคุณ",
        "INVOICEBOX_TOOLSETS": "ใส่ค่าของคุณ",
        "INVOICEBOX_STATE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

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

claude mcp add invoicebox --env INVOICEBOX_API_TOKEN='ใส่ค่าของคุณ' --env INVOICEBOX_MERCHANT_ID='ใส่ค่าของคุณ' --env INVOICEBOX_ENV='ใส่ค่าของคุณ' --env INVOICEBOX_TOOLSETS='ใส่ค่าของคุณ' --env INVOICEBOX_STATE_DIR='ใส่ค่าของคุณ' -- npx -y @invoicebox/mcp-server

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

เปิดใน Cursor

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

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

{
  "mcpServers": {
    "invoicebox": {
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "ใส่ค่าของคุณ",
        "INVOICEBOX_MERCHANT_ID": "ใส่ค่าของคุณ",
        "INVOICEBOX_ENV": "ใส่ค่าของคุณ",
        "INVOICEBOX_TOOLSETS": "ใส่ค่าของคุณ",
        "INVOICEBOX_STATE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

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

เปิดใน VS Code

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

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

{
  "servers": {
    "invoicebox": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "ใส่ค่าของคุณ",
        "INVOICEBOX_MERCHANT_ID": "ใส่ค่าของคุณ",
        "INVOICEBOX_ENV": "ใส่ค่าของคุณ",
        "INVOICEBOX_TOOLSETS": "ใส่ค่าของคุณ",
        "INVOICEBOX_STATE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

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

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

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

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

  • INVOICEBOX_API_TOKEN ความลับ จำเป็น env
    Токен API Инвойсбокса. Выпускается в личном кабинете; правами токена ограничивается то, что сервер вообще может сделать
  • INVOICEBOX_MERCHANT_ID จำเป็น env
    Идентификатор магазина, от имени которого работает сервер
  • INVOICEBOX_ENV env
    Контур: demo или prod. По умолчанию demo — боевой включается явно
  • INVOICEBOX_TOOLSETS env
    Наборы инструментов через запятую: read по умолчанию, write и refund включаются явно
  • INVOICEBOX_STATE_DIR env
    Каталог состояния: без него защита от дублей действует только в пределах одного запуска

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

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

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

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

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

  • ✓ ผ่าน

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

    ชื่อใน registry ยืนยันโดเมน invoicebox.ru แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)

  • … ยังไม่ตรวจ

    ยังมีคนดูแล

    ยังไม่ได้อ่านข้อมูล repo จาก GitHub

  • … ยังไม่ตรวจ

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

    ยังไม่ได้อ่านข้อมูล repo จาก GitHub

  • – ไม่เกี่ยว

    endpoint ตอบ

    ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต

  • – ไม่เกี่ยว

    ล็อกอินแบบ OAuth

    ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน

  • … ยังไม่ตรวจ

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

    รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด อื่น ๆi

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

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

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

Ru MCP ปลอดภัยไหม?

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

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

ต้องใส่ค่าเหล่านี้: INVOICEBOX_API_TOKEN, INVOICEBOX_MERCHANT_ID

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

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

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

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.1) เข้า registry 3 เดือนที่ผ่านมา

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

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

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

ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, Systemdox

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

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

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

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

โดย formulahendryเริ่มต้น↓ 66/สัปดาห์★ 440อัปเดต 14 เดือนที่ผ่านมา

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

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

โดย desktop-commanderกำลังโต★ 211อัปเดต 4 วันที่ผ่านมา

รันบนคลาวด์✓ desktopcommander.app

Systemdox

Your architecture in your agents' context: checks, specs, ADRs and docs over MCP, at write time.

โดย pugliesewebกำลังโต↓ 3K/สัปดาห์อัปเดต วันนี้

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

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Invoicebox MCP Server

Сервер Model Context Protocol для Инвойсбокса: ассистент выставляет счёт организации, ИП или физическому лицу, проверяет оплату, подтверждает отгрузку — а по ней формируются закрывающие документы, — и возвращает деньги. Всё по просьбе человека и с его подтверждением.

Права по умолчанию — только чтение. Ни одна операция с деньгами не выполняется в один вызов.

Быстрый старт на демо-магазине

Демонстрационный магазин опубликован в документации (авторизация), поэтому попробовать можно без своего договора. Он общий для всех читателей: пробные счета видны всем, поэтому реальные реквизиты и персональные данные в демо не вводите.

INVOICEBOX_API_TOKEN=b37c4c689295904ed21eee5d9a48d42e INVOICEBOX_MERCHANT_ID=ffffffff-ffff-ffff-ffff-ffffffffffff INVOICEBOX_ENV=demo npx -y @invoicebox/mcp-server

Записи включаются явно: INVOICEBOX_TOOLSETS=write добавляет счёт, отмену и отгрузку, refund — возврат. Токен можно не держать в переменной окружения: invoicebox-mcp-server login <токен> кладёт его в файл с правами только для владельца.

Пример конфигурации клиента MCP:

{

"mcpServers": { "invoicebox": { "command": "npx", "args": ["-y", "@invoicebox/mcp-server@0.2.1"], "env": { "INVOICEBOX_API_TOKEN": "b37c4c689295904ed21eee5d9a48d42e", "INVOICEBOX_MERCHANT_ID": "ffffffff-ffff-ffff-ffff-ffffffffffff", "INVOICEBOX_ENV": "demo", "INVOICEBOX_TOOLSETS": "read" } } } }

Версию указывайте всегда: у платёжного инструмента latest означает, что набор инструментов может измениться между двумя запусками одного и того же диалога.

Инструменты

ИнструментЧто делаетПодтверждение
lookup_company_by_innРеквизиты организации или ИП по ИННнет
get_orderСчёт по идентификатору или по своему номерунет
find_ordersСрез по счетам: номер, статус, даты, суммынет
find_shipmentsЧто по заказу отгружено и в каком статусенет
create_orderВыставляет счёт, возвращает ссылку на оплатудвухфазное
cancel_orderОтменяет неоплаченный счётдвухфазное
create_shipmentПодтверждает отгрузку, по ней идут акт, счёт-фактура и УПДдвухфазное
create_refundВозвращает деньги полностью или по составудвухфазное

Полный справочник с параметрами — https://docs.invoicebox.ru/mcp/tools/

Что важно знать до первого счёта

  • Суммы — целые копейки строкой: "12200" это 122,00 ₽. Так модель не теряет копейку на числе с плавающей точкой.
  • Цена — за единицу, сумма — за количество. amount и amount_wo_vat в позиции относятся к одной единице, total_amount и total_vat_amount — ко всему количеству.
  • Все записи двухфазные. Первый вызов ничего не отправляет в API: возвращает сводку и одноразовый токен на 15 минут, привязанный к параметрам. Второй вызов с этим токеном исполняет операцию.
  • Крупная сумма подтверждается отдельно. Выше порога (по умолчанию 100 000 ₽) сервер спрашивает человека, а не довольствуется числом, которое подставила модель.
  • Повтор не создаёт дубль. Номер операции выводится из содержимого запроса; повтор того же вызова возвращает прежний результат.
  • Покупатель — юрлицо, ИП или физлицо. В API типа два: legal (у ИП ИНН из 12 цифр и без КПП) и private.
  • Закрывающие документы идут по отгрузке. Отдельного «сформировать УПД» нет: акт, ТОРГ-12, счёт-фактуру и УПД запускает create_shipment.

Настройки

ПеременнаяОбязательнаНазначение
INVOICEBOX_API_TOKENда, если нет файла токенаТокен из личного кабинета, вкладка «Интеграция (API)»
INVOICEBOX_ENVдаdemo или production; демо — магазин в тестовом режиме
INVOICEBOX_MERCHANT_IDдля операций магазинаИдентификатор магазина
INVOICEBOX_COUNTERPARTY_IDдля операций организацииИдентификатор организации
INVOICEBOX_TOOLSETSнетread по умолчанию, плюс write и refund
INVOICEBOX_STATE_DIRнетКаталог журнала и защиты от дублей; без него она живёт только в пределах запуска
INVOICEBOX_RATE_LIMITнетСвой ограничитель, запросы/секунды; по умолчанию 60/30
INVOICEBOX_LIMITSнетСуточные потолки, JSON
INVOICEBOX_CONFIRM_THRESHOLDнетПорог суммы в копейках для отдельного подтверждения
INVOICEBOX_LOG_LEVELнетerror, warn, info, debug
INVOICEBOX_GRAYLOG_URL, INVOICEBOX_SENTRY_DSNнетВнешние приёмники журнала; выключены по умолчанию
INVOICEBOX_TOKEN_FILEнетСвой путь к файлу токена
INVOICEBOX_HTTP_PORTнетЗадан — транспорт Streamable HTTP на этом порту, иначе stdio
INVOICEBOX_HTTP_HOSTнетАдрес привязки HTTP; по умолчанию 127.0.0.1
INVOICEBOX_HTTP_ALLOWED_HOSTS, INVOICEBOX_HTTP_ALLOWED_ORIGINSнетБелые списки Host и Origin; по умолчанию наружу закрыто
INVOICEBOX_HTTP_SESSION_IDLE_MS, INVOICEBOX_HTTP_MAX_SESSIONSнетСрок жизни сессии (30 минут) и их потолок (200)

Полный список настроек — https://docs.invoicebox.ru/mcp/quickstart/

Расход контекста

Набор по умолчанию занимает около 1 100 токенов описаний, полный набор с возвратами — около 4 000. Выборка двадцати счетов стоит примерно 1 200 токенов в кратком формате и 2 900 в подробном. Ответы усекаются с явной пометкой, страница ограничена пятьюдесятью записями. Замеры и приёмы — https://docs.invoicebox.ru/mcp/tokens/

Разработка

npm ci

npm run typecheck npm run lint npm test npm run build

Документация

  • Раздел о сервере: https://docs.invoicebox.ru/mcp/
  • Справочник инструментов: https://docs.invoicebox.ru/mcp/tools/
  • Безопасность и подтверждения: https://docs.invoicebox.ru/mcp/security/
  • Лимиты, ошибки и журнал: https://docs.invoicebox.ru/mcp/faq/
  • Расход токенов: https://docs.invoicebox.ru/mcp/tokens/
  • Ассистенты без MCP: https://docs.invoicebox.ru/mcp/functions/
  • API Инвойсбокса: https://docs.invoicebox.ru/docs/api/

История изменений

Что менялось между версиями — в файле CHANGELOG.md внутри пакета (npm view @invoicebox/mcp-server versions покажет список выпусков). Версию в конфигурации указывайте явно: у платёжного инструмента latest означает, что набор инструментов может измениться между двумя запусками одного диалога.

Поддержка

Вопросы и доступ к бете — https://www.invoicebox.ru/ru/contacts

ถาม PopNx