plaid-mcp

Un servidor MCP autohospedado que permite a Claude consultar tus cuentas bancarias, saldos y transacciones a través de Plaid.

Herramientas

Cómo funciona

• OAuth 2.1 + PKCE con Google como proveedor de identidad

• La lista de permitidos de correo electrónico es el límite de seguridad

• Claude.ai obtiene un token de portador de 30 días; tu token de acceso de Plaid nunca sale de tu servidor

• Caddy se sitúa frente a FastAPI, terminando TLS en el puerto 443 con certificados de Let's Encrypt aprovisionados automáticamente y realizando proxy inverso a localhost:8080

Requisitos

• Un servidor Linux con una IP pública (esta guía utiliza una t3.micro de AWS EC2)

• Un nombre de dominio apuntando a él (esta guía utiliza un subdominio gratuito de DuckDNS)

• Una cuenta de desarrollador de Plaid con acceso a producción

• Una cuenta de Google Cloud para el cliente OAuth

Configuración

1. Plaid

1. Crea una cuenta de Plaid en dashboard.plaid.com

2. Solicita acceso a producción en el panel de control (Plaid revisará tu solicitud; esto puede tardar unos días)

3. Una vez aprobado, guarda tu client_id y tu secreto de Production en Team Settings → Keys

2. Google OAuth

1. console.cloud.google.com → crea un proyecto

2. APIs & Services → OAuth consent screen → configura una aplicación "Externa", añádete a ti mismo como usuario de prueba

3. APIs & Services → Credentials → Create credentials → OAuth client ID

4. Tipo de aplicación: Web application

5. Authorized redirect URIs: https://yourdomain.com/auth/google/callback (usa tu dominio real del paso 4 a continuación)

6. Guarda el Client ID y el Client secret

3. Servidor

Esta guía asume AWS EC2:

1. Lanza una instancia Ubuntu 24.04 t3.micro

2. Grupo de seguridad: TCP entrante 22 (SSH desde tu IP), 80, 443

3. Asigna una IP elástica y asóciala a la instancia

4. Conéctate por SSH: ssh -i your-key.pem ubuntu@<elastic-ip>

4. Dominio

Opción gratuita usando DuckDNS:

1. Inicia sesión con Google/GitHub/Reddit

2. Reserva un subdominio (p. ej., plaid-yourname)

3. Establece la IP a tu IP elástica

4. Tu dominio ahora es plaid-yourname.duckdns.org

Regresa al paso 2.5 y establece la URI de redirección a https://plaid-yourname.duckdns.org/auth/google/callback.

5. Instalación

En el servidor:

git clone https://github.com/lukew0824/plaid-mcp.git
cd plaid-mcp
cp .env.example .env
nano .env   # fill in everything
./install.sh

El script:

• Instala Python, Caddy y dependencias

• Configura un servicio systemd (plaid-mcp)

• Configura Caddy como proxy inverso con HTTPS automático mediante Let's Encrypt

6. Conectar en Claude.ai

1. Claude.ai → Settings → Connectors → Add custom connector

2. URL: https://yourdomain.com/mcp

3. Haz clic en Connect

4. Inicia sesión con la cuenta de Google que coincida con ALLOWED_EMAIL

5. Solo la primera vez: aparecerá una ventana emergente de Plaid Link; conecta tu banco

6. Listo. Prueba: "¿Cuánto gasté en comida el mes pasado?"

Configuración

Los valores de .env:

Licencia

MIT