Antes de empezar
Primero comprueba el servidor y la versión de la app.
Este proceso corresponde al servidor compartido de la versión internacional de iOS. app.squirrelly.ai sigue siendo el dominio del servicio y de la API; no se necesita software Web ni iniciar sesión en la Web. El mismo correo puede corresponder a cuentas distintas en otros servidores.
| Versión de la cuenta | Estado actual |
|---|---|
| Servidor internacional compartido de iOS | Prueba de conexión · Requiere nueva app |
| Función nativa necesaria | Ajustes → Conexiones de agentes. Requiere una nueva versión nativa; no se da por hecho que las versiones instaladas o de App Store ya la incluyan. |
| Cuentas independientes de Android Play internacional | Aún sin integración |
| Cuentas independientes de la versión china, HarmonyOS y otras | Aún sin integración |
Solo se contempla el servidor internacional compartido de iOS. Los servidores independientes Android Play, China y HarmonyOS no están habilitados. Si no aparece Conexiones de agentes, actualiza o espera a la versión compatible. No crees una cuenta Web de sustitución.
Paso 01
Copiar el número de cuenta en la app
- Abre Ajustes → Conexiones de agentes en la app nativa.
Usa tu cuenta existente con sesión iniciada en la app. Guía para abrir la app ↗ solo explica cómo abrir la app; no permite iniciar sesión ni gestionar cuentas en la Web.
- Comprueba si tu versión incluye esta función.
Este proceso requiere una nueva versión nativa con Conexiones de agentes. Si falta la opción, actualiza o espera a su lanzamiento. No se presupone que las versiones instaladas o de App Store ya sean compatibles.
- Copia el número global desde Conexiones de agentes.
El número empieza por
ZXM-. La misma cuenta en el mismo servidor conserva el número. Introdúcelo en la solicitud del navegador para identificar la cuenta y el servidor.
El número permite localizar la cuenta correcta; no es una contraseña. El acceso exige aprobación explícita en la app nativa con la cuenta correspondiente iniciada.
Ver cómo abrir la app ↗Paso 02 · ChatGPT
Añade Squirrelly a ChatGPT
Este es el procedimiento de prueba para un MCP personalizado, no una instalación con un clic desde una tienda de plugins. La disponibilidad depende de tu cuenta de ChatGPT y de las políticas del espacio de trabajo.
- Abre la página Plugins de ChatGPT.
Ve a ChatGPT Plugins ↗, selecciona el signo más y después Add custom MCP server (Añadir servidor MCP personalizado). Si no ves esta opción, consulta las preguntas frecuentes de abajo.
- Introduce los datos de conexión.
Escribe “squirrellyai” como nombre y elige un punto de acceso HTTPS público. Pega la dirección completa, incluida la terminación
/mcp.
Configuración de ChatGPT, incluidos los ajustes avanzados de OAuth
| Ajuste | Valor correcto |
|---|---|
| Nombre | squirrellyai |
| Dirección del servidor | https://mcp.squirrelly.ai/mcp |
| Método de autenticación | OAuth |
| Método de registro | Cliente OAuth personalizado |
| ID de cliente OAuth | squirrelly-chatgpt |
| Secreto de cliente | Dejar en blanco |
| Método de autenticación del punto de acceso Token | none |
| URL de registro | Dejar en blanco |
| Activar OIDC | Sin marcar |
Abre “Ajustes avanzados de OAuth” y rellena cada campo según la tabla. El ID de cliente debe ser squirrelly-chatgpt; no lo sustituyas por el nombre del plugin ni el número de cuenta.
Los avisos de DCR y CIMD no disponibles indican que el servidor no ofrece esos dos métodos de registro automático. Selecciona “Cliente OAuth personalizado” y sigue la tabla. Deja vacía la URL de registro y no actives OIDC.
Conserva los cinco ámbitos solicitados por defecto: account:read, books:read, transactions:read, transactions:create, summaries:read. Deja vacíos los ámbitos de autorización básicos.
- Finaliza la creación, instala o activa el plugin y después conecta tu cuenta.
Crea el plugin personal siguiendo ChatGPT, instálalo o actívalo y selecciona “Conectar cuenta”. Crear el plugin no concede acceso a la cuenta: aún debes aprobar en la app. Después prueba las seis herramientas de cuenta, libros, nuevas transacciones, búsqueda, resúmenes y resultados de escritura.
- Inicia OAuth y completa la autorización en la siguiente sección.
Cuando OAuth abra la solicitud Squirrelly, introduce el número copiado en la app. Mantén ese navegador abierto; aprobarás el acceso en la app.
- Crea un chat nuevo y activa la conexión.
Activa el plugin de Squirrelly que has creado según la interfaz actual de ChatGPT. En las interfaces compatibles, puedes escribir
@para seleccionarlo. Después realiza primero la comprobación de solo lectura que se indica más abajo.
Si ves squirrellyai entre tus plugins personales de ChatGPT, se ha creado correctamente. Instala o activa ese plugin, conecta tu cuenta Squirrelly, aprueba en la app y después prueba las herramientas. No necesitas crearlo otra vez.
Avanzado: comprobar los puntos de acceso OAuth y la URI de redirección
Actualmente, este cliente solo tiene registrada esta URL de retorno exacta:
https://chatgpt.com/connector_platform_oauth_redirectSi el anfitrión muestra otra URI de redirección, por ejemplo específica de la conexión, el administrador debe registrar esa URI exacta. No uses comodines ni cambies el dominio. Otros agentes necesitan clientes propios y no deben reutilizar este cliente de ChatGPT. DCR y el registro CIMD general no están disponibles.
Comprobar los puntos de acceso OAuth descubiertos automáticamente
| Ajuste | Valor correcto |
|---|---|
| URL de autorización | https://mcp.squirrelly.ai/oauth/authorize |
| Token URL | https://mcp.squirrelly.ai/oauth/token |
| URL base del servidor de autorización | https://mcp.squirrelly.ai |
| Recurso | https://mcp.squirrelly.ai/mcp |
El servicio real se ha verificado con el cliente oficial del SDK de MCP, pero las llamadas finales a herramientas en una cuenta real de ChatGPT siguen sin verificar. Crear el plugin personal no significa haber autorizado la cuenta ni realizado llamadas correctas, y no implica publicación en un catálogo ni aprobación de OpenAI.
Fuentes del procedimiento: Guía oficial de conexión de OpenAI · Documentación de autenticación OAuth. Comprobado el 2026-10-30.
Habilidad de registro rápido
Instala la habilidad squirrelly con un solo comando
Elige el comando para tu ordenador y cliente para descargar e instalar squirrelly automáticamente. La conexión MCP y la autorización OAuth en la app se completan por separado; después puedes usar el acceso rápido de la habilidad.
Descargar e instalar automáticamente
Copia el comando correspondiente en el terminal del ordenador o entrégaselo a un agente que pueda ejecutar comandos locales. Descarga, verifica e instala la habilidad sin descompresión manual.
macOS
macOS: ejecuta en Terminal con las herramientas del sistema. No requiere instalar Python ni Homebrew aparte. Elige el comando para tu cliente.
/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client codex/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client claude-codeVer script de instalación · macOS ↗
Windows
Windows: ejecuta en PowerShell. Compatible con Windows PowerShell 5.1 y PowerShell 7. Elige el comando para tu cliente.
& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client codex& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client claude-codeVer script de instalación · Windows ↗
El instalador verifica SHA-256 e instala solo archivos de la habilidad. Por defecto no sobrescribe contenido existente diferente. Para actualizar, añade --update en macOS o -Update en Windows; primero hará una copia de seguridad.
Recarga el cliente o abre una sesión nueva tras instalar. Usa $squirrelly en Codex y /squirrelly en Claude Code. Instalar la habilidad no configura MCP ni completa OAuth; conecta el servicio y aprueba en la app por separado.
Una página Web no puede instalar habilidades locales de forma silenciosa. ChatGPT en la Web utiliza un plugin; estos comandos son para clientes con permiso de ejecución local.
Descargar ZIP manualmente (alternativa)
Si el cliente no admite comandos locales, usa la importación ZIP de abajo cuando sea compatible. Las posibilidades dependen del cliente.
- Descarga manualmente el ZIP como alternativa.
Descargar la habilidad squirrelly en ZIP, descomprímelo manualmente y consulta INSTALL.md. El paquete contiene archivos de la habilidad, sin contraseñas de cuentas ni tokens.
- Instálalo según los requisitos del cliente.
En Codex, puedes colocar la carpeta squirrelly en tu directorio personal de habilidades y usar en una sesión nueva
$squirrelly; los clientes compatibles con estos directorios pueden registrar, siguiendo sus instrucciones,/squirrelly. El nombre del comando lo controla el cliente; MCP no lo añade automáticamente.
Conecta primero MCP y completa la autorización OAuth. La habilidad solo orienta al agente para llamar a las herramientas; no concede acceso a la cuenta. No se registrará nada sin conexión ni se harán escrituras por iniciativa propia si la fecha, la moneda o el libro no están claros.
/squirrelly Hoy he comprado una prenda de ropa por 2000 yuanes chinos (CNY).
En la interfaz actual de ChatGPT, puedes seleccionar el plugin mediante @. No des por hecho que los comandos con barra funcionan en todos los clientes; elige el acceso adecuado según las instrucciones de instalación del paquete.
Paso 02 · Otros agentes
Conecta distintos agentes al mismo servicio
Elige los pasos para tu cliente
| Cliente | Pasos |
|---|---|
| ChatGPT en la web | Crea o activa el plugin según la tabla de ChatGPT de arriba. Después conecta tu cuenta y autoriza el acceso en la App. No necesitas instalar una habilidad local. |
| Codex | Instala la habilidad con el comando de macOS o Windows de abajo. Configura MCP por separado y autoriza el acceso en la App; vuelve a cargar el cliente y usa $squirrelly. |
| Claude Code | Instala la habilidad con el comando de macOS o Windows de abajo. Configura MCP por separado y autoriza el acceso en la App; vuelve a cargar el cliente y usa /squirrelly. |
El anfitrión debe admitir MCP remoto mediante Streamable HTTP y OAuth con código de autorización / PKCE. La ubicación de los ajustes y las funciones disponibles varían según el producto; no apliques directamente los pasos de la interfaz de ChatGPT.
- Busca los ajustes de MCP remoto o de servidores de herramientas del anfitrión.
Introduce
https://mcp.squirrelly.ai/mcpy selecciona OAuth como autenticación. - Registra un cliente OAuth propio para ese agente.
El administrador debe registrar el nombre de la aplicación, un ID de cliente independiente y la URL de retorno exacta que proporcione el anfitrión.
squirrelly-chatgptestá reservado para el retorno registrado de ChatGPT; otros productos no pueden reutilizarlo directamente. - Aprueba el acceso en la app nativa.
Tras registrar el cliente, sigue el mismo proceso de aprobación en la app que se explica abajo. Mantén abierto el navegador original para completar OAuth. Los anfitriones limitados a stdio local, claves API estáticas o sin OAuth no pueden conectarse directamente.
Los desarrolladores también pueden integrar sus propios agentes mediante HTTP API. La compatibilidad con el protocolo ofrece una vía de integración, pero no significa que todos los productos hayan superado pruebas de compatibilidad.
Paso 04
Comprueba la conexión antes del primer registro
Se recomienda comprobarlo en este orden. Los botones de copiar solo copian texto; no envían solicitudes ni crean registros automáticamente.
Usa Squirrelly para consultar la cuenta y el libro autorizados actualmente, sin añadir ningún registro por ahora.
Comprueba que el número de cuenta y el libro devueltos coincidan con la cuenta actual de la app y su único libro. Después envía un ingreso o gasto que realmente quieras registrar.
Registra con Squirrelly: hoy he gastado 35 yuanes chinos (CNY) en el almuerzo. Anótalo en el libro autorizado actualmente.
El registro solo se considera realizado cuando el servicio confirma expresamente que se ha guardado. Después, abre el libro correspondiente en tu cuenta original de Squirrelly y comprueba el importe, la fecha y la moneda.
Después de conectar
Haz todo esto directamente desde el chat
Registra con Squirrelly: hoy he recibido un sueldo de 8000 yuanes chinos (CNY).
Consulta con Squirrelly los gastos de esta semana y muestra primero los 20 movimientos más recientes.
Resume con Squirrelly los ingresos, gastos y saldo de este mes, separando las distintas monedas.
Especifica claramente el importe, la moneda y la fecha, y usa el libro autorizado actualmente. La primera versión no permite a los agentes editar o borrar registros antiguos, hacer transferencias, gestionar préstamos ni importar en bloque.
Si el agente indica que el resultado es desconocido, pídele que consulte el resultado de la operación original o reintente con el mismo ID de solicitud. No repitas el mismo registro con solicitudes nuevas. El servidor utiliza registros de deduplicación para evitar duplicados por reintentos de red.
Tú mantienes el control
Revoca la autorización o cambia de cuenta
- Abre Ajustes → Conexiones de agentes en la app nativa.
Busca el cliente autorizado y revisa su libro y sus permisos en la app.
- Revoca el acceso de ese cliente en la app.
La aplicación dejará de tener acceso. Los registros existentes se conservan, y la sesión de la aplicación original y las demás autorizaciones siguen vigentes. Cerrar sesión en la aplicación no revoca la autorización del agente.
- Para cambiar de cuenta, vuelve a conectar y autorizar.
Antes de volver a conectar, inicia sesión en la cuenta deseada en la app nativa y comprueba la solicitud y los permisos. Se usa automáticamente su único libro. Una nueva autorización no mueve registros ni fusiona cuentas de distintos servidores.
Si tienes problemas
Preguntas frecuentes y problemas de conexión
¿Por qué no puedo registrar movimientos después de instalar?
La instalación solo coloca los archivos de la habilidad. Comprueba que este cliente tenga su propio cliente OAuth registrado y su URL de retorno exacta, esté conectado a MCP y hayas aprobado explícitamente tras comprobar la cuenta, el cliente y los permisos en la app. Se usa automáticamente el único libro de la cuenta. Tras aprobar en el móvil, mantén abierto el navegador original para terminar OAuth. Recarga el cliente y consulta primero la cuenta y el libro autorizados. Comprueba que coincidan antes de registrar operaciones reales.
¿Aparece un error después de introducir el número de cuenta?
Vuelve al plugin squirrellyai existente e inicia “Conectar cuenta” de nuevo. Introduce el número en la nueva página de autorización; no te limites a actualizar el error anterior. Esta corrección Web no requiere reinstalar la app móvil. Si sigue fallando, conserva el código de error mostrado.
¿No aparece «Añadir MCP personalizado» en ChatGPT?
Esta opción depende de la cuenta de ChatGPT, la organización y las políticas del espacio de trabajo. Consulta primero las instrucciones oficiales actuales; en espacios de empresa o de equipo, el administrador puede confirmar si se permiten conexiones personalizadas. Que la dirección del servicio sea accesible no garantiza que el anfitrión ofrezca esta opción.
¿Aparece 401 al introducir la dirección? ¿Está fallando el servicio?
Si abres directamente /mcp directamente sin autorización suele devolver 401. Es un punto de acceso para agentes, no una página de inicio de sesión. Copia tu número en Ajustes → Conexiones de agentes de la app, inicia OAuth desde el agente y aprueba en la app.
¿Aparece invalid_client o no coincide la URL de retorno?
Comprueba que utilizas el ID de cliente de la aplicación correspondiente y la URL de retorno exacta registrada. El ID prerregistrado para ChatGPT es squirrelly-chatgpt; los demás productos necesitan su propio registro. Si la URL de retorno específica del anfitrión difiere de la registrada, el administrador debe actualizar la configuración. No cambies de cuenta repetidamente ni desactives la autenticación.
¿Falta Conexiones de agentes, la cuenta no coincide o el navegador espera?
Necesitas una nueva app con Ajustes → Conexiones de agentes; si falta, actualiza o espera. Comprueba la cuenta original y el servidor en la app. Mantén abierto el navegador original durante la aprobación en el móvil y vuelve allí para completar OAuth. Si se rechaza o caduca, inicia otra solicitud. No crees una cuenta Web ni introduzcas una contraseña Web.
¿Puedes conectar, pero no añadir ingresos ni gastos?
Comprueba que los permisos concedidos incluyen «Añadir ingresos y gastos», que el libro sigue accesible y que la solicitud es un ingreso o gasto ordinario con importe, moneda y fecha completos. Si es necesario, vuelve a conectarte para conceder expresamente los permisos requeridos.
¿El agente dice que ha funcionado, pero no aparece en la aplicación?
Comprueba la versión, la cuenta y el libro, además de los filtros de fecha y moneda. Pide al agente que consulte el resultado de la operación original; solo el estado committed devuelto por el servicio confirma el éxito. Si el resultado es desconocido, no vuelvas a registrar con un ID nuevo.
¿Desconectar borra los registros? ¿Qué significa «eliminar registros de deduplicación»?
Desconectar solo revoca el acceso de la aplicación, sin borrar registros. Los registros de deduplicación guardan qué asiento se creó con cada solicitud para evitar duplicados; el uso normal, cerrar sesión o revocar permisos no los elimina. Solo se borran junto con los datos personales al eliminar la cuenta completa.
¿Qué ocurre si cambio de teléfono o de servidor?
El número de una misma cuenta en el mismo servicio no cambia. Las cuentas independientes de distintos servicios tienen sus propios números; actualmente no se fusionan automáticamente entre versiones. En una migración de servidor, la plataforma debe mantener la correspondencia de las cuentas; no basta con compartir correo para vincularlas automáticamente.
¿Solicitud caducada, acceso revocado o servicio no disponible?
Una solicitud caducada o rechazada no concede acceso. Reinicia OAuth y aprueba la nueva solicitud en la app. Si el acceso se revocó, vuelve a conectar. Reintenta más tarde los fallos temporales. Mantén abierto el navegador original; no envíes contraseñas, códigos ni tokens por chat ni desactives la verificación HTTPS.
Para desarrolladores
Integra el registro de cuentas en tus propios agentes
Registra tu cliente OAuth y su URI de redirección exacta. El navegador identifica el servidor con account_code; la app nativa aprueba la solicitud y el navegador original completa el flujo de código de autorización / PKCE S256. Después llama a MCP o a la API HTTP. No se admite el registro dinámico anónimo, compartir tokens ni obtener acceso solo con el número de cuenta.
| Herramienta MCP | Función |
|---|---|
get_account / list_books | Consultar la cuenta y el libro autorizados |
create_transaction | Crear un ingreso o un gasto |
list_transactions | Consultar movimientos por páginas |
summarize_transactions | Resumir por moneda |
get_operation | Consultar el resultado de una escritura |
Los importes se expresan en la unidad monetaria mínima. Las operaciones de creación deben usar un identificador estable requestId (en HTTP, Idempotency-Key). Indica que la operación se ha completado solo con el estado committed; si el estado es unknown, conserva el identificador original y consulta el resultado.
Empieza con tu propia cuenta.
Obtén tu número y aprueba en la app; después completa OAuth en el navegador original.