Documentación de Ratio
Ratio es un portal de proyectos y tareas donde las personas y la IA trabajan sobre los mismos proyectos. El equipo usa tableros, sprints y tareas para el día a día, y su asistente —Claude, ChatGPT, Cursor u otro— trabaja en el mismo lugar, con los mismos permisos y dejando registro de cada cambio.
- Servidor MCP
- Sí, oficial y remoto:
https://ratioteams.com/api/mcp. Cómo funciona. - API REST
https://ratioteams.com/api/v1, con clave personal. Referencia.- Clientes de IA
- Claude (web, escritorio, celular y Claude Code), ChatGPT, Cursor y cualquier cliente con soporte para servidores MCP remotos.
- Idiomas
- Español e inglés.
- Precio
- Conectar una IA está incluido en todos los planes, también en el gratuito. Planes.
Cómo se organiza
Espacios y roles
Todo vive en un espacio. Cada cuenta tiene su espacio personal y puede sumarse a otros por invitación. Lo que hay en un espacio lo ve sólo la gente que está adentro, y cada persona tiene en él uno de tres roles:
| Rol | Qué puede hacer |
|---|---|
| Lector | Ver y comentar. |
| Miembro | Además, crear, editar y mover tareas, sprints, checklists, dependencias y diagramas. |
| Dueño | Todo, incluido borrar y administrar el espacio. |
Proyectos, módulos y sprints
Un espacio tiene proyectos. Dentro de un proyecto, las tareas se pueden agrupar en módulos y planificar en sprints con fecha de inicio y de fin. Pueden correr varios sprints a la vez. Una tarea sin sprint está en el backlog. Al cerrar un sprint, lo que quedó abierto pasa a otro sprint, al backlog o se da por terminado: nunca se pierde.
Tareas
Cada tarea tiene un estado —pendiente, en curso, bloqueada o hecha—, un tipo (cada espacio define los suyos, por ejemplo bug, mejora o idea), responsables, fecha y una descripción en markdown. Bloquear una tarea exige escribir el motivo. Además puede tener:
- Comentarios, con capturas y archivos adjuntos.
- Una checklist para los pasos chicos.
- Dependencias: una tarea puede esperar a otra del mismo proyecto.
- Diagramas de draw.io, que también se pueden crear desde Mermaid.
Las tareas se ven como tablero, como lista o agrupadas por estado. La actividad del proyecto se ve como lista o como calendario.
Actividad y avisos
Cada proyecto guarda quién hizo qué y cuándo. Al entrar, un resumen muestra lo que cambió desde la última visita. Los avisos llegan al portal y como notificaciones push, en el navegador o en el celular. En el plan Pro, también a Slack o a cualquier webhook (Zapier, Make, n8n).
Personas e IA
Cada persona conecta su asistente una sola vez. A partir de ahí, la IA consulta, crea y actualiza tareas en nombre de esa persona:
- Con los permisos de quien la conectó. Ve los mismos espacios y proyectos, y no puede hacer nada que esa cuenta no pueda.
- A la vista del equipo. Cada cambio aparece en el tablero, en la actividad y en los avisos, marcado «vía API».
- Con confirmación para lo delicado. Las acciones que cambian o borran algo están marcadas como tales, y los clientes como Claude piden confirmación antes de ejecutarlas.
- Revocable en cualquier momento desde Credenciales, en el portal.
Hay dos formas de conectarse: el servidor MCP, pensado para asistentes como Claude, ChatGPT o Cursor, y la API REST, para scripts e integraciones propias. Las dos hacen lo mismo y respetan los mismos permisos.
Ayuda
La guía paso a paso para conectar una IA está en Conectar tu IA. Para cualquier consulta: support@ratioteams.com.