pluggy-mcp-starter
Pluggy MCP Starter é um servidor MCP self-hosted, read-only para agentes de IA, que agrega múltiplos IDs do Pluggy Financeiro em um único banco de dados local, expondo ferramentas em português sem mover dinheiro ou alterar dados.
Ficha actualizada 22 sept 2026, 20:24 · upstream 22 sept 2026, 20:09 · release sin release detectada
Qué es pluggy-mcp-starter
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
O pluggy-mcp-starter é uma implementação self-hostada e read-only do MCP (Model Context Protocol) para o ecossistema financeiro do Pluggy. Diferente da versão oficial que foca em demonstrações rápidas com um único itemId, este projeto resolve problemas práticos de uso real: múltiplos bancos como Santander, Nubank, Itaú e Inter geram IDs diferentes, exigindo consulta unificada. O projeto agrega todos os IDs em um banco de dados local, expõe ferramentas em português (financeiro_query, financeiro_cartoes, financeiro_schema, financeiro_refresh_item) e mantém o read-only por padrão — o agente consulta apenas, nunca movimenta dinheiro ou altera dados.
A arquitetura é simples: cliente MCP conecta ao servidor via HTTP com credenciais de conexão do Pluggy. O servidor consulta um banco de dados local (SQLite), executa consultas SQL sobre tabelas como 'accounts' e 'transactions', e retorna resultados formatados para o agente. Isso permite que agentes de IA como CodeX, Claude Desktop ou ChatGPT web consultem múltiplos bancos financeiros sem precisar configurar conexões separadas por cada instituição.
O projeto também oferece um servidor HTTP com HTTPS (via Docker Compose) ideal para integração com ChatGPT Web ou Claude.ai, onde o MCP é executado como uma API REST. O cliente pode usar um proxy seguro para estabelecer o tunnel de MCP, garantindo que as chamadas sejam criptografadas e autenticadas.
A arquitetura é modular: cada banco tem seu próprio ID, mas todas as ferramentas são unificadas no mesmo servidor. Isso facilita a manutenção — se uma conta for desligada ou migrada, apenas precisa ser removida do banco de dados local. O design segue princípios de segurança com autenticação via credenciais do Pluggy e proteção contra comandos maliciosos que alterem dados.
- Consultar múltiplos bancos (Santander, Nubank, Itaú) em um único agente de IA sem precisar configurar conexões separadas por instituição
- Gerar relatórios financeiros automáticos para agentes de IA que precisam consultar transações e saldos consolidados
- Criar chatbots financeiros que respondam perguntas sobre gastos, cartões e contas com base em dados do Pluggy Open Finance
- Integração com ferramentas de desenvolvimento como CodeX ou Cursor para análise de fluxo financeiro em tempo real
- Automação de tarefas financeiras (ex: alertas de vencimento) através de agentes de IA que consultam o banco localmente
- Read-only por padrão — nunca altera dados, apenas consulta. O agente pode ler e processar sem risco de perda financeira.
- Suporte a múltiplos IDs em um único servidor com banco de dados local (SQLite). Cada conta tem seu ID próprio mas todas são acessíveis.
- Ferramentas em português: financeiro_query, financeiro_cartoes, financeiro_schema, financeiro_refresh_item — totalmente adaptadas ao idioma do usuário.
- Self-hosted e autocontido: não requer dependências externas para o MCP. O cliente apenas adiciona uma configuração JSON no seu ambiente de IA.
- Suporte a HTTPS com proxy seguro (OpenAI Secure MCP Tunnel) para chamadas criptografadas entre agente e servidor.
- A API do Pluggy não lista todos os IDs existentes — o usuário deve anotar manualmente cada ID ao conectar contas. Isso pode levar a inconsistências se novos IDs forem adicionados sem atualização.
- Leva tempo para sincronizar dados: após alterar um cartão ou transação, o banco de dados local precisa ser atualizado (requer restart do servidor).
- Não suporta bancos que não tenham ID no Pluggy Open Finance. O projeto é focado em contas com IDs registrados na API.
- O banco de dados local é SQLite — pode ter limitações de performance se o volume de transações for muito alto.
- Sem suporte a múltiplos usuários ou autenticação de usuário — cada conexão requer credenciais do Pluggy.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instale com Docker Compose: `docker compose up -d --build`. O banco de dados é SQLite e roda localmente.,Para produção, use um containerizado com volume mount para o banco de dados e cache. Isso permite escalabilidade horizontal e persistência.,Adicione um proxy HTTPS (ex: Nginx) antes do MCP para SSL/TLS. O cliente deve usar o tunnel seguro ou credenciais HTTP.,Para produção, considere um container com systemd ou Kubernetes para auto-scaling e gerenciamento de recursos.,O banco de dados local é SQLite — use um volume persistente para evitar perda de dados em caso de reinicialização do servidor.,Implemente rate limiting no MCP endpoint para prevenir sobrecarga. O servidor pode ser acessado por múltiplos clientes simultaneamente.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.