Как подключить Haufe X360 к Gemini через MCP

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

Haufe X360 + Gemini

Облачная ERP Haufe X360 (немецкая редакция Acumatica): клиенты, поставщики, складские позиции, заказы на продажу, счета клиентам и отгрузки через contract-based REST API. Вход в сессию с пользователем X360. Только чтение.

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

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

X360_URL, X360_TENANT, X360_ENDPOINT_VERSION, X360_USERNAME, X360_PASSWORD

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

1. Попросите администратора X360 или партнёра Haufe создать отдельного пользователя для интеграции с ролями для тех экранов, которые он должен читать: клиенты, поставщики, складские позиции, заказы на продажу, счета и отгрузки. X360 проверяет те же права доступа, что и в браузере, поэтому ИИ видит только то, что разрешено этому пользователю.
2. Укажите в X360_URL адрес, по которому вы открываете X360 в браузере, до /Main или /Frames (не включая их) и без завершающей косой черты.
3. Укажите в X360_TENANT имя тенанта (компании), которое вы выбираете на экране входа в X360.
4. Укажите в X360_ENDPOINT_VERSION версию эндпоинта Default из формы Web Service Endpoints (SM207060), например 24.200.001. Более старые версии, такие как 20.200.001 или 23.200.001, тоже подходят: поля, которые используют эти инструменты, во всех одинаковы.
5. Заполните X360_USERNAME и X360_PASSWORD данными входа пользователя для интеграции.
6. Установите коннектор и запустите haufe_x360_list_customers с небольшим числом записей, чтобы проверить подключение.

Основан на Acumatica: Haufe X360 является немецкой редакцией Acumatica, и в каждом тенанте X360 есть предопределённый веб-сервисный эндпоинт Acumatica Default. Именно его читает коннектор.

Только чтение по замыслу: ИИ читает клиентов, поставщиков, складские позиции, заказы на продажу, счета клиентам с кредит-нотами и отгрузки. Ни один инструмент не создаёт, не изменяет и не проводит документы.

Сессии и лицензия: лицензия X360 ограничивает, сколько API-сессий может быть открыто одновременно. Коннектор держит одну сессию, использует её для всех вызовов и входит заново, когда она истекает.

Сначала немного записей: без ограничения API возвращает все записи, поэтому при первом вызове ИИ всегда запрашивает ограниченное число записей. Строки заказов и счетов приходят, только если он раскрывает Details; иначе он читает только заголовок.

На что он хорошо отвечает: какие счета клиентам ещё не оплачены и на какую сумму (haufe_x360_list_invoices), заказы на продажу по статусам с их строками (haufe_x360_list_sales_orders), какие заказы на продажу закрывает отгрузка (haufe_x360_list_shipments), а также условия оплаты и кредитные настройки клиента (haufe_x360_get_customer).

Создание, изменение и проведение документов не входят в задачи коннектора, как и всё, что выходит за рамки клиентов, поставщиков, складских позиций, заказов на продажу, счетов клиентам и отгрузок.

Шаг 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 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Haufe X360.

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

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

• «Какие счета клиентам просрочены и сколько ещё не оплачено по каждому клиенту?»
• «Покажи открытые заказы на продажу клиента C000123 со строками и суммой заказа.»
• «Какие отгрузки ушли на прошлой неделе и какие заказы на продажу закрыла каждая из них?»
• «Перечисли наших активных поставщиков с классом поставщика и условиями оплаты.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot