mexico-invoice

Let AI agents issue Mexican CFDI 4.0 electronic invoices (factura electronica) via Facturapi.

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

Что умеет

  • Create Invoice: Issue a Mexico CFDI 4.0 electronic invoice (factura electrónica, stamped/timbrada through a SAT-certified PAC) via Facturapi. Bring your own Facturapi secret key via header x-facturapi
  • Query Invoice: Check a Mexico CFDI invoice created by create_invoice. Status values: VALID (stamped and fiscally valid — uuid is the SAT folio fiscal), CANCELED (voided at SAT); cancellation_status pe
  • Cancel Invoice: Cancel (void) a stamped Mexico CFDI at SAT. SAT requires a cancellation motive code: 01 replaced-with-corrected, 02 issued-in-error-no-replacement (default), 03 transaction-did-not-hap

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

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

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

Let AI agents issue Mexican CFDI 4.0 electronic invoices (factura electronica) via Facturapi. Stateless remote MCP server: bring your own key, it stores nothing. Create, query, cancel, and email invoices with SAT catalog defaults built in.

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

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

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

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

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

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

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

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

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

https://mexico-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 появится кнопка авторизации.

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

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

create_invoiceIssue a Mexico CFDI 4.0 electronic invoice (factura electrónica, stamped/timbrada through a SAT-certified PAC) via Facturapi. Bring your own Facturapi secret key via header x-facturapi-key — sk_test_ keys are free (sign up at facturapi.io) and never reach SAT; sk_live_ keys stamp real CFDIs. The merchant's CSD certificate lives in their own Facturapi account; this server never sees or stores it. Sensible defaults are applied for SAT catalog fields: product_key 01010101 (generic), payment_form 03 (bank transfer), use G03 (general expenses) — override per item/invoice if the buyer needs specific codes. For a buyer without RFC use tax_id XAXX010101000 with tax_system 616 and use S01.
query_invoiceCheck a Mexico CFDI invoice created by create_invoice. Status values: VALID (stamped and fiscally valid — uuid is the SAT folio fiscal), CANCELED (voided at SAT); cancellation_status pending means SAT is still processing a cancellation. Safe to call anytime.
cancel_invoiceCancel (void) a stamped Mexico CFDI at SAT. SAT requires a cancellation motive code: 01 replaced-with-corrected, 02 issued-in-error-no-replacement (default), 03 transaction-did-not-happen, 04 related-to-global-invoice. Some cancellations need the buyer's acceptance — status stays pending until SAT resolves it.
send_invoiceEmail the stamped CFDI (PDF + XML) to the buyer via Facturapi. Uses the email stored on the invoice unless a different one is passed.