Conector MCP de Ovillo

Conectá tu asistente de IA a tus espacios de Ovillo: consultar tareas, crearlas, mover estados, comentar, leer documentos y registrar horas — con exactamente tus mismos permisos, nunca más.

Qué necesitás

• Una cuenta de Ovillo en app.ovillo.lat (el plan gratuito alcanza). Si no tenés, se crea en el primer login.
• Un cliente que soporte MCP remoto: Claude (web y escritorio), ChatGPT, Claude Code, Cursor, VS Code o cualquier cliente MCP propio.
• Nada que instalar ni configurar del lado de Ovillo: el conector usa tu login habitual (Google, Microsoft, passkey o contraseña).

Conectar desde Claude o ChatGPT (OAuth)

1. En tu cliente, abrí Configuración → Conectores → Agregar conector personalizado.
2. Pegá la URL del servidor: https://app.ovillo.lat/api/mcp/web.
3. Al conectar, el navegador te lleva a Ovillo: iniciá sesión como siempre y aprobá el acceso en la pantalla de consentimiento. Volvés al cliente ya conectado.
4. Probá con algo concreto: «listá mis tareas de esta semana en Ovillo» o «creá las tareas de este plan en el espacio Producto».

El conector usa OAuth 2.1 con registro dinámico de cliente y PKCE. No hay que pegar ninguna clave a mano ni compartir tu contraseña con el asistente.

Conectar desde Claude Code, Cursor o VS Code (token)

Los clientes de terminal y de editor usan un token de acceso personal contra el endpoint con bearer. Generalo en Ovillo, en Configuración → Conexiones → Personal access token, y después:

claude mcp add --transport http ovillo https://app.ovillo.lat/api/mcp \
  --header "Authorization: Bearer ovk_tu_token"

Para quitarlo: claude mcp remove ovillo. En Cursor o VS Code, la misma URL y el mismo header en la configuración de servidores MCP del editor.

Qué puede hacer el asistente

El conector expone 24 herramientas. Las de lectura no modifican nada; las de escritura cambian datos de tu espacio de trabajo y sólo se ofrecen si tu usuario puede escribir en algún lado.

Herramienta	Qué hace
list_spaces	Lista los espacios accesibles, con id y nombre	lectura
list_tasks	Tareas de un espacio con todos sus campos, con filtros	lectura
my_tasks	Tareas asignadas a vos, opcionalmente por vencimiento	lectura
search_tasks	Busca tareas por texto en nombre y descripción	lectura
due_soon	Tareas que vencen en los próximos N días	lectura
blockers_report	Tareas bloqueadas, vencidas e hitos pasados	lectura
space_stats	Métricas del espacio: avance, horas, distribución	lectura
list_goals	Objetivos de un espacio con su progreso	lectura
list_people	Personas visibles: nombre, rol, capacidad	lectura
list_docs	Documentos de un espacio	lectura
read_doc	Lee el contenido de un documento	lectura
list_comments	Comentarios de una tarea	lectura
list_attachments	Adjuntos de una tarea y de sus comentarios	lectura
read_attachment	Lee el contenido de un adjunto de texto	lectura
create_space	Crea un espacio nuevo	escritura
create_task	Crea una tarea con tipo, prioridad, fecha y asignados	escritura
update_task	Cambia campos de una tarea (reemplaza los valores anteriores)	escritura
create_goal	Crea un objetivo en un espacio	escritura
update_goal	Cambia nombre o progreso de un objetivo	escritura
create_doc	Crea un documento	escritura
update_doc	Agrega al final o reemplaza el cuerpo de un documento	escritura
add_comment	Comenta una tarea	escritura
request_reporter_info	Deja un comentario pidiéndole datos al reporter del ticket	escritura
log_time	Registra horas trabajadas en una tarea	escritura

Permisos y seguridad

• Tus permisos, no más: cada llamada se autoriza con tu usuario. Si no ves un espacio en la app, el asistente tampoco.
• Sólo lectura si sólo podés leer: a quien no puede escribir en ningún espacio, las herramientas de escritura ni se le ofrecen.
• Sin acceso directo a la base: el asistente no ejecuta SQL ni ve otras organizaciones; sólo puede llamar a las 24 herramientas de arriba.
• Anotaciones honestas: cada herramienta se publica marcada como de lectura o de escritura, para que tu cliente pueda pedirte confirmación antes de modificar algo.
• Cortar el acceso: en Ovillo, Configuración → Conexiones → Apps de IA conectadas revoca los tokens de ese cliente al instante. Si conectaste con un token personal, revocalo en esa misma pestaña.

Si algo no funciona

• «No se puede conectar»: verificá que la URL sea exactamente https://app.ovillo.lat/api/mcp/web, sin barra final.
• No aparece ninguna herramienta: reconectá el conector; el catálogo se pide en el initialize y algunos clientes lo cachean.
• «Acceso denegado» al crear o editar: tu usuario no tiene permiso de escritura en ese espacio; pedíselo a un administrador de tu organización.
• Nada más: escribinos a hello@ovillo.lat.