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

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

Moss + Gemini

Moss, управление расходами (Германия и Европа): расходы по картам, счетам и возмещениям с позициями и чеками, балансы кошельков и банковские транзакции, поставщики, счета затрат, ставки НДС и центры затрат. Создаёт поставщиков и элементы измерений; платить или утверждать он ничего не может.

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

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

MOSS_KEY_ID, MOSS_SECRET_KEY

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

Настройка занимает около 5 минут. Нужны администратор Moss и мобильное приложение Moss, чтобы подтвердить новый ключ.

1. Войдите в Moss как администратор и откройте Settings, Company Settings, API Keys (также отображается как Settings, Platform, API Keys).
2. Нажмите Generate API Key и подтвердите в мобильном приложении Moss.
3. Скопируйте Key ID (начинается с kid_) в MOSS_KEY_ID, а Secret Key (начинается с sk_) в MOSS_SECRET_KEY. Секрет показывается один раз; если он утерян, создайте новый ключ.
4. Установите коннектор и запустите moss_list_expenses: он вернёт последние расходы и подтвердит ключ.

Коннектор обменивает ключ на токен на один час на /oauth2/token Moss (client credentials) и сам его обновляет. Он запрашивает scope write, который включает read, потому что он нужен инструментам создания и изменения. Если ИИ должен только читать, отключите эти инструменты.

Что он читает: расходы (операции по картам, счета и возмещения) с позициями, суммами нетто, НДС и брутто, счётом затрат и ставкой НДС по каждой позиции, статусом, статусом экспорта и поставщиком; файлы, прикреплённые к расходам (чеки, PDF счетов), которые перечисляет moss_search_files и передаёт вложением moss_download_file; банковские счета Moss (кошельки) с типом финансирования, валютой и статусом, баланс и доступный баланс каждого, а также банковские транзакции за период дат проводки (покупки и возвраты по картам, выплаты, снятия, пополнения, погашения, с датой проводки и датой валютирования, контрагентом и комиссиями); поставщиков с банковскими реквизитами, номером плательщика НДС, условиями оплаты и проводкой по умолчанию; счета затрат с номерами; ставки НДС; условия оплаты с правилами срока и скидки; учётные измерения, такие как центры затрат, носители затрат и проекты, с их элементами; пользователей с командой, руководителем и ролями; команды и отделы.

Фильтры: расходы фильтруются по типу (CARD_TRANSACTION, INVOICE, REIMBURSEMENT), статусу (например SUBMITTED, APPROVED, FLAGGED, REJECTED, REVIEWED, VERIFIED, COMPLETED), статусу экспорта (NOT_EXPORTED, READY_FOR_EXPORT, EXPORT_PENDING, EXPORTED, EXPORT_FAILED), дате создания, дате расхода или последнему изменению и сортируются по статусу, времени создания, сумме в базовой валюте или времени расхода. Банковским транзакциям всегда нужен период дат проводки. Файлы отдельных позиций выводятся, только если переданы и id позиций.

Что он записывает: moss_create_supplier, moss_create_dimension, moss_update_dimension, moss_create_dimension_item (например, новый центр затрат) и moss_update_dimension_item меняют справочные данные для проводок. Они включены при установке; ИИ показывает, что создаст или изменит, и ждёт вашего «да», а также передаёт external_user_id (того, кто попросил), чтобы Moss мог отследить изменение. Поставщиков и элементы измерений можно переводить в ACTIVE или DEACTIVATED; удаление не предусмотрено. Обновлению элемента измерения всегда нужны имя и статус, поэтому для того, что должно остаться, ИИ отправляет текущие значения. Чтобы создать больше измерений, чем по умолчанию, нужен модуль Moss Multiple Dimensions.

Отключено при установке: moss_update_supplier, потому что он может заменить IBAN, на который Moss оплачивает счета поставщика. Администратор включает его осознанно, и тогда ИИ показывает старые и новые значения перед вызовом.

Суммы и даты: суммы — объекты с десятичной строкой amount и currency; homeAmount указан в базовой валюте компании. Даты в формате YYYY-MM-DD, метки времени — ISO 8601 в UTC. ID — UUID.

Ограничения: списки возвращают до 100 элементов на страницу (по умолчанию 50); ИИ запрашивает следующую page, пока meta.pagination.hasMore равно true. Фильтры по id принимают до 100 id. Moss допускает 180 чтений и 20 записей в минуту на организацию.

Частые ошибки: 401 означает, что ключ отозван или токен не удалось выпустить: проверьте MOSS_KEY_ID и MOSS_SECRET_KEY. 402 означает, что модуль Moss не подключён, например Multiple Dimensions. 403 означает, что у токена нет scope. 409 означает, что запись управляется активной интеграцией с бухгалтерией. 422 означает, что указанный id (счёт затрат, ставка НДС, условие оплаты, команда) не существует или неактивен. 429 означает, что лимит запросов исчерпан: дождитесь Retry-After.

Коннектор не может ничего оплатить, утвердить, экспортировать или удалить и не создаёт расходы и не загружает чеки: в Moss Public API нет таких вызовов.

Шаг 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 теперь может вызывать инструменты Moss.

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

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

• «Выведи операции по картам за прошлый месяц, которые всё ещё NOT_EXPORTED, с суммой, поставщиком и счётом затрат.»
• «Какой сейчас доступный баланс у каждого из наших кошельков Moss?»
• «Покажи чек, прикреплённый к расходу Moss на 249,90 EUR от 14 октября.»
• «Просуммируй наши счета за третий квартал по поставщикам и ставкам НДС.»
• «Создай центр затрат 4300 Marketing Events в нашем измерении центров затрат. Сначала покажи, что ты создашь.»

FAQ

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

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

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