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

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

Gusto + Gemini

Дайте ИИ читать данные о зарплате и персонале в Gusto: компанию, её офисы и администраторов, сотрудников с должностями и ставками оплаты, подрядчиков, отделы, графики выплат и расчётные периоды, обработанные расчёты зарплаты с итогами, выплаты подрядчикам, правила и заявки на отпуск, виды начислений и льготы. Расчёт зарплаты только для чтения; создавать и переименовывать можно только отделы. Вход через Gusto OAuth, демо или рабочая среда.

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

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

GUSTO_CLIENT_ID, GUSTO_CLIENT_SECRET, GUSTO_API_URL

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

1. Создайте бесплатный аккаунт в Gusto Developer Portal по адресу https://dev.gusto.com и создайте приложение. Новое приложение начинает работу в среде demo, где используются тестовые компании.
2. В настройках приложения добавьте redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback (если вы размещаете AnythingMCP сами: <your AnythingMCP URL>/api/mcp-oauth/callback). Redirect URI демо-приложения можно изменить в портале; для рабочего приложения их меняет Gusto по запросу.
3. Скопируйте Client ID и Secret приложения в GUSTO_CLIENT_ID и GUSTO_CLIENT_SECRET.
4. Задайте GUSTO_API_URL как https://api.gusto-demo.com для демо-приложения или как https://api.gusto.com, когда Gusto одобрит ваше приложение для рабочей среды. Ключи работают только в своей среде.
5. Чтобы сначала попробовать, создайте в Developer Portal demo company. В ней уже есть примеры сотрудников, подрядчиков и расчётов зарплаты.
6. Установите коннектор, нажмите Authorize with Provider и войдите в Gusto как основной администратор или администратор с полным доступом. Gusto спросит, какую компанию подключить: одна авторизация охватывает одну компанию, поэтому для второй установите коннектор ещё раз.
7. Запустите gusto_get_token_info. Он показывает, с какой компанией работают остальные инструменты и что может читать ваше приложение.

Расчёт зарплаты только для чтения: ИИ читает расчёты зарплаты с итогами, налогами и удержаниями по каждому сотруднику, графики выплат, расчётные периоды и выплаты подрядчикам, но не может готовить, рассчитывать, отправлять или отменять расчёт зарплаты, платить подрядчикам, добавлять или увольнять сотрудников и менять оплату. Изменить он может только две вещи: создать отдел (gusto_create_department) и переименовать его (gusto_update_department, при установке отключён), и оба действия он сначала подтверждает у вас.

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

Права выдаёт Gusto: при входе вы не выбираете scopes. Gusto назначает их вашему приложению: широко в среде demo и в рабочей среде после своей проверки. Для ставок оплаты нужен scope compensations:read, а для льгот с медицинской информацией нужны scopes :phi. На вызов за пределами scopes вашего приложения приходит ответ 403.

Токены: access-токены действуют два часа и обновляются автоматически. Gusto заменяет refresh-токен при каждом обновлении, поэтому не используйте ту же авторизацию одновременно в другом инструменте: одному из них пришлось бы входить заново.

Частые ошибки: 401 означает, что авторизация отозвана, поэтому снова нажмите Authorize with Provider. 403: у вашего приложения нет нужного scope, или компания не та, которую вы авторизовали. 406: версия API, которую отправляет коннектор, выходит за пределы допустимых для вашего приложения (минимальная версия видна в Developer Portal). 429: больше 200 запросов за минуту, подождите минуту.

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

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

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

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

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

FAQ

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

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

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