pluggy-mcp

Un servidor remoto de Model Context Protocol que envuelve la superficie de productos de datos de la Pluggy API, desplegado en Cloudflare Workers.

Construido con Cloudflare Agents (McpAgent) mediante el transporte Streamable HTTP.

Herramientas

Expone 25 herramientas de los productos de datos de Pluggy:

Los pagos, los webhooks y las Smart Transfers quedan fuera del alcance.

Related MCP server: Copiloto Financeiro MCP Server

Autenticación

El cliente MCP se autentica con un token Bearer en cada solicitud:

Authorization: Bearer <base64(clientId:clientSecret)>

Genera el token:

printf '%s:%s' "$PLUGGY_CLIENT_ID" "$PLUGGY_CLIENT_SECRET" | base64

El Worker decodifica el token, genera una clave de API de Pluggy de corta duración mediante POST /auth (TTL de 2 h, renovada 5 min antes de expirar) y la envía como X-API-KEY en todas las llamadas a la API de Pluggy. Las credenciales de Pluggy nunca llegan al cliente MCP.

Desarrollo

npm install
npm run dev   # wrangler dev on http://127.0.0.1:8787

Despliegue

npx wrangler deploy

Conexión

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "pluggy": {
      "url": "https://<your-worker>.<your-subdomain>.workers.dev/mcp",
      "headers": { "Authorization": "Bearer <base64(clientId:clientSecret)>" }
    }
  }
}

Claude Desktop / Windsurf

Misma estructura, distinto archivo de configuración (claude_desktop_config.json / ~/.codeium/windsurf/mcp_config.json).

Notas

• list_items es una función opcional de Pluggy. Devuelve 403 LIST_ITEMS_FEATURE_NOT_ENABLED hasta que el soporte de Pluggy la active para tu equipo.

• list_transactions usa el endpoint GET /v2/transactions basado en cursores. Pasa el cursor after del valor next de una respuesta anterior para paginar.

• El Durable Object conserva la sesión y la clave de API generada durante toda su vida; las credenciales se pasan por solicitud a través del manejador fetch del Worker en ctx.props.