Debtly

GUÍA DE CONEXIÓN · MCP

Tu Debtly, en la IA que prefieras.

Conecta tus deudas, contactos, grupos y pagos con un asistente compatible. Elige qué permisos le das y desconéctalo cuando quieras desde la app.

URL del servidor MCPhttps://debtly.tech/mcp

La URL es pública; tus datos requieren autorización. Si pruebas una instalación local, copia la URL que aparece en Debtly → Ajustes → Conexiones de IA, porque el túnel cambia al reiniciarse.

01

EMPIEZA AQUÍ

La forma más sencilla: OAuth

1. Copia la URL

En Debtly, ve a Ajustes → Conexiones de IA y copia la dirección MCP.

2. Añade Debtly a tu IA

Selecciona un servidor MCP remoto o HTTP e introduce esa URL.

3. Autoriza la conexión

Inicia sesión en Debtly y revisa los permisos. Las acciones de escritura requieren tu selección expresa.

Para consultas basta con permisos de lectura. Si quieres crear deudas o registrar pagos, habilita los permisos de escritura correspondientes durante la autorización.

02

ELIGE TU ASISTENTE

Instrucciones por cliente

ChatGPT

OAuth
  1. En ChatGPT web, abre Plugins, pulsa + y elige “Add custom MCP server”.
  2. Escribe Debtly como nombre, pega la URL MCP y selecciona OAuth.
  3. Crea el plugin, instálalo y autoriza tu cuenta Debtly cuando se abra la pantalla de conexión.
  4. En un chat nuevo, escribe @Debtly para escogerlo y pide, por ejemplo, “muéstrame mis deudas”.

La disponibilidad puede depender de tu cuenta o de las políticas del espacio de trabajo.

Documentación oficial ↗

Codex

OAuth o token
  1. En la app de Codex, abre la configuración de MCP y añade un servidor “HTTP con transmisión en tiempo real”.
  2. Pon Debtly como nombre, pega la URL MCP y guarda. Deja vacío el campo del token si usarás OAuth.
  3. Inicia sesión cuando Codex lo solicite. En la CLI puedes usar los comandos de abajo.
npx --yes @openai/codex mcp add debtly --url https://debtly.tech/mcp
npx --yes @openai/codex mcp login debtly

Si “codex” ya está instalado en tu terminal, puedes usar codex en vez de npx --yes @openai/codex.

Documentación oficial ↗

Claude

OAuth o token
  1. En Claude web, abre Personalizar → Conectores → Añadir → Conector personalizado.
  2. Pon Debtly como nombre y pega la URL MCP.
  3. Para OAuth, elige iniciar sesión y “Registrar automáticamente” como cliente OAuth. Después conecta tu cuenta Debtly.
  4. Activa Debtly en los conectores del chat donde quieras usarlo.

En Team/Enterprise, un administrador debe añadir primero el conector a la organización.

Documentación oficial ↗

Gemini

OAuth
  1. En una computadora, entra en gemini.google.com y abre Configuración → Apps conectadas.
  2. En Apps personalizadas, elige añadir una app y pega la URL MCP.
  3. Continúa y autoriza el acceso a Debtly. Después podrás usar @Debtly en tus chats.

Google limita hoy las apps MCP personalizadas a cuentas personales de adultos en EE. UU., en inglés y con Keep Activity activado. La configuración se hace en la web; luego puede usarse en el teléfono.

Documentación oficial ↗

Claude Code

OAuth
  1. En la terminal, agrega Debtly como servidor HTTP con el comando de abajo.
  2. En Claude Code, ejecuta /mcp y completa la autorización en el navegador.
claude mcp add --transport http --scope user debtly https://debtly.tech/mcp
Documentación oficial ↗

Cursor y VS Code

OAuth o token
  1. En Cursor, abre Settings → MCP y añade un servidor HTTP remoto con la URL MCP. También puedes configurarlo en ~/.cursor/mcp.json.
  2. En VS Code, abre la paleta de comandos → “MCP: Add Server”, elige HTTP y pega la URL MCP.
  3. Cuando aparezca la solicitud de autorización, inicia sesión en Debtly y acepta los permisos que necesites.

La disponibilidad de MCP en VS Code depende del agente y de la configuración del editor.

Documentación oficial ↗Documentación de Cursor ↗
03

MODO MANUAL

Conectar con un token

Úsalo si tu cliente admite un encabezado Authorization pero no completa OAuth. En Debtly → Ajustes → Conexiones de IA, abre Conexión manual, elige nombre y permisos, pulsa Crear token y cópialo cuando aparezca: se muestra una sola vez.

En el cliente, usa la misma URL MCP y configura el encabezado:

Authorization: Bearer TU_TOKEN_MCP

En Codex, añade el servidor HTTP y pega el token en el campo de token de portador; si pide el nombre de una variable de entorno, guarda el token como DEBTLY_MCP_TOKEN en tu equipo y escribe solo ese nombre. En Claude puedes poner el mismo encabezado en Request headers. En VS Code, añádelo en los encabezados del servidor HTTP y usa su almacenamiento de secretos o una variable de entrada.

Cuida tu token: no lo pongas en la URL, en un chat, en un repositorio ni en una variable pública NEXT_PUBLIC_* o EXPO_PUBLIC_*. Si se filtra, revócalo en Conexiones de IA y crea otro. Un token MCP no es tu contraseña ni una clave de Supabase.

04

SI ALGO FALLA

Comprobaciones rápidas

La URL muestra un error al abrirla en el navegador

Es normal: MCP no es una página web. El navegador envía GET, mientras que el cliente MCP establece la sesión con solicitudes del protocolo. Pruébala desde la configuración de tu IA.

No aparece la pantalla de autorización

Comprueba que configuraste un servidor HTTP remoto con la URL completa y que elegiste OAuth. Si usas local, mantén abiertos Supabase, la web y el túnel; copia de nuevo la URL actual de la app.

La IA no puede crear una deuda o registrar un pago

Revisa los permisos concedidos: necesita write:debts o write:payments. También se aplican las mismas restricciones del plan y las reglas de la app. Puedes desconectar y volver a autorizar con los permisos correctos.

¿Necesito varias conexiones para un mismo cliente?

No. Una autorización activa por cliente suele bastar. Si ves conexiones de pruebas o anteriores como “Desconectada”, son parte del historial y ya no dan acceso.