Conectar Syntra con Claude y ChatGPT
El conector de Syntra permite a Claude y ChatGPT trabajar con tu espacio de Syntra a través del protocolo abierto Model Context Protocol (MCP). Pregunta por proyectos, tareas, riesgos y sprints con tus propias palabras y, donde tu espacio lo permita, deja que el asistente los cree y actualice por ti.
Requisitos
- Una cuenta de Syntra que sea miembro de un espacio con un plan de pago: Starter, Business o Enterprise. La lectura a través de Claude y ChatGPT está incluida en cualquier plan de pago; la escritura llega con el plan Enterprise, junto con la API y los webhooks. Consulta los precios.
- Claude (cualquier plan que admita conectores) o ChatGPT (un plan que permita añadir un servidor MCP propio).
- No hay nada que instalar, ninguna app OAuth que registrar, ni client ID o clave API que crear. Inicias sesión en Syntra en el navegador, eliges el espacio y apruebas el acceso una sola vez.
Dirección del servidor: https://syntra.tymko.tech/mcp. El espacio se elige en la página de consentimiento al conectar. Si perteneces a varios espacios y prefieres un conector distinto para cada uno, puedes usar la dirección propia del espacio, https://syntra.tymko.tech/mcp/<workspace>, que Syntra muestra en la página «API» del espacio. Es opcional.
Conectar en Claude
Syntra figura en el directorio de conectores de Claude (Claude Connectors Directory) como conector de la comunidad. Claude se identifica ante Syntra automáticamente con un Client ID Metadata Document, así que no hay que configurar ninguna app OAuth, client ID ni clave API. El conector funciona en Claude en la web, en Claude Desktop y en las apps móviles.
- Busca Syntra.En Claude, abre Customize (o Settings) → Connectors, busca Syntra y pulsa Connect. También puedes abrir directamente la ficha de Syntra.
- Inicia sesión en Syntra.Se abre una ventana de Syntra; inicia sesión con tu cuenta de Syntra (y con el segundo factor, si lo tienes activado).
- Elige el espacio y permite el acceso.La página de consentimiento muestra la app (Claude, claude.ai), tu usuario, el nivel de acceso y adónde volverás. Si perteneces a varios espacios, elige uno y pulsa «Permitir».
- Pregunta.En un chat nuevo, pregunta por tus proyectos. Claude llama a las herramientas de Syntra y muestra cada llamada que hace.
Claude Code se conecta de la misma forma: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp y después ejecuta /mcp para iniciar sesión.
Conectar en ChatGPT
- Añade un servidor MCP propio.En ChatGPT, abre Plugins (Settings → Apps), pulsa Add y luego Add custom MCP server. Introduce la URL
https://syntra.tymko.tech/mcpy elige OAuth como autenticación. - Inicia sesión y permite el acceso.ChatGPT se identifica automáticamente, así que no hay nada que registrar en Syntra. Inicia sesión en Syntra, elige el espacio y pulsa «Permitir» en la misma página de consentimiento que para Claude; en ella la app aparece como ChatGPT (chatgpt.com).
- Úsalo en un chat.Menciona Syntra o elígelo en el menú de herramientas y haz tu pregunta.
Syntra todavía no está en el directorio de apps de ChatGPT, así que por ahora se añade como servidor MCP propio.
Otros clientes MCP
Otros clientes compatibles con servidores MCP remotos se conectan a https://syntra.tymko.tech/mcp con OAuth mediante una app OAuth registrada en la configuración del espacio, en la pestaña «API»: con el mismo inicio de sesión y la misma página de consentimiento descritos arriba. Los clientes que envían sus propios encabezados pueden usar en su lugar una clave de acceso de Syntra, como Authorization: Bearer syn_…. Por ejemplo, Claude Code con una clave: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp --header "Authorization: Bearer syn_…". Los propietarios y administradores del espacio emiten claves en la configuración del espacio, en la pestaña «API»; cada miembro puede crear una clave personal en «Configuración» → «Claves API». Las apps OAuth y las claves de acceso están incluidas en el plan Enterprise.
Herramientas
Todas las conexiones reciben las herramientas de lectura. Las de escritura solo aparecen en el plan Enterprise, cuando el espacio tiene la escritura activada y permitiste «lectura y escritura» en la página de consentimiento. Ninguna herramienta puede eliminar nada.
| Herramienta | Qué hace |
|---|---|
list_projects | Los proyectos que puedes ver: código, nombre, estado, avance, prioridad, trimestre, responsable, fecha límite, departamento, semáforos de salud, riesgos abiertos. Solo lectura. |
get_project | Un proyecto completo: descripción, presupuesto, semáforos de salud, tareas por estado, las propias tareas y los riesgos con su mitigación. Solo lectura. |
list_tasks | Tareas de todos tus proyectos o de uno solo, con los cambios más recientes primero, filtradas por proyecto, estado, responsable, sprint o fecha de cambio. Solo lectura. |
list_sprints | Sprints por departamento con fechas, estado, número de tareas y Story Points. Solo lectura. |
get_sprint | Un sprint completo: objetivo, Story Points, sus tareas y el burndown. Solo lectura. |
whoami | Con qué usuario y en qué espacio actúa la conexión, y con qué rol. Solo lectura. |
create_task | Crea una tarea o un informe de bug en un proyecto, en tu nombre. Escritura. |
update_task | Modifica una tarea: título, descripción, estado, responsable, fecha límite, etiquetas, Story Points, sprint. Escritura. |
add_task_comment | Añade un comentario a una tarea; se notifica al responsable de la tarea y al responsable del proyecto. Escritura. |
create_project | Crea un proyecto con descripción, estado, prioridad, trimestre, fecha límite y responsable. Escritura. |
update_project | Modifica los campos, los semáforos de salud o el presupuesto de un proyecto. Escritura. |
add_risk | Registra un riesgo en un proyecto con su gravedad y su mitigación. Escritura. |
update_risk | Modifica el texto, la gravedad, la mitigación o el estado de un riesgo (cerrarlo o reabrirlo). Escritura. |
create_sprint | Planifica un nuevo sprint para un departamento. Escritura. |
update_sprint | Modifica el nombre, el objetivo o las fechas de un sprint planificado o activo. Escritura. |
Ejemplos de preguntas
- «¿Qué proyectos van con retraso este trimestre y por qué?»
- «¿Qué ha cambiado en los proyectos de marketing desde el lunes?»
- «¿Cómo va el sprint actual? Muestra el burndown y lo que sigue abierto.»
- «¿Quién tiene más tareas vencidas ahora mismo?»
- «Crea un bug en el proyecto P-117: el botón de pago no hace nada en iOS, con los pasos para reproducirlo.»
- «Añade un riesgo alto a P-131: el proveedor podría no cumplir la fecha de lanzamiento; mitigación: un segundo proveedor.»
Permisos
- Tus derechos, nada más. El asistente actúa en tu nombre dentro del espacio elegido y ve exactamente lo que tu rol permite; los proyectos restringidos siguen ocultos si tú no puedes abrirlos.
- Lectura para todos los miembros. Los miembros de espacios con cualquier plan de pago (Starter, Business o Enterprise) pueden conectarse y leer.
- Escritura en Enterprise, cuando ambas partes lo permiten. Las herramientas de escritura solo funcionan en el plan Enterprise, cuando un superadmin de Syntra ha activado la escritura por MCP para el espacio (el propietario lo solicita a soporte) y tú elegiste «lectura y escritura» en la página de consentimiento. Si no, la conexión es de solo lectura, pida lo que pida el asistente.
- Sin eliminaciones. Ninguna herramienta elimina proyectos, tareas, riesgos, sprints ni comentarios.
- Solo para el conector. Los tokens emitidos a Claude y ChatGPT solo sirven para la conexión MCP, no para el resto de la API de Syntra.
- Cambios visibles. Los cambios hechos a través del conector aparecen en Syntra con tu nombre, en el historial de la tarea y del proyecto y en el registro de auditoría.
Privacidad y datos
Syntra envía al asistente solo los resultados de las herramientas que llama, limitados a lo que tú puedes ver. Syntra no recibe ni almacena tus conversaciones con Claude o ChatGPT; lo que el asistente hace con los resultados de las herramientas se rige por las condiciones de Anthropic o de OpenAI para tu cuenta. El inicio de sesión usa OAuth 2.0 con PKCE: el asistente nunca ve tu contraseña de Syntra, y Syntra solo almacena hashes de los tokens que emite. Los detalles están en la política de privacidad, la lista de subencargados y el DPA.
Desconectar
Elimina el conector en Claude o ChatGPT y revoca el permiso en Syntra, en «Configuración» → «Claves API» → «Mis permisos». Cada miembro lo hace para su propio acceso. A partir de ese momento, el refresh token del asistente deja de funcionar de inmediato y el access token actual caduca en un plazo de 24 horas. El propietario de un espacio también puede pedir a soporte que desactive la escritura para todo el espacio.
Solución de problemas
«No hay ningún espacio al que pueda conectar esta app»
Ninguno de tus espacios tiene un plan de pago, o la dirección del espacio en la URL del conector corresponde a un espacio del que no eres miembro. Habla con el propietario del espacio o conéctate con la dirección general https://syntra.tymko.tech/mcp.
El asistente dice que la conexión es de solo lectura
El espacio no tiene el plan Enterprise, la escritura está desactivada para él o permitiste solo lectura. La escritura requiere el plan Enterprise; pide al propietario que solicite activarla, luego desconéctate, vuelve a conectarte y elige «lectura y escritura» en la página de consentimiento.
Falta un proyecto en las respuestas
Pide al asistente que ejecute whoami: muestra el usuario, el espacio y el rol que usa la conexión. Los proyectos que no puedes abrir en Syntra tampoco son visibles para el asistente.
Soporte
Escribe a support@tymko.tech indicando la hora del problema y, si es posible, el nombre de la herramienta que mostró el asistente.