peru-invoice

Let AI agents issue Peruvian electronic receipts (factura / boleta CPE) via Nubefact PSE-OSE.

От сообществаРаботаетБез входаГлобальныйБесплатноМожет изменять данные

Что умеет

  • Create Invoice: Issue a Peru electronic CPE (comprobante de pago electrónico) — FACTURA (B2B, buyer RUC) or BOLETA (B2C consumer) — declared to SUNAT via Nubefact. Bring your own Nubefact credentials
  • Query Invoice: Check a Peru CPE previously issued (consultar_comprobante) by its identity: comprobante_type + serie + numero (Nubefact/SUNAT identify documents by these, not by an opaque id). Status v
  • Cancel Invoice: Void a Peru CPE at SUNAT (generar_anulacion — a comunicación de baja). Identified by comprobante_type + serie + numero, plus a free-text motivo (reason, e.g. "ERROR DEL SISTEMA"). SUNA

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

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

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

Let AI agents issue Peruvian electronic receipts (factura / boleta CPE) via Nubefact PSE-OSE. Stateless remote MCP server: bring your own credentials, it stores nothing. Create, query, and void documents with IGV tax math and SUNAT compliance handled by the provider.

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

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

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

https://peru-invoice--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 не видит.

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

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

https://peru-invoice--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 откроет окно входа в сервис. Войдите и подтвердите доступ.

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

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

https://peru-invoice--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 Peru electronic CPE (comprobante de pago electrónico) — FACTURA (B2B, buyer RUC) or BOLETA (B2C consumer) — declared to SUNAT via Nubefact. Bring your own Nubefact credentials as headers: x-nubefact-ruta (your unique full RUTA URL, e.g. https://api.nubefact.com/api/v1/<hash>) AND x-nubefact-token (your account TOKEN). A free DEMO account at www.nubefact.com gives both; the SAME credentials switch to production at the account level (numbering resets on go-live), so this server reports mode "nubefact-account" honestly rather than guessing demo vs production. ⚠️ NUMBERING IS MERCHANT-MANAGED: this server is stateless and does NOT track sequences — YOU must supply "serie" (e.g. F001 for facturas, B001 for boletas) and the next sequential "numero" yourself; reusing a numero is rejected by SUNAT, skipping one leaves a gap. Give item prices WITH IGV included (precio_unitario) — this server computes valor_unitario, subtotal, IGV (18%) and totals for you.
query_invoiceCheck a Peru CPE previously issued (consultar_comprobante) by its identity: comprobante_type + serie + numero (Nubefact/SUNAT identify documents by these, not by an opaque id). Status values: ACCEPTED (aceptada_por_sunat=true), PENDING (not yet sent/processing), REJECTED (SUNAT returned an error — see sunat_description). Also returns anulado (true if voided) and the PDF/XML/CDR links. Safe to call anytime.
cancel_invoiceVoid a Peru CPE at SUNAT (generar_anulacion — a comunicación de baja). Identified by comprobante_type + serie + numero, plus a free-text motivo (reason, e.g. "ERROR DEL SISTEMA"). SUNAT processes voids asynchronously via a ticket, so status is usually PENDING right after — call query_invoice later to confirm the document shows anulado=true. Note: for value corrections you normally issue a nota de crédito instead of a full void (notas not yet exposed by this server).