Cómo conectar Plaid a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Plaid, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Plaid + Gemini

Deja que tu IA lea datos bancarios con Plaid: cuentas, saldos en tiempo real, transacciones por fechas o en sincronización incremental, identidad de los titulares, números de cuenta y routing y el estado de cada banco vinculado, además de la búsqueda de entidades y los tokens de Link. Con el client ID y el secret de Plaid.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PLAID_CLIENT_ID, PLAID_SECRET

Paso 1 — Obtener credenciales

1. Inicia sesión en el Plaid Dashboard en dashboard.plaid.com (para el sandbox basta una cuenta gratuita) y abre la página Keys en la configuración para desarrolladores.
2. Copia tu client_id en PLAID_CLIENT_ID y el secret del entorno que quieras usar en PLAID_SECRET. Cada entorno tiene su propio secret: el de Sandbox funciona al momento, el de Production solo cuando Plaid haya aprobado a tu equipo para producción.
3. Instala el conector. No hay ningún paso Authorize with Provider: el conector pone PLAID_CLIENT_ID y PLAID_SECRET como client_id y secret en el cuerpo JSON de cada llamada, como espera Plaid, no en una cabecera.
4. El entorno lo decide solo la Base URL del conector, que tras la instalación es https://sandbox.plaid.com. Para trabajar con bancos reales, edita los detalles del conector, pon la Base URL en https://production.plaid.com y usa el secret de producción. No hay una variable de entorno aparte para esto, y el secret tiene que ser del entorno de la Base URL.
5. Empieza con plaid_institutions_search, por ejemplo buscando Chase con el código de país US: no necesita ningún banco vinculado, así que solo comprueba que el client ID y el secret son correctos.

Vincular un banco: Plaid llama Item a cada acceso bancario vinculado, y cada Item tiene su propio access_token. Ese token sale de Plaid Link, la ventana en la que el titular elige su banco e inicia sesión. plaid_link_token_create crea el link_token con el que tu app o página web abre Link; tras el inicio de sesión, Link devuelve un public_token, válido 30 minutos y de un solo uso, y plaid_item_public_token_exchange lo convierte en el access_token duradero más el item_id. El conector no puede mostrar Link por sí mismo. En el sandbox entras en cualquier banco de prueba con el usuario user_good y la contraseña pass_good, o creas un Item de prueba sin Link con el endpoint /sandbox/public_token/create de Plaid (no es una herramienta de este conector) y canjeas el resultado con plaid_item_public_token_exchange.

Qué herramientas necesitan un access token: siete herramientas leen un Item y piden su access_token como parámetro: plaid_item_get, plaid_accounts_get, plaid_accounts_balance_get, plaid_transactions_get, plaid_transactions_sync, plaid_identity_get y plaid_auth_get. plaid_institutions_search y plaid_link_token_create solo necesitan el client ID y el secret, plaid_item_public_token_exchange un public_token. El conector no guarda access tokens: le das el token a la IA en la conversación o en tus instrucciones. Junto con tu client ID y secret abre los datos de ese banco, así que trátalo como una contraseña. Los tokens empiezan por access-sandbox- o access-production- y solo funcionan en ese entorno.

Todo POST, casi todo lectura: la API de Plaid recibe cada llamada como POST, y el conector también, pero solo plaid_link_token_create y plaid_item_public_token_exchange crean algo (un token de Link y un access token). Ninguna herramienta mueve dinero, cambia una cuenta ni elimina un Item.

Permisos y solo lectura: un Item solo alcanza los productos con los que se vinculó (la lista products de plaid_link_token_create): plaid_transactions_get y plaid_transactions_sync necesitan transactions, plaid_identity_get necesita identity y plaid_auth_get necesita auth. plaid_auth_get devuelve números de cuenta y routing numbers completos, y plaid_identity_get nombres, correos, teléfonos y direcciones de los titulares; desactívalas en la página del conector si la IA no las necesita. Si ya tienes tus access tokens, también puedes desactivar las dos herramientas de tokens.

Transacciones: plaid_transactions_get lee un rango de fechas (start_date y end_date como YYYY-MM-DD), 100 por página por defecto y hasta 500 con count y offset en options. Hasta dónde llega depende del historial pedido al vincular el banco: el valor por defecto de Plaid son 90 días, el máximo 730, y plaid_link_token_create no pide más. plaid_transactions_sync devuelve lo añadido, modificado o eliminado desde la última llamada: empieza sin cursor y luego pasa next_cursor mientras has_more sea true. Justo después de vincular, las transacciones pueden tardar unos minutos en llegar.

Saldos: plaid_accounts_get lista las cuentas con los saldos que Plaid tiene en caché. plaid_accounts_balance_get consulta al banco en tiempo real, es más lento y en producción puede cobrarse por llamada según tu contrato con Plaid.

Límites de uso: dependen del entorno y del producto. Si pasas el límite, Plaid responde 429 con RATE_LIMIT_EXCEEDED: espera un momento y vuelve a intentarlo.

Errores frecuentes: INVALID_API_KEYS significa un client ID o secret incorrecto, o un secret de otro entorno distinto al de la Base URL. INVALID_ACCESS_TOKEN significa que el token está mal copiado o es del otro entorno. ITEM_LOGIN_REQUIRED significa que el acceso al banco cambió o el consentimiento caducó: el titular tiene que volver a iniciar sesión con Link en tu propia app, algo que el conector no puede lanzar. PRODUCT_NOT_READY justo después de vincular significa que las transacciones todavía se están cargando. PRODUCTS_NOT_SUPPORTED significa que el banco o el Item no ofrece ese producto.

El conector no gestiona webhooks, pagos y transferencias, inversiones y pasivos, verificaciones de ingresos y empleo, puntuaciones de riesgo, el modo de actualización de Link ni la eliminación de Items.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Plaid.

Herramientas disponibles

Ejemplos de prompts

• "Lista las cuentas de la conexión bancaria cuyo access token te acabo de dar, con su saldo actual y disponible."
• "Muéstrame todas las transacciones de más de 500 USD en la cuenta corriente de la empresa en septiembre de 2026, agrupadas por categoría."
• "¿Plaid admite Chase en Estados Unidos para transactions y auth?"
• "Comprueba si esta conexión bancaria sigue funcionando o necesita un nuevo inicio de sesión, y qué productos tiene activos."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse