velora

Velora: аргентинская коммерция под ключ — счета AFIP, MercadoPago, логистика и WhatsApp

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

Что умеет

  • Выставлять фискальные счета и накладные через AFIP
  • Вести каталог товаров и управлять остатками на складе
  • Регистрировать продажи, возвраты и движения товара
  • Оформлять и отслеживать доставку через логистических партнёров
  • Отправлять сообщения и шаблоны клиентам в WhatsApp

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

Сервер работает без отдельной авторизации на уровне MCP, доступ к бизнес-данным определяется подключением конкретного аккаунта Velora.

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

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

Velora — размещённый MCP-сервер для аргентинского бизнеса: ассистент выставляет реальные фискальные счета AFIP, ведёт каталог и склад, регистрирует продажи и возвраты, оформляет доставку с трекингом и отправляет сообщения клиентам через WhatsApp.

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

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

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

https://tools.somosvelora.com/api/mcp

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

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

Авторизация

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

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

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

https://tools.somosvelora.com/api/mcp

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

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

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

https://tools.somosvelora.com/api/mcp

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

Вручную:

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

Авторизация

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

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

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

validate_cuitValidates an Argentine CUIT or CUIL number. Returns parsed components (prefix, body, check digit), person type, and whether the check digit is mathematically correct. Accepts any format: raw digits, hyphened (20-12345678-9), or spaced. This tool runs the REAL check-digit algorithm — not a demo fixture.
get_fiscal_readinessChecks whether the business is ready to emit real ARCA electronic invoices. Returns { ready, missing, guidance } where ready=true means all fiscal fields and the ARCA certificate are configured.
emit_invoice[demo: deshabilitada] Emits an ARCA (formerly AFIP)-compliant electronic invoice (factura electrónica) for the authenticated business and returns the CAE authorization code.
emit_nota[demo: deshabilitada] Emits an ARCA-compliant Nota Crédito (NC) or Nota Débito (ND) against an original AFIP invoice and returns the CAE authorization code.
create_product[demo: deshabilitada] Creates a new product in the business catalog. Requires name and price.
edit_product[demo: deshabilitada] Updates a single product's fields (name, price, costPrice, or stockQuantity).
stock_load[demo: deshabilitada] Records inbound stock for a product — restock or initial stock, with an audit trail.
adjust_stock[demo: deshabilitada] Sets the absolute stock quantity for a product (inventory sync, no audit trail).
delete_product[demo: deshabilitada] Deletes (or soft-archives, when it has sale records) a product from the catalog.
bulk_price_update[demo: deshabilitada] Mass price change for all products or a specified subset in this business.
query_catalogLists active products in the business catalog. Returns products sorted by name, each with id, name, price (ARS), costPrice, sku, stock quantity, and weightGrams.
open_catalog_selectorOpens the catalog selector — a graphical product picker (MCP Apps widget) that shows active products with prices (ARS) and stock. Side-effect-free (no sale, no charge).
register_sale[demo: deshabilitada] Records a sale for the authenticated business. Creates a full Sale with SaleItems, decrements inventory, creates a CashMovement and Invoice.
register_movement[demo: deshabilitada] Records a cash-register movement for the authenticated business ('purchase', 'income', 'salary', 'tax', 'adjustment').
return_sale[demo: deshabilitada] Reverses the N most-recent sales within a time window. Restores inventory, removes CashMovement, SaleItem, Invoice, and Sale records. Destructive and irreversible.
find_customerSearches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name.
upsert_customer[demo: deshabilitada] Creates a new customer or updates an existing one for the authenticated business.
delete_customer[demo: deshabilitada] Deletes a customer from this business (blocked when the customer has sales or invoices).
quote_shippingQuotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending.
create_shipment[demo: deshabilitada] Creates a physical shipment via the chosen courier and returns a tracking number and label URL.
track_shipmentTracks the current status and event history of a shipment by tracking number.
get_package_profileComputes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride.
send_whatsapp_text[demo: deshabilitada] Sends a plain-text WhatsApp message to a customer phone number. Only valid inside the 24-hour customer-service window (Meta error 131026 outside).
send_whatsapp_template[demo: deshabilitada] Sends a pre-approved Meta WhatsApp template message. Window-independent — can be sent proactively, outside the 24-hour session window.
connection_statusReturns the BYOA (Bring Your Own Account) integration readiness for the authenticated business — what is connected and how to connect what is missing. Read-only.
caja_consultar_saldoQueries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only.
caja_ciclo_caja[demo: deshabilitada] Opens or closes a cash register shift for the authenticated business.
caja_registrar_movimiento[demo: deshabilitada] Records a cash movement tied to the OPEN caja shift: income, expense, withdrawal, tax, or payroll.
get_payment_intent_statusChecks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name.
open_payment_link_wizardOpens the payment-link wizard — a graphical form pre-filled with the cobro, for the owner to review and confirm before any money moves. Side-effect-free (no charge).
open_pending_ordersOpens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free.
open_cobro_statusOpens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName.
open_delivery_receiptOpens the comprobante + envío widget — a read-only view of the delivery receipt for a completed cobro. Accepts paymentIntentId, saleId, OR customerName.
create_tracked_payment_link[demo: deshabilitada] Creates a tracked MercadoPago payment link for a catalog-tied cobro: atomically records the Sale + Invoice + PaymentIntent, then generates a real Checkout Pro link. MONEY: real and irreversible.
list_suppliersReturns all suppliers for this business (up to 50, sorted by name).
create_supplier[demo: deshabilitada] Creates a supplier for this business.
create_purchase_request[demo: deshabilitada] Creates a procurement order (purchase request) to a supplier.
edit_supplier[demo: deshabilitada] Updates an existing supplier's fields.
delete_supplier[demo: deshabilitada] Deletes a supplier from this business (with full audit trail).
query_salesQueries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'.
connect_mercadopago[demo: deshabilitada] Connects MercadoPago for this business using the BYOA OAuth-redirect model. Primary: returns an authorization URL. Fallback: accepts a production access token directly.
connect_pedidosya[demo: deshabilitada] Connects PedidosYa for this business using the BYOA secure-form model. Primary: returns a secure link. Fallback: accepts an API token directly.
connect_whatsapp[demo: deshabilitada] Connects WhatsApp Business using the BYOA Meta Embedded Signup model. Primary: returns a signup link. Optional: registers a phone number as a lightweight pre-step.
connect_tiendanube[demo: deshabilitada] Connects Tienda Nube (Nuvemshop) using the BYOA OAuth-redirect model. Returns an authorization URL — no token ever passes through chat. Gated behind env config in production.
upload_catalog[demo: deshabilitada] Bulk-creates products in the business catalog from a structured list (up to 50 items).
open_sale_confirmOpens a VISUAL preview of a cash sale — resolved product names, unit prices, quantities, and total — with a confirm button that fires register_sale. Read-only preview itself.
open_caja_statusOpens a visual widget showing the current shift state and action buttons. Read-only here.
open_onboardingOpens a graphical onboarding hub showing integration status and connect links. Read-only.
open_business_overviewONE widget, two display modes: inline snapshot by default, fullscreen tabs (Cliente 360, Cerrar el día, Reposición de stock, Dashboard de ventas) on demand. Aggregates caja, payments, ventas, reportes, supplier, and customer reads.
open_shipment_prepCombines catalog stock/weight data and a live shipping quote into one widget — resolves items, computes total weight, and quotes couriers. Read-only, side-effect-free.