Resumen
API de Bling ERP v3 (Brasil): productos y categorías, saldos y movimientos de stock, almacenes, pedidos de venta y estados, contactos, lecturas y borradores de NF-e, cuentas por cobrar y pagar (solo lectura). La emisión de NF-e está desactivada. Inicio de sesión OAuth 2 con tu propia aplicación Bling.
Configuración guiada
Conecta Bling a Gemini en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Bling con la configuración guiada y añade tu URL MCP a Gemini. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Bling
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Bling, pega el Client ID y el Client Secret de tu aplicación Bling, haz clic en Authorize with Provider y permite el acceso en Bling, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Bling + Gemini
API de Bling ERP v3 (Brasil): productos y categorías, saldos y movimientos de stock, almacenes, pedidos de venta y estados, contactos, lecturas y borradores de NF-e, cuentas por cobrar y pagar (solo lectura). La emisión de NF-e está desactivada. Inicio de sesión OAuth 2 con tu propia aplicación Bling.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
BLING_CLIENT_ID, BLING_CLIENT_SECRET
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 10 minutos.
- En Bling abre Central de Extensoes, Area do Integrador y haz clic en Criar aplicativo. Elige visibilidad Privado (funcionará solo con tu propia cuenta de Bling, sin revisión de Bling).
- Completa el nombre y los datos de contacto. Como Link de redirecionamento ingresa
https://cloud.anythingmcp.com/api/mcp-oauth/callbacken AnythingMCP Cloud, o<tu URL de AnythingMCP>/api/mcp-oauth/callbackcuando alojes AnythingMCP tú mismo. - Selecciona los alcances que necesita este conector: productos, stock, almacenes, pedidos de venta, contactos, NF-e, cuentas por cobrar y pagar, métodos de pago, estados y datos de la empresa. Guarda. Cambiar los alcances más tarde desconectará a todos los usuarios.
- En la pestaña Informacoes do app copia el Client ID y el Client Secret en
BLING_CLIENT_IDyBLING_CLIENT_SECRET, guarda el conector y haz clic en Authorize with Provider, luego inicia sesión en Bling y permite el acceso.
Los tokens de acceso duran 6 horas y se renuevan con el token de actualización, que dura 30 días: un conector que no se utiliza durante más de eso necesita Authorize with Provider nuevamente. Bling bloquea una dirección durante una hora después de 20 solicitudes de token en un minuto, así que no intentes iniciar sesión en un bucle.
Dónde empezar: bling_get_company verifica la conexión. Luego bling_list_orders (filtra por fecha o estado) y bling_get_order, o bling_list_products y bling_get_product.
Productos y stock: bling_list_products, bling_get_product, bling_create_product, bling_update_product, bling_list_product_categories, bling_get_stock_balances, bling_get_warehouse_stock_balances, bling_create_stock_movement, bling_list_warehouses. bling_delete_product está instalado desactivado. saldoVirtual es el stock físico menos lo que reservan los pedidos abiertos.
Pedidos de venta: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Los ids de estado difieren por cuenta: léelos con bling_list_status_modules (módulo Vendas) y bling_list_statuses. bling_delete_order está instalado desactivado. Ninguna herramienta publica cuentas por cobrar o liquida pagos.
Contactos: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (reemplaza todo el contacto: léelo primero).
NF-e: bling_list_invoices, bling_get_invoice (con enlaces a DANFE y XML), bling_generate_invoice_from_order (crea un borrador pendiente solamente). bling_send_invoice, que transmite el NF-e a SEFAZ, está instalado desactivado: un NF-e autorizado es un documento fiscal. Actívalo solo deliberadamente.
Finanzas (solo lectura): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. El conector nunca mueve dinero: no se incluye liquidación (baixa), boleto o acción de Pix.
Notas de campo: los ids son números. Los montos están en BRL con un punto decimal. Las fechas son YYYY-MM-DD; un rango de fechas puede abarcar como máximo un año. CPF y CNPJ se ingresan como dígitos. Las respuestas están envueltas en data; los errores llevan error.type, error.message, error.description y error.fields nombrando el campo inválido.
Paginación y límites: las listas toman pagina desde 1 y limite hasta 100; una lista data vacía es el final. Bling permite 3 solicitudes por segundo y 120,000 por día por cuenta (429 arriba); 300 errores o 600 solicitudes dentro de 10 segundos bloquean la dirección durante 10 minutos, así que no hagas un bucle sobre llamadas fallidas.
Paso 2 — Instalar el adaptador
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Agregar el conector en Gemini
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
Bling.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
bling_get_company | Obtiene los datos básicos de la cuenta de Bling a la que está conectado el conector: id, nome (nombre de la empresa), cnpj, email y dataContrato. Una llamada económica… |
bling_list_products | Lista productos: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (saldo virtual), tipo, situacao, formato, descricaoCurta… |
bling_get_product | Obtiene un producto con todos los detalles: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque… |
bling_create_product | Crea un producto o servicio. nome, tipo, situacao y formato son obligatorios. Devuelve data.id del nuevo producto (y de sus variaciones). Impuesto… |
bling_update_product | Cambia un producto (PATCH: solo cambian los campos enviados): nombre, SKU, precio, estado, unidad, GTIN, marca, descripción corta, pesos o categoría.… |
bling_delete_product | Elimina un producto de forma permanente. Los productos utilizados en pedidos o facturas pueden ser rechazados; se prefiere establecer situacao I. Instalado desactivado |
bling_list_product_categories | Lista categorías de productos: id, descricao y categoriaPai (padre). Hasta 100 por página |
bling_get_stock_balances | Obtiene saldos de stock de productos en todos los almacenes: por producto saldoFisicoTotal (físico), saldoVirtualTotal (físico menos reservado… |
bling_get_warehouse_stock_balances | Obtiene saldos de stock de productos en un almacén (deposito): saldoFisico y saldoVirtual por producto |
bling_create_stock_movement | Registra un movimiento de stock para un producto en un almacén: E entrada (entrada), S saida (salida) o B balanco (establece el saldo a la cantidad). Devuelve… |
bling_list_warehouses | Lista almacenes (depositos): id, descricao, situacao, padrao (predeterminado) y desconsiderarSaldo |
bling_list_orders | Lista pedidos de venta (pedidos de venda): id, numero, numeroLoja (número de pedido del marketplace), data, dataSaida, dataPrevista, totalProdutos… |
bling_get_order | Obtiene un pedido de venta: numero, numeroLoja, fechas, contato, situacao, loja, itens (producto, codigo, descricao, quantidade, valor, desconto)… |
bling_create_order | Crea un pedido de venta. Obligatorio: contato (id), data, dataSaida, dataPrevista, itens y parcelas. Devuelve data.id. Crear el pedido no… |
bling_update_order_status | Cambia el estado (situacao) de un pedido de venta, por ejemplo a Em andamento o Atendido. Los ids de estado válidos provienen de bling_list_statuses para… |
bling_delete_order | Elimina un pedido de venta de forma permanente. No se puede deshacer. Instalado desactivado |
bling_list_status_modules | Lista los módulos de Bling que tienen estados (situacoes): id, nome y descricao, por ejemplo Vendas (pedidos de venta). Usa el id con… |
bling_list_statuses | Lista los estados de un módulo: id, nome, cor y idHerdado (el estado estándar del que deriva). Los ids son lo que bling_list_orders y… |
bling_list_contacts | Lista contactos (clientes, proveedores y otros): id, nome, codigo, situacao, numeroDocumento (CPF o CNPJ), telefone y celular. Busca por… |
bling_get_contact | Obtiene un contacto: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral y… |
bling_create_contact | Crea un contacto (cliente o proveedor). nome, tipo y situacao son obligatorios. Devuelve data.id |
bling_update_contact | Reemplaza un contacto (PUT: todo el contacto se reescribe, los campos omitidos pueden vaciarse). Léelo primero con bling_get_contact, cambia lo que… |
bling_list_invoices | Lista NF-e (facturas electrónicas): id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato… |
bling_get_invoice | Obtiene una NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens con impuestos, transporte, parcelas, valorNota, xml (enlace)… |
bling_generate_invoice_from_order | Crea un borrador de NF-e pendiente a partir de un pedido de venta (situacao pendente). No se envía a SEFAZ: la emisión es un paso separado que se realiza en Bling o… |
bling_send_invoice | Emite un NF-e: lo transmite a SEFAZ para autorización. Un NF-e autorizado es un documento fiscal legal que solo puede ser cancelado dentro de la… |
bling_list_receivables | Lista cuentas por cobrar (contas a receber): id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (el pedido o… |
bling_get_receivable | Obtiene una cuenta por cobrar: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto y Pix… |
bling_list_payables | Lista cuentas por pagar (contas a pagar): id, situacao, vencimento, valor, contato y origem. Solo lectura. Hasta 100 por página |
bling_list_payment_methods | Lista métodos de pago (formas de pagamento): id, descricao, tipoPagamento y situacao. El id va en las parcelas de un pedido |
Ejemplos de mensajes
- "¿Qué pedidos de venta de hoy están aún abiertos?"
- "¿Cuál es el stock del producto SKU CAM-PRETA-M en cada almacén?"
- "Crea un borrador de NF-e del pedido de venta 15873."
- "¿Qué cuentas por cobrar vencen esta semana, y por cuánto en BRL?"
- "Mueve el pedido 15873 al estado Em andamento."
Preguntas frecuentes
¿Cómo inicia sesión? Con tu propia aplicación privada de Bling desde Central de Extensoes, Area do Integrador: pega su Client ID y Client Secret, luego haz clic en Authorize with Provider y permite el acceso en Bling. Los tokens se renuevan automáticamente.
¿Puede emitir NF-e? Lee NF-e y crea borradores a partir de pedidos, pero bling_send_invoice, que transmite el NF-e a SEFAZ, se instala desactivado: un NF-e autorizado es un documento fiscal. Las cuentas por cobrar y pagar son solo de lectura.
¿Qué herramientas se instalan desactivadas? bling_send_invoice, bling_delete_product y bling_delete_order. Actívalas en la página del conector solo si la IA debe usarlas.
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Próximos pasos
¿Te ha sido útil esta guía?