Как подключить easybill к Meta Muse через MCP

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

easybill + Meta Muse

Дайте ИИ работать с вашим аккаунтом easybill: находить клиентов и заводить новых, выводить счета, кредит-ноты, коммерческие предложения, напоминания об оплате и накладные по клиенту, дате или статусу оплаты, читать позиции и итоги, получать документы в PDF и смотреть каталог товаров. Нужен API-ключ из вашего профиля easybill.

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

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

EASYBILL_API_KEY

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

1. Войдите в easybill, нажмите на значок пользователя справа вверху и выберите Profil und Einstellungen (профиль и настройки; интерфейс easybill на немецком).
2. В открывшемся окне перейдите к разделу API-ключа, нажмите Neuen Schlüssel generieren (создать новый ключ), а затем Speichern (сохранить) справа вверху. Если раздела с API-ключом нет, попросите поддержку easybill включить доступ к API для вашего аккаунта.
3. Скопируйте ключ в EASYBILL_API_KEY. Коннектор передаёт его как Bearer-токен на https://api.easybill.de/rest/v1; URL, ID аккаунта и другие настройки заполнять не нужно.
4. Установите коннектор. Шага Authorize with Provider нет: достаточно ключа, а AnythingMCP хранит его в зашифрованном виде.
5. Начните с easybill_list_customers с небольшим limit, например 5, и проверьте, что ключ ведёт к нужному аккаунту easybill.

Один инструмент для всех типов документов: счета, кредит-ноты, коммерческие предложения, напоминания об оплате и накладные выдаёт easybill_list_documents с фильтром type (INVOICE, CREDIT, OFFER, REMINDER, DELIVERY, несколько значений через запятую). Также он фильтрует по customer_id, по document_date (одна дата YYYY-MM-DD или период вида 2026-01-01,2026-03-31) и по paid_at, где значение null возвращает только неоплаченные документы. easybill_get_document читает один документ с позициями, НДС по каждой позиции (vat_percent), итогами и статусом оплаты, а easybill_get_document_pdf возвращает готовый PDF в кодировке base64 в поле pdf.

ID и номера: у каждого клиента и документа в easybill, помимо номера из интерфейса (номер клиента, номер счёта), есть числовой id. easybill_get_customer, easybill_get_document, easybill_get_document_pdf и фильтр customer_id ожидают именно id, поэтому ИИ сначала находит его через инструмент списка. easybill_list_customers ищет по company_name, last_name, emails, number (номер клиента) и country (ISO-код, например DE).

Создание клиентов: easybill_create_customer это единственный инструмент, который что-то записывает. Ему нужно хотя бы company_name или last_name, а также он принимает first_name, адрес, emails и номер плательщика НДС в vat_identifier. Попросите ИИ показать данные до создания клиента, чтобы не появились дубликаты.

Разрешения и режим только для чтения: чтобы ИИ только читал данные, отключите easybill_create_customer на странице коннектора. Остальные шесть инструментов лишь читают клиентов, документы, PDF и каталог товаров (easybill_list_positions, с артикулом, описанием, ценой за единицу и ставкой НДС).

Длинные списки: инструменты списков по умолчанию возвращают 100 строк на страницу, с limit до 1000. В ответе есть page, pages и total, и ИИ листает дальше через page. Суммы указаны в валюте каждого документа.

Частые ошибки: 401 означает, что ключ не указан или неверен: скопируйте его заново из Profil und Einstellungen или создайте там новый и обновите EASYBILL_API_KEY. 404 для отдельного клиента или документа обычно означает, что ИИ передал номер из интерфейса easybill вместо числового id.

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

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

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

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси Muse о том, для чего нужны инструменты easybill.

Настроить коннектор можно и из чата: в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

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

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

• «Какие счета ещё не оплачены и сколько всего нам должен каждый клиент?»
• «Найди нашего клиента Müller GmbH и достань PDF его последнего счёта.»
• «Покажи все коммерческие предложения за первый квартал 2026 года с клиентом, датой и суммой.»
• «Создай нового клиента: Schneider Holzbau GmbH, Hauptstraße 12, 79098 Freiburg, Германия, номер плательщика НДС DE123456789, [email protected]. Сначала покажи мне данные.»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

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

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