Как подключить Xentral к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Xentral ERP, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Xentral + Cursor

Подключите Xentral ERP к вашему ИИ: ищите товары и остатки по складам и местам хранения, клиентов и поставщиков, заказы клиентов, накладные с отслеживанием отправлений, счета со статусом оплаты, кредит-ноты, заказы поставщикам и входящие счета поставщиков, а также создавайте черновики заказов. Через актуальный API Xentral с Personal Access Token.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

XENTRAL_URL, XENTRAL_TOKEN

Шаг 1 — Получите учётные данные

1. В Xentral нажмите Administration слева внизу, затем Account settings (Kontoeinstellungen) → Developer settings (Developer Einstellungen) → Personal Access Tokens. Быстрее: введите «Personal Access Token» в Smart Search. Для этого нужна учётная запись администратора.
2. Нажмите Create token (Token erzeugen) и задайте токену имя, например AnythingMCP-Read, описание и срок действия (по умолчанию 180 дней).
3. Выдайте Read на разделы, которые должен видеть ИИ: товары и остатки, клиенты (CRM), документы продаж (заказы клиентов, накладные, счета, кредит-ноты), закупки (заказы поставщикам, поставщики, обязательства) и настройки, например способы оплаты и проекты. Create и Delete на заказы клиентов добавляйте, только если ИИ может готовить черновики заказов. Scopes уровня Admin не выдавайте.
4. Нажмите Create и сразу скопируйте токен: Xentral показывает его только один раз.
5. Укажите в XENTRAL_URL адрес, по которому вы открываете Xentral, например https://acme.xentral.biz (или ваш собственный домен), без /api, без пути и без косой черты в конце. Вставьте токен в XENTRAL_TOKEN как есть, без слова Bearer, затем установите коннектор.
6. Начните с xentral_list_products: если вернулись товары, URL и токен работают.

Срок действия и права токена: токен истекает в выбранную вами дату, а токены, которыми не пользовались 180 дней, Xentral удаляет. Права токена нельзя изменить позже: чтобы их поменять, создайте новый токен и замените XENTRAL_TOKEN. ИИ видит только те разделы, которые токен может читать.

Идентификаторы, а не печатные номера: каждый инструмент принимает внутренний идентификатор Xentral, а не номер товара, документа или клиента, напечатанный на бумаге. Сначала ИИ находит идентификатор через инструмент списка, с фильтром по number, documentNumber или customerNumber либо через search. Идентификатор клиента одновременно является идентификатором его адреса: в документах он отображается как address.id, а xentral_create_sales_order принимает его как addressId. Фильтры по клиентам ищут только точные совпадения, поэтому, чтобы найти клиента по части имени, ИИ ищет его документы через xentral_list_invoices или xentral_list_sales_orders и берёт оттуда address.id.

Фильтры: инструменты списков принимают условия, которые должны выполняться все сразу; у каждого есть поле (key), оператор (op) и значение (value). Например, неоплаченные счета: [{"key": "paymentStatus", "op": "in", "value": ["pending", "partiallyPaid"]}]. Среди операторов есть equals, in, contains, startsWith, greaterThanOrEquals и lessThan; каждый инструмент перечисляет поля, которые он принимает. Даты документов указываются в формате YYYY-MM-DD.

Поиск и сортировка документов: для заказов клиентов, накладных, счетов, кредит-нот и заказов поставщикам search ищет по номеру документа, имени и номеру клиента или поставщика, email, почтовому индексу и внешним номерам заказов. sort принимает имена полей, минус перед именем сортирует по убыванию (-documentDate), а include добавляет связанные данные, например lineItems (позиции) или address.

Статусы: заказы клиентов бывают draft, released, completed или cancelled; у счетов, накладных и заказов поставщикам есть ещё sent. Статус оплаты (paymentStatus) счетов и кредит-нот: pending, paid, partiallyPaid, cancelled, partiallyCancelled, badDebt или debited.

Остатки: xentral_get_product_stock возвращает итоги и те же показатели по каждому складу и каналу продаж. sellable показывает, что ещё можно пообещать клиенту, physical то, что лежит на полках, reserved то, что удерживают открытые заказы. Склады (Lager) состоят из мест хранения (Lagerplätze): xentral_list_product_storage_locations показывает, где лежит товар, а xentral_list_storage_location_items что лежит в одном месте хранения.

Отправления и оплаты: xentral_list_delivery_note_shipments возвращает перевозчика, трек-номер и ссылку для отслеживания по накладной. xentral_get_invoice_balance показывает платежи, проведённые по счёту, и сколько ещё осталось оплатить.

Страницы: списки документов принимают page и perPage (до 1000, по умолчанию 25), остальные списки page и pageSize (от 10 до 50).

Запись: xentral_create_sales_order создаёт только черновик для существующего клиента: без номера заказа, ничего не резервируется и не отгружается, пока кто-то не проверит и не проведёт его в Xentral. Если ИИ не указывает цены, Xentral берёт цены клиента и товара. xentral_delete_sales_order_draft удаляет такой черновик и выключен при установке; проведённые, выполненные или отменённые заказы Xentral удалить не даёт. Все остальные инструменты только читают.

Режим только для чтения: выдайте токену только права Read и отключите xentral_create_sales_order на странице коннектора.

Лимит запросов: Xentral допускает около 100 запросов в минуту на инстанс, независимо от тарифа; сверх этого он отвечает 429 с заголовком Retry-After. Один отфильтрованный список лучше множества отдельных запросов.

Частые ошибки: 401 означает, что токен неверный, истёк или удалён. 403 означает, что у токена нет прав на этот раздел: создайте новый токен с нужными правами. 400 «Generic request validation failed» или «filter must be an array» указывает на поле фильтра или оператор, которые инструмент не принимает, либо на неверно сформированное значение. 404 «Route not found» означает, что в XENTRAL_URL есть путь вроде /api/v1 или инстанс ещё не предоставляет этот endpoint. 409 при удалении заказа клиента означает, что он уже не черновик.

Шаг 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" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Xentral.

Доступные инструменты

Примеры запросов

• «Сколько единиц товара 700123 мы ещё можем продать на каждом складе и в каких местах хранения он лежит?»
• «Какие счета ещё не оплачены или оплачены частично? Покажи клиента, сумму и уровень напоминания, сначала самые старые.»
• «Где посылка по заказу 200345? Назови перевозчика и дай ссылку для отслеживания.»
• «Создай черновик заказа для клиента 10001: 20 штук товара 700123 и 5 штук товара 700456, желаемая дата доставки 20 октября.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT