Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Tidely con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Planificación de tesorería con Tidely: el flujo de caja y la previsión por mes, semana o día, escenarios, categorías, cuentas bancarias con saldos y movimientos, facturas de venta y de compra, y valores planificados. Lectura más creación y edición de facturas, planes, categorías y movimientos; los borrados vienen desactivados al instalar.
Prueba a pedir
Prompts de ejemplo para Tidely
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Tidely, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Tidely
Planificación de tesorería con Tidely: el flujo de caja y la previsión por mes, semana o día, escenarios, categorías, cuentas bancarias con saldos y movimientos, facturas de venta y de compra, y valores planificados. Lectura más creación y edición de facturas, planes, categorías y movimientos; los borrados vienen desactivados al instalar.
Configuración
La configuración lleva unos 5 minutos. Necesitas una cuenta de Tidely con el acceso a la API activado; la única credencial es una API key.
Primero, el acceso a la API: la API tiene que estar activada para tu cuenta de Tidely. Si no aparece Settings → API Keys, pide al soporte de Tidely ([email protected]) que la active.
- Inicia sesión en Tidely y abre Settings → API Keys (app.tidely.com/settings/openapi). Pulsa + para crear una key y dale los scopes que necesites: lectura para las herramientas de lectura, y escritura si la IA debe crear o editar facturas, planes, categorías o movimientos.
- Copia la key, guárdala en un lugar seguro y pégala en
TIDELY_API_KEY. Pega solo la key, sinBearerni ningún otro prefijo: el conector la envía en la cabeceraX-Authorization. - Instala el conector. Comprueba la conexión con
tidely_verify_auth: devuelve el nombre del usuario al que pertenece la key.
Cloud y self-hosted funcionan igual: la API key es la única credencial y no hay ninguna Redirect URL que configurar.
Por dónde empezar: tidely_get_cashflow responde a la mayoría de preguntas de liquidez: el saldo de hoy y la previsión por mes, semana o día. Sin parámetros usa el escenario base, periodos mensuales, 6 meses hacia atrás y 18 hacia delante. Para meses, from es el primer día de un mes y to el último día de un mes (para semanas, un lunes y un domingo). tidely_list_scenarios da los ids de los demás escenarios.
Las facturas necesitan su tipo: tidely_list_invoices, tidely_get_invoice y tidely_update_invoice piden invoiceTypeFilter SALE o PURCHASE, que debe coincidir con la factura. Las facturas sincronizadas desde una integración con un ERP son de solo lectura.
Movimientos e importaciones: los movimientos se listan por cuenta bancaria (bankAccountId). Solo se pueden añadir movimientos nuevos a las cuentas que se llevan en Tidely (provider API u OFFLINE). Antes de importar desde otro sistema, tidely_check_transactions_exist comprueba hasta 1000 ids externos para que nada se añada dos veces.
Los planes se suman: tidely_create_plan suma un importe puntual a los valores planificados de una categoría en un escenario (por defecto, el escenario base) para un día, una semana o un mes; con replaceCurrentValuesForThePeriod los sustituye. La categoría debe admitir valores planificados; sin categoría, el importe va a ingresos o gastos sin categorizar.
Qué lee: el flujo de caja por mes, semana o día de un escenario, con saldos inicial y final (real, previsión y plan), facturas de venta y de compra abiertas, importes por categoría, KPI, descubierto y liquidez; los escenarios de planificación; el árbol de categorías con sus tipos de ingreso y gasto; las empresas con moneda y país; las cuentas bancarias con IBAN, tipo, provider y saldo de referencia, su historial diario de saldos y sus movimientos con contraparte, concepto y categoría; las facturas de venta y de compra con contacto, fechas, importe bruto y pendiente, estado, categoría y origen.
Desactivadas al instalar: tidely_delete_invoice, tidely_delete_category, tidely_delete_plans y tidely_delete_bank_account_transaction. Borran una factura, una categoría, todos los valores planificados de una categoría en un escenario o un movimiento bancario, y nada de eso se puede deshacer. Activa en la página del conector solo las que necesites; la IA te pide confirmación antes de cada cambio. Crear y editar facturas, categorías, planes y movimientos bancarios está activado (tidely_create_invoice, tidely_update_invoice, tidely_create_category, tidely_update_category, tidely_create_plan, tidely_create_bank_account_transaction, tidely_update_bank_account_transaction); estas llamadas necesitan una key con el scope de escritura.
No se mueve dinero: los movimientos y las facturas son registros para la planificación; ninguna herramienta paga ni transfiere nada. Las importaciones masivas, crear o cambiar cuentas bancarias y la Partner API (OAuth, para partners de marca blanca) no forman parte de este conector.
Importes, fechas y paginación: los importes son decimales en la moneda de la cuenta o de la empresa, negativos para salidas de dinero y gastos; las fechas van en YYYY-MM-DD. Las listas paginadas empiezan en page 0, devuelven 50 elementos por página por defecto e indican totalPages.
Errores frecuentes: 401 (INVALID_CREDENTIALS) significa que falta la key o es incorrecta: crea una nueva y pégala sin prefijo. 403 (INSUFFICIENT_SCOPE) significa que la key es válida pero no tiene el scope para esa llamada: cambia sus scopes en Settings → API Keys. 400 (INVALID_REQUEST) es una entrada no válida y 404 un id desconocido, por ejemplo CATEGORY_NOT_FOUND. Ante un 500, vale la pena reintentar una vez tras una breve espera.
Requisitos previos: TIDELY_API_KEY
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Tidely e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| Tool | What it does |
|---|---|
tidely_verify_auth | Check that the API key is valid; returns success and the name of the user the key belongs to |
tidely_list_companies | List the companies of the Tidely account (paged): id, parentId, name, currency, country and industry |
tidely_get_company | Get one company of the Tidely account by id: name, parent company, currency, country and industry |
tidely_get_cashflow | Get the cash flow of the company per period (month, week or day) for a scenario: for each period start date the opening and closing… |
tidely_list_scenarios | List the planning scenarios: id, name and isBaseCase |
tidely_get_scenario | Get one planning scenario by id: id, name and whether it is the base case |
tidely_list_categories | List the cash flow categories: id, name, type (INCOME_/EXPENSE_ OPERATIONAL, INVESTMENT or FINANCING), parentId for the hierarchy and… |
tidely_get_category | Get one category by id: name, type, parent and whether it accepts planned values |
tidely_list_bank_accounts | List the bank accounts in Tidely: id, companyId, account name, bank, IBAN or account number, currency, type (CHECKING, SAVINGS, CREDITCARD… |
tidely_get_bank_account | Get one bank account by id: name, bank, IBAN, currency, type, provider, reference balance and visibility |
tidely_list_bank_account_balances | List the balance history of one bank account (paged): date and amount per day |
tidely_list_bank_account_transactions | List the transactions of one bank account (paged): id, booking date, amount, counterpart name, IBAN and reference, purpose, category and… |
tidely_get_bank_account_transaction | Get one bank account transaction by id: booking date, amount, counterpart, purpose, category and external id |
tidely_check_transactions_exist | Check which of up to 1000 external ids already exist as transactions on a bank account, before importing transactions from another system |
tidely_list_invoices | List sales or purchase invoices (paged): id, number, contact, dates, gross and open amount, status, category, type, source (ERP sync… |
tidely_get_invoice | Get one invoice by id; invoiceTypeFilter must match its type |
tidely_create_invoice | Create a sales or purchase invoice (or credit note) so it shows up in the cash flow forecast on its due date |
tidely_update_invoice | Update an invoice: only the fields you pass change (status, paid date, open amount, due date, amounts, category, note ...) |
tidely_delete_invoice | Delete an invoice (not those synced from an ERP integration) |
tidely_create_category | Create a cash flow category, optionally under a parent category |
tidely_update_category | Rename a cash flow category or change its type (income or expense, operational, investment or financing) |
tidely_delete_category | Delete a cash flow category by id |
tidely_create_plan | Add a planned value to the forecast: a one-time amount on a category in a scenario for a day, week or month (negative for expenses… |
tidely_delete_plans | Delete all planned values of one category in one scenario |
tidely_create_bank_account_transaction | Add a transaction to a bank account kept in Tidely (an API or offline account), e.g. imported from another system |
tidely_update_bank_account_transaction | Update a bank account transaction: only the fields you pass change, typically its category |
tidely_delete_bank_account_transaction | Delete a bank account transaction |
Ejemplos de prompts
- "¿Cuál es nuestro saldo de caja hoy y qué muestra la previsión para los próximos seis meses?"
- "¿Qué facturas de venta siguen abiertas y cuáles ya han vencido?"
- "Compara mes a mes el saldo final del escenario base con nuestros otros escenarios."
- "Marca la factura de compra 2026-118 como pagada hoy."
- "Añade al escenario base un gasto planificado de 12.000 para hardware nuevo en marzo de 2027 en la categoría IT."
Siguientes pasos
¿Te ha sido útil esta guía?