Cobra · Facturación SRI Ecuador

El primer servidor MCP de facturación electrónica del SRI de Ecuador.

От сообществаРаботаетНужен API-ключГлобальныйБесплатноТолько чтение

Что умеет

  • Whoami: Confirma el tenant, si estás en sandbox o producción, si la firma está activa, y los permisos de tu llave.
  • Consultar Ruc: Trae la razón social y el estado de un contribuyente desde el padrón del SRI.
  • Emitir Factura: Crea y emite una factura autorizada por el SRI. Totales/IVA server-side. Idempotente: reintentar con los mismos datos no duplica.

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

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

Нужен API-ключ из настроек сервиса

El primer servidor MCP de facturación electrónica del SRI de Ecuador. Emite facturas, notas de venta, notas de crédito/débito y retenciones autorizadas por el SRI en tiempo real, con lenguaje natural desde tu agente de IA (Claude, ChatGPT, Cursor). Incluye validación de RUC, consulta de estado, anulación guiada y sandbox de pruebas. Ideal para negocios, RIMPE, contadores y desarrolladores en Ecuador.

The first MCP server for Ecuador's SRI electronic invoicing (e-invoicing): issue SRI-authorized invoices, sales notes, credit/debit notes and withholding receipts in natural language. Includes RUC lookup, status checks, guided voiding and a sandbox.

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

Как подключить Cobra · Facturación SRI Ecuador к Claude

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

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

Как подключить Cobra · Facturación SRI Ecuador к ChatGPT

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

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

Как подключить Cobra · Facturación SRI Ecuador к Cursor

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

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

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

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

whoamiConfirma el tenant, si estás en sandbox o producción, si la firma está activa, y los permisos de tu llave.
consultar_rucTrae la razón social y el estado de un contribuyente desde el padrón del SRI.
emitir_facturaCrea y emite una factura autorizada por el SRI. Totales/IVA server-side. Idempotente: reintentar con los mismos datos no duplica.
emitir_documento01 factura, 04 nota de crédito, 05 nota de débito, 06 retención. Para 04/05 envía doc_modificado_*; para 06 envía retention_items y un sujeto retenido identificado.
consultar_estadoEstado (authorized/rejected/…), número de autorización y mensajes del SRI.
listar_documentosLista los comprobantes del tenant con filtros por tipo, estado y rango de fechas.
anular_documentoEvalúa y registra la anulación de un comprobante según las reglas del SRI (2025-2026): bloquea las facturas a consumidor final (firmes desde el 1-ene-2026), respeta el plazo (hasta el día 7 del mes siguiente al de emisión) y, fuera de plazo, indica emitir una nota de crédito. El SRI no tiene API de anulación: el contribuyente la completa en el portal SRI en línea. Devuelve la decisión (puede/motivo/via/plazo_hasta y el siguiente paso).
crear_contactoGuarda un cliente/proveedor. El tipo de identificación se deriva.
crear_productoDa de alta un producto en el catálogo del tenant.