Как подключить BILL (Bill.com) к Gemini через MCP

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

BILL (Bill.com) + Gemini

Расчёты с поставщиками и клиентами в BILL (Bill.com): поставщики, входящие счета, регулярные счета, кредиты поставщиков, согласование счетов и политики согласования, платежи поставщикам, клиенты, исходящие счета, кредит-ноты и полученные платежи. BILL v3 API с developer key и входом пользователя; согласование счетов есть, но при установке отключено.

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

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

BILL_API_URL, BILL_DEV_KEY, BILL_ORGANIZATION_ID, BILL_USERNAME, BILL_PASSWORD

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

1. Для доступа к API BILL нужен developer key. Его создаёт администратор в веб-приложении BILL: Settings → Sync & Integrations → Manage Developer Keys → Generate developer key. Чтобы сначала попробовать, зарегистрируйте sandbox-аккаунт разработчика на https://developer.bill.com, к нему прилагается sandbox-ключ. Вставьте ключ в BILL_DEV_KEY.
2. Скопируйте ID организации внизу той же страницы Manage Developer Keys в BILL_ORGANIZATION_ID. Он начинается с 008.
3. Укажите e-mail и пароль пользователя BILL этой организации в BILL_USERNAME и BILL_PASSWORD. Используйте отдельного пользователя для API: его роль в BILL ограничивает, что ИИ может видеть и делать.
4. Задайте BILL_API_URL как https://gateway.prod.bill.com/connect для рабочей среды или как https://gateway.stage.bill.com/connect для sandbox. Sandbox developer key не работает в рабочей среде, и наоборот.
5. Установите коннектор и сначала запустите bill_com_get_session. Он проверяет вход и показывает, от имени какой организации и какого пользователя работает коннектор.

Сессии: коннектор входит под этим пользователем и сам следит за сессией. Сессия заканчивается после 35 минут бездействия, и коннектор просто входит заново.

Что он читает: BILL (ранее Bill.com) ведёт расчёты с поставщиками и клиентами для компаний из США. По расчётам с поставщиками ИИ читает поставщиков, входящие счета со сроком оплаты, статусом оплаты и согласования, регулярные счета, кредиты поставщиков, платежи поставщикам, политики согласования и счета, ожидающие вашего согласования. По расчётам с клиентами он читает клиентов, исходящие счета, кредит-ноты и полученные платежи.

С чего начать: спросите о неоплаченных и частично оплаченных счетах по сроку оплаты, о счетах, ожидающих вашего согласования, или об исходящих счетах клиентам, которые ещё открыты или оплачены частично.

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

Ограничения: 20 000 запросов на developer key в час, 3 одновременных запроса на организацию и 200 входов на developer key в час. Ошибки BDC_1144 и BDC_1322 означают, что достигнут лимит: подождите и повторите.

Коннектор не проводит платежи и не создаёт входящие или исходящие счета.

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

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

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

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

FAQ

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

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

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