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

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

Plaid + Gemini

Дайте вашему ИИ читать банковские данные через Plaid: счета, балансы в реальном времени, транзакции за период или в виде инкрементальной синхронизации, данные владельцев, номера счетов и routing numbers и статус каждого подключённого банка, а также поиск банков и шаги с токенами Link. С client ID и secret от Plaid, в песочнице или в боевом режиме.

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

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

PLAID_CLIENT_ID, PLAID_SECRET

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

1. Войдите в Plaid Dashboard на dashboard.plaid.com (для песочницы хватит бесплатного аккаунта) и откройте страницу Keys в настройках для разработчиков.
2. Скопируйте ваш client_id в PLAID_CLIENT_ID, а secret нужной среды в PLAID_SECRET. У каждой среды свой secret: secret Sandbox работает сразу, а secret Production только после того, как Plaid одобрит вашу команду для боевого режима.
3. Установите коннектор. Шага Authorize with Provider нет: коннектор передаёт PLAID_CLIENT_ID и PLAID_SECRET как client_id и secret в JSON-теле каждого запроса, как этого ждёт Plaid, а не в заголовке.
4. Среду определяет только Base URL коннектора, после установки это https://sandbox.plaid.com. Чтобы работать с настоящими банками, отредактируйте данные коннектора, укажите в Base URL адрес https://production.plaid.com и возьмите боевой secret. Отдельной переменной окружения для этого нет, и secret должен быть из той же среды, что и Base URL.
5. Начните с plaid_institutions_search, например с запроса Chase и кода страны US: ему не нужен подключённый банк, поэтому он проверяет только, верны ли client ID и secret.

Подключение банка: каждый подключённый вход в банк Plaid называет Item, и у каждого Item свой access_token. Этот токен выдаёт Plaid Link, окно, в котором владелец счёта выбирает банк и входит в него. plaid_link_token_create создаёт link_token, с которым ваше приложение или веб-страница открывает Link; после входа Link возвращает public_token, который действует 30 минут и используется один раз, а plaid_item_public_token_exchange обменивает его на долгоживущий access_token и item_id. Сам коннектор показать Link не может. В песочнице в любой тестовый банк можно войти с логином user_good и паролем pass_good, или создать тестовый Item без Link через эндпоинт Plaid /sandbox/public_token/create (это не инструмент коннектора) и обменять результат с помощью plaid_item_public_token_exchange.

Каким инструментам нужен access token: семь инструментов читают один Item и принимают его access_token как параметр: plaid_item_get, plaid_accounts_get, plaid_accounts_balance_get, plaid_transactions_get, plaid_transactions_sync, plaid_identity_get и plaid_auth_get. Для plaid_institutions_search и plaid_link_token_create достаточно client ID и secret, для plaid_item_public_token_exchange нужен public_token. Коннектор не хранит access tokens: вы передаёте токен ИИ в разговоре или в своих инструкциях. Вместе с client ID и secret он открывает данные этого банка, так что обращайтесь с ним как с паролем. Токены начинаются с access-sandbox- или access-production- и работают только в своей среде.

Всё через POST, почти всё только чтение: API Plaid принимает каждый запрос как POST, поэтому и коннектор шлёт POST, но что-то создают только plaid_link_token_create и plaid_item_public_token_exchange (токен для Link и access token). Ни один инструмент не двигает деньги, не меняет счёт и не удаляет Item.

Разрешения и режим только для чтения: Item даёт доступ только к продуктам, с которыми он был подключён (список products в plaid_link_token_create): plaid_transactions_get и plaid_transactions_sync требуют transactions, plaid_identity_get требует identity, plaid_auth_get требует auth. plaid_auth_get возвращает полные номера счетов и routing numbers, а plaid_identity_get имена, e-mail, телефоны и адреса владельцев; отключите их на странице коннектора, если ИИ они не нужны. Если access tokens у вас уже есть, можно отключить и два инструмента для токенов.

Транзакции: plaid_transactions_get читает период (start_date и end_date в формате YYYY-MM-DD), по умолчанию 100 на страницу и до 500 через count и offset в options. Насколько далеко в прошлое он заглядывает, зависит от истории, запрошенной при подключении банка: у Plaid по умолчанию 90 дней, максимум 730 дней, а plaid_link_token_create больше не запрашивает. plaid_transactions_sync возвращает то, что добавилось, изменилось или удалилось с прошлого вызова: начните без cursor, а затем передавайте next_cursor, пока has_more равно true. Сразу после подключения транзакции могут появиться только через несколько минут.

Балансы: plaid_accounts_get показывает счета с балансами, которые Plaid держит в кеше. plaid_accounts_balance_get запрашивает банк в реальном времени, работает медленнее и в боевом режиме может оплачиваться за каждый вызов, в зависимости от вашего договора с Plaid.

Лимиты запросов: зависят от среды и продукта. При превышении Plaid отвечает 429 с RATE_LIMIT_EXCEEDED: подождите немного и попробуйте снова.

Частые ошибки: INVALID_API_KEYS означает неверный client ID или secret либо secret из другой среды, чем Base URL. INVALID_ACCESS_TOKEN означает, что токен скопирован с ошибкой или взят из другой среды. ITEM_LOGIN_REQUIRED означает, что вход в банк изменился или срок согласия истёк: владельцу нужно заново войти через Link в вашем собственном приложении, запустить это коннектор не может. PRODUCT_NOT_READY сразу после подключения означает, что транзакции ещё загружаются. PRODUCTS_NOT_SUPPORTED означает, что банк или Item не поддерживает этот продукт.

Коннектор не работает с вебхуками, платежами и переводами, инвестициями и обязательствами, проверкой доходов и занятости, риск-скорингом, режимом обновления Link и удалением Item.

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

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

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

• «Покажи счета банковского подключения, access token которого я только что дал, с текущим и доступным балансом.»
• «Покажи все транзакции больше 500 USD по бизнес-счёту за сентябрь 2026 года, сгруппированные по категориям.»
• «Поддерживает ли Plaid банк Chase в США для transactions и auth?»
• «Проверь, работает ли ещё это банковское подключение или нужен повторный вход, и какие продукты на нём включены.»

FAQ

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

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

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