Que tus movimientos lleguen solosLet your transactions arrive on their own

Cómo funcionaHow it works

• La llave se guarda cifrada en el Llavero de tu computador (nunca en un archivo) y solo se usa para leer.The key is stored encrypted in your computer's Keychain (never in a file) and is only used to read.
• Alcancía revisa sola al abrirse y cada 6 horas, trae lo nuevo, no duplica nada y le pone categoría igual que a una cartola.Alcancía checks on its own when it opens and every 6 hours, fetches what's new, never duplicates anything and categorizes it like a statement.
• Habla solo con el servicio que conectaste. No hay servidores de Alcancía en el medio.It talks only to the service you connected. There are no Alcancía servers in between.
• Beta = funciona con la API oficial y pasa nuestras pruebas, pero falta que alguien lo use con su cuenta real. Si lo pruebas, cuéntanos en la comunidad.Beta = works with the official API and passes our tests, but nobody has used it with a real account yet. If you try it, tell us in the community.

Para los bancos sin API (casi todos): en Conexiones, activa Cartolas que descargues. Desde ese momento, cada cartola que descargues a tu carpeta de Descargas se agrega sola si Alcancía sabe leerla: CSV, Excel o PDF con su receta, OFX/QFX, QIF o CAMT.053. Si no la sabe leer, te avisa para que tu IA aprenda (los PDF que no son cartolas, como boletas o pasajes, se dejan pasar sin avisar). Nunca borra ni mueve tus archivos.For banks without an API (almost all of them): in Connections, turn on Statements you download. From then on, every statement you download to your Downloads folder is added automatically if Alcancía can read it: CSV, Excel or PDF with its recipe, OFX/QFX, QIF or CAMT.053. If it can't, it lets you know so your AI can learn it (PDFs that aren't statements, like receipts or tickets, are skipped silently). It never deletes or moves your files.

1. En buda.com ve a Configuración → API Keys y crea una llave nueva.On buda.com go to Settings → API Keys and create a new key.

2. Dale permiso solo de lectura (sin operar ni retirar) y la fecha de vencimiento que quieras.Give it read-only permission (no trading or withdrawals) and any expiry date you like.

3. Copia la API Key y el API Secret y pégalos aquí.Copy the API Key and API Secret and paste them here.

4. En Alcancía, abre Conexiones, toca Conectar en Buda.com y pega lo que copiaste. Listo: tus movimientos llegan solos al abrir la app y cada 6 horas.In Alcancía, open Connections, click Connect on Buda.com and paste what you copied. Done: your transactions arrive on their own when the app opens and every 6 hours.

Abrir la página de Buda.comOpen the Buda.com page ↗

1. Entra a Mercado Pago Developers con tu cuenta, abre Tus integraciones y toca Crear aplicación.Sign in to Mercado Pago Developers, open Your integrations and tap Create application.

2. En «Elige una solución para integrar» deja Checkout Pro (da lo mismo cuál: Alcancía solo lee tus pagos y no cobra nada).Under “Choose a solution to integrate” leave Checkout Pro (it doesn't matter which: Alcancía only reads your payments and never charges anything).

3. En Otros datos, cambia el nombre por Alcancia, marca la casilla de autorización y toca Crear aplicación.Under Other details, change the name to Alcancia, tick the authorization box and tap Create application.

4. Dentro de la aplicación, abre Credenciales de producción (en el menú de la izquierda). Si te pide activarlas, elige la industria «Otros» y como sitio web https://alcancia-app.github.io/alcancia/.Inside the application, open Production credentials (in the left menu). If it asks you to activate them, choose the industry “Others” and https://alcancia-app.github.io/alcancia/ as the website.

5. Copia el Access Token (empieza con APP_USR-; no la Public Key) y pégalo aquí.Copy the Access Token (starts with APP_USR-; not the Public Key) and paste it here.

6. En Alcancía, abre Conexiones, toca Conectar en Mercado Pago y pega lo que copiaste. Listo: tus movimientos llegan solos al abrir la app y cada 6 horas.In Alcancía, open Connections, click Connect on Mercado Pago and paste what you copied. Done: your transactions arrive on their own when the app opens and every 6 hours.

Ojo: la llave de Mercado Pago da acceso completo a tu cuenta (Mercado Pago no ofrece una de solo lectura). Alcancía solo la usa para leer tus pagos, la guarda cifrada en tu computador y nunca sale de ahí salvo hacia Mercado Pago.Heads up: the Mercado Pago key gives full access to your account (Mercado Pago doesn't offer a read-only one). Alcancía only uses it to read your payments, keeps it encrypted on your computer, and it never leaves it except to Mercado Pago.

Abrir la página de Mercado PagoOpen the Mercado Pago page ↗

1. Necesitas una cuenta PayPal Business (las cuentas personales no tienen acceso a esta API).You need a PayPal Business account (personal accounts don't have access to this API).

2. Entra a developer.paypal.com → Apps & Credentials, elige Live y toca Create App («Alcancía»).Go to developer.paypal.com → Apps & Credentials, choose Live and click Create App (“Alcancía”).

3. En la app, marca Transaction Search en las funciones y guarda. PayPal puede tardar unas horas en activarlo.In the app, check Transaction Search under features and save. PayPal may take a few hours to enable it.

4. Copia el Client ID y el Secret y pégalos aquí.Copy the Client ID and Secret and paste them here.

5. En Alcancía, abre Conexiones, toca Conectar en PayPal y pega lo que copiaste. Listo: tus movimientos llegan solos al abrir la app y cada 6 horas.In Alcancía, open Connections, click Connect on PayPal and paste what you copied. Done: your transactions arrive on their own when the app opens and every 6 hours.

Abrir la página de PayPalOpen the PayPal page ↗

1. En el Dashboard de Stripe (modo real, no de prueba) ve a Desarrolladores → Claves de API.In the Stripe Dashboard (live mode, not test) go to Developers → API keys.

2. Toca Crear clave restringida, ponle «Alcancía» y deja todo en Ninguno salvo Balance en Lectura.Click Create restricted key, name it “Alcancía” and leave everything on None except Balance on Read.

3. Crea la clave, cópiala (empieza con rk_live_) y pégala aquí. Stripe no la vuelve a mostrar.Create the key, copy it (it starts with rk_live_) and paste it here. Stripe won't show it again.

4. En Alcancía, abre Conexiones, toca Conectar en Stripe y pega lo que copiaste. Listo: tus movimientos llegan solos al abrir la app y cada 6 horas.In Alcancía, open Connections, click Connect on Stripe and paste what you copied. Done: your transactions arrive on their own when the app opens and every 6 hours.

Abrir la página de StripeOpen the Stripe page ↗

1. Entra a my.akahu.nz, conecta tus bancos y abre Developers.Sign in to my.akahu.nz, connect your banks and open Developers.

2. Crea una personal app y copia el App ID Token y el User Token.Create a personal app and copy the App ID Token and User Token.

3. Pégalos aquí.Paste them here.

4. En Alcancía, abre Conexiones, toca Conectar en Akahu y pega lo que copiaste. Listo: tus movimientos llegan solos al abrir la app y cada 6 horas.In Alcancía, open Connections, click Connect on Akahu and paste what you copied. Done: your transactions arrive on their own when the app opens and every 6 hours.

Abrir la página de AkahuOpen the Akahu page ↗

1. Crea una cuenta en SimpleFIN Bridge (cuesta US$1,50 al mes) y conecta ahí tus bancos.Create a SimpleFIN Bridge account (US$1.50 a month) and connect your banks there.

2. Toca New connection para una app nueva y copia el Setup Token.Click New connection for a new app and copy the Setup Token.

3. Pégalo aquí. Alcancía lo canjea una sola vez por una llave que guarda cifrada.Paste it here. Alcancía exchanges it once for a key it keeps encrypted.

4. En Alcancía, abre Conexiones, toca Conectar en SimpleFIN y pega lo que copiaste. Listo: tus movimientos llegan solos al abrir la app y cada 6 horas.In Alcancía, open Connections, click Connect on SimpleFIN and paste what you copied. Done: your transactions arrive on their own when the app opens and every 6 hours.

SimpleFIN es un servicio aparte que se conecta con tus bancos; Alcancía solo habla con SimpleFIN.SimpleFIN is a separate service that connects to your banks; Alcancía only talks to SimpleFIN.

Abrir la página de SimpleFINOpen the SimpleFIN page ↗

1. En la app de Up, desliza a la derecha y abre Data sharing → Personal Access Token.In the Up app, swipe right and open Data sharing → Personal Access Token.

2. Toca Generate a token, elige cuánto tiempo dura y cópialo (empieza con up:yeah:).Tap Generate a token, choose how long it lasts and copy it (it starts with up:yeah:).

3. Pégalo aquí. Es de solo lectura: no puede mover dinero.Paste it here. It's read-only: it can't move money.

4. En Alcancía, abre Conexiones, toca Conectar en Up y pega lo que copiaste. Listo: tus movimientos llegan solos al abrir la app y cada 6 horas.In Alcancía, open Connections, click Connect on Up and paste what you copied. Done: your transactions arrive on their own when the app opens and every 6 hours.

Abrir la página de UpOpen the Up page ↗

Alcancía trae un pequeño servidor MCP (el estándar con que las IA se conectan a herramientas). Corre en tu computador, solo puede leer y no abre nada a internet. Con él, la IA que ya usas puede responder preguntas como «¿cuánto gasté en delivery este mes?» o «¿en qué se me va la plata?».Alcancía ships a small MCP server (the standard AIs use to connect to tools). It runs on your computer, can only read and opens nothing to the internet. With it, the AI you already use can answer questions like “how much did I spend on delivery this month?” or “where is my money going?”.

1. En Alcancía, abre Conexiones → Tu IA, fuera de Alcancía. Aparecen las IA que tienes instaladas: Claude (app de escritorio), Claude Code, ChatGPT (app de escritorio y Codex), Gemini CLI o Antigravity.In Alcancía, open Connections → Your AI, outside Alcancía. The AIs installed on your computer show up: Claude (desktop app), Claude Code, ChatGPT (desktop app and Codex), Gemini CLI or Antigravity.

2. Toca Conectar. Alcancía agrega la conexión con el comando oficial de cada IA o editando con cuidado su configuración (guarda una copia la primera vez).Click Connect. Alcancía adds the connection with each AI's official command or by carefully editing its settings (it keeps a backup the first time).

3. Abre tu IA (la app de Claude hay que cerrarla y abrirla de nuevo) y pregúntale: «Según Alcancía, ¿cómo voy este mes?».Open your AI (quit and reopen the Claude app) and ask: “According to Alcancía, how am I doing this month?”.

Conectarlo a manoConnect it manually

claude mcp add --scope user alcancia -- python3 ~/Developer/alcancia/bin/mcp_servidor.pyCopiarCopy

codex mcp add alcancia -- python3 ~/Developer/alcancia/bin/mcp_servidor.pyCopiarCopy

gemini mcp add -s user alcancia python3 ~/Developer/alcancia/bin/mcp_servidor.pyCopiarCopy

Usa la ruta donde tengas Alcancía. Con la app de Mac instalada, el botón Conectar pone la ruta correcta por ti.Use the path where you have Alcancía. With the Mac app installed, the Connect button sets the right path for you.

Cuando le preguntes, tu IA puede leer tus movimientos (fecha, descripción, monto y categoría), y lo que consulta viaja a tu proveedor de IA con tu cuenta, igual que si se lo escribieras. Alcancía no tiene servidores: todo corre en tu computador.When you ask, your AI can read your transactions (date, description, amount and category), and what it looks up goes to your AI provider with your account, just as if you typed it. Alcancía has no servers: everything runs on your computer.

¿Y mi banco?What about my bank?

Casi ningún banco deja que una persona use su propia API todavía: las que existen son para empresas con convenio. Las finanzas abiertas oficiales lo van a cambiar (en Chile, la CMF parte en julio de 2027) y Alcancía las va a sumar cuando no exijan un servidor nuestro. ¿Conoces una API oficial que una persona pueda usar con su propia cuenta? Cuéntanos en la comunidad o agrégala tú: está explicado en «Agregar un conector» de la guía para aportar.Almost no bank lets individuals use their own API yet: the ones that exist are for companies under contract. Official open finance will change that (in Chile, the CMF starts in July 2027) and Alcancía will add it when it doesn't require a server of ours. Know an official API that a person can use with their own account? Tell us in the community or add it yourself: it's explained under “Add a connector” in the contributing guide.