Кратко
Bling ERP API v3 (Бразилия): продукты и категории, остатки и движения на складах, склады, заказы на продажу и статусы, контакты, чтение и черновики NF-e, дебиторская и кредиторская задолженность (только чтение). Выпуск NF-e отключен. Вход через OAuth 2 с использованием собственного приложения Bling.
Пошаговая настройка
Подключи Bling к Cursor за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Bling в пошаговой настройке и добавь свой MCP URL в Cursor. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Bling
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Bling, вставь Client ID и Client Secret своего приложения Bling, нажми Authorize with Provider и разреши доступ в Bling, создай ключ API MCP, и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Bling + Cursor
Bling ERP API v3 (Бразилия): продукты и категории, остатки и движения на складах, склады, заказы на продажу и статусы, контакты, чтение и черновики NF-e, дебиторская и кредиторская задолженность (только чтение). Выпуск NF-e отключен. Вход через OAuth 2 с использованием собственного приложения Bling.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
BLING_CLIENT_ID, BLING_CLIENT_SECRET
Шаг 1 — Получи учетные данные
Настройка занимает около 10 минут.
- В Bling открой Central de Extensoes, Area do Integrador и нажми Criar aplicativo. Выбери видимость Privado (тогда он будет работать только с твоей учетной записью Bling, без проверки Bling).
- Заполни название и контактные данные. В качестве Link de redirecionamento введи
https://cloud.anythingmcp.com/api/mcp-oauth/callbackна AnythingMCP Cloud или<твой URL AnythingMCP>/api/mcp-oauth/callback, если ты хостишь AnythingMCP сам. - Выбери scopes, которые нужны этому коннектору: продукты, остатки, склады, заказы на продажу, контакты, NF-e, дебиторская и кредиторская задолженность, способы оплаты, статусы и данные компании. Сохрани. Изменение scopes позже выведет всех пользователей из системы.
- На вкладке Informacoes do app скопируй Client ID и Client Secret в
BLING_CLIENT_IDиBLING_CLIENT_SECRET, сохрани коннектор и нажми Authorize with Provider, затем войди в Bling и разреши доступ.
Токены доступа действуют 6 часов и обновляются с помощью refresh token, который действует 30 дней: коннектор, не использовавшийся дольше этого времени, нуждается в повторном Authorize with Provider. Bling блокирует адрес на час после 20 запросов токенов за минуту, поэтому не пытайся войти в систему в цикле.
С чего начать: bling_get_company проверяет соединение. Затем bling_list_orders (фильтрация по дате или статусу) и bling_get_order, или bling_list_products и bling_get_product.
Продукты и остатки: 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 установлен отключенным. saldoVirtual — это физический остаток минус то, что резервируют открытые заказы.
Заказы на продажу: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Идентификаторы статусов различаются для каждой учетной записи: получи их с помощью bling_list_status_modules (модуль Vendas) и bling_list_statuses. bling_delete_order установлен отключенным. Никакой инструмент не проводит дебиторскую задолженность или производит расчеты.
Контакты: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (заменяет весь контакт: сначала прочитай его).
NF-e: bling_list_invoices, bling_get_invoice (с ссылками на DANFE и XML), bling_generate_invoice_from_order (создает только ожидающий черновик). bling_send_invoice, который передает NF-e в SEFAZ, установлен отключенным: авторизованный NF-e является налоговым документом. Включай его только осознанно.
Финансы (только чтение): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. Коннектор никогда не перемещает деньги: никаких расчетов (baixa), boleto или действий Pix не предусмотрено.
Примечания по полям: идентификаторы — это числа. Суммы указаны в BRL с десятичной точкой. Даты в формате YYYY-MM-DD; диапазон дат может охватывать не более одного года. CPF и CNPJ указываются цифрами. Ответы обернуты в data; ошибки содержат error.type, error.message, error.description и error.fields, указывая на недопустимое поле.
Пагинация и лимиты: списки принимают pagina от 1 и limite до 100; пустой список data означает конец. Bling позволяет 3 запроса в секунду и 120,000 в день на учетную запись (429 выше); 300 ошибок или 600 запросов в течение 10 секунд блокируют адрес на 10 минут, поэтому не повторяй неудачные вызовы в цикле.
Шаг 2 — Установи адаптер
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
Шаг 3 — Добавь коннектор в Cursor
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо
YOUR_MCP_API_KEY. - Сохрани файл и перезапусти Cursor.
- Открой Cursor → Settings → MCP и проверь, что
anythingmcpесть в списке и подключён. - Начинай общаться: агент теперь может вызывать инструменты
Bling.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
bling_get_company | Получает основные данные учетной записи Bling, в которую подписан коннектор: id, nome (название компании), cnpj, email и dataContrato. Дешевый вызов… |
bling_list_products | Список продуктов: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (виртуальный баланс), tipo, situacao, formato, descricaoCurta… |
bling_get_product | Получает один продукт со всеми деталями: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque… |
bling_create_product | Создает продукт или услугу. nome, tipo, situacao и formato обязательны. Возвращает data.id нового продукта (и его вариаций). Налог… |
bling_update_product | Изменяет продукт (PATCH: только отправленные поля изменяются): name, SKU, price, status, unit, GTIN, brand, short description, weights или category.… |
bling_delete_product | Удаляет продукт навсегда. Продукты, используемые в заказах или счетах, могут быть отклонены; предпочтительно установить situacao I. Установлен отключенным |
bling_list_product_categories | Список категорий продуктов: id, descricao и categoriaPai (родительская). До 100 на странице |
bling_get_stock_balances | Получает остатки на складах продуктов по всем складам: для каждого продукта saldoFisicoTotal (физический), saldoVirtualTotal (физический минус зарезервированный… |
bling_get_warehouse_stock_balances | Получает остатки на складах продуктов в одном складе (deposito): saldoFisico и saldoVirtual для каждого продукта |
bling_create_stock_movement | Регистрирует движение на складе для продукта в складе: E entrada (вход), S saida (выход) или B balanco (устанавливает баланс на количество). Возвращает… |
bling_list_warehouses | Список складов (depositos): id, descricao, situacao, padrao (по умолчанию) и desconsiderarSaldo |
bling_list_orders | Список заказов на продажу (pedidos de venda): id, numero, numeroLoja (номер заказа на маркетплейсе), data, dataSaida, dataPrevista, totalProdutos… |
bling_get_order | Получает один заказ на продажу: numero, numeroLoja, даты, contato, situacao, loja, itens (produto, codigo, descricao, quantidade, valor, desconto)… |
bling_create_order | Создает заказ на продажу. Обязательные поля: contato (id), data, dataSaida, dataPrevista, itens и parcelas. Возвращает data.id. Создание заказа не… |
bling_update_order_status | Изменяет статус (situacao) заказа на продажу, например, на Em andamento или Atendido. Действительные идентификаторы статусов получаются из bling_list_statuses для… |
bling_delete_order | Удаляет заказ на продажу навсегда. Не может быть отменено. Установлен отключенным |
bling_list_status_modules | Список модулей Bling, которые имеют статусы (situacoes): id, nome и descricao, например, Vendas (заказы на продажу). Используй id с… |
bling_list_statuses | Список статусов одного модуля: id, nome, cor и idHerdado (стандартный статус, от которого он происходит). Идентификаторы — это то, что bling_list_orders и… |
bling_list_contacts | Список контактов (клиенты, поставщики и другие): id, nome, codigo, situacao, numeroDocumento (CPF или CNPJ), telefone и celular. Поиск по… |
bling_get_contact | Получает один контакт: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral и… |
bling_create_contact | Создает контакт (клиент или поставщик). nome, tipo и situacao обязательны. Возвращает data.id |
bling_update_contact | Заменяет контакт (PUT: весь контакт переписывается, пропущенные поля могут быть очищены). Сначала прочитай его с помощью bling_get_contact, измени то… |
bling_list_invoices | Список NF-e (электронные счета): id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato… |
bling_get_invoice | Получает один NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens с налогами, transporte, parcelas, valorNota, xml (ссылка)… |
bling_generate_invoice_from_order | Создает ожидающий черновик NF-e из заказа на продажу (situacao pendente). Он не отправляется в SEFAZ: выпуск — это отдельный шаг, выполняемый в Bling или… |
bling_send_invoice | Выпускает NF-e: передает его в SEFAZ для авторизации. Авторизованный NF-e является юридическим налоговым документом, который можно отменить только в… |
bling_list_receivables | Список дебиторской задолженности (contas a receber): id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (заказ или… |
bling_get_receivable | Получает одну дебиторскую задолженность: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto и Pix… |
bling_list_payables | Список кредиторской задолженности (contas a pagar): id, situacao, vencimento, valor, contato и origem. Только для чтения. До 100 на странице |
bling_list_payment_methods | Список способов оплаты (formas de pagamento): id, descricao, tipoPagamento и situacao. Идентификатор идет в parcelas заказа |
Примеры подсказок
- "Какие заказы на продажу с сегодняшнего дня все еще открыты?"
- "Каков остаток продукта SKU CAM-PRETA-M на каждом складе?"
- "Создать черновик NF-e из заказа на продажу 15873."
- "Какие дебиторские задолженности подлежат оплате на этой неделе и на какую сумму в BRL?"
- "Переместить заказ 15873 в статус Em andamento."
Часто задаваемые вопросы
Как происходит вход? С помощью собственного частного приложения Bling из Central de Extensoes, Area do Integrador: вставь его Client ID и Client Secret, затем нажми Authorize with Provider и разреши доступ в Bling. Токены обновляются автоматически.
Может ли он выпускать NF-e? Он читает NF-e и создает черновики из заказов, но bling_send_invoice, который передает NF-e в SEFAZ, установлен отключенным: авторизованный NF-e является налоговым документом. Дебиторская и кредиторская задолженность доступны только для чтения.
Какие инструменты установлены отключенными? bling_send_invoice, bling_delete_product и bling_delete_order. Включай их на странице коннектора только если ИИ должен их использовать.
Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да — MCP доступен на тарифах Hobby, Pro и Business.
Следующие шаги
Это руководство помогло?