Conecta tus agentes de IA (MCP)

Syncro expone un servidor MCP para conectar asistentes de IA (Claude, ChatGPT, Codex, Cursor, opencode, Mistral…) a tus proyectos. El asistente actúa con tus permisos: ve solo los proyectos en los que participas y respeta tu rol.

MCP es el estándar que permite a un asistente consultar y editar datos de una app. Tú decides qué conectas y puedes revocarlo cuando quieras desde tu perfil.

Endpoint

Todos los asistentes apuntan al mismo endpoint:

https://syncrowork.app/api/mcp

Conectar un asistente remoto (OAuth)

Claude, ChatGPT, Codex o Cursor se conectan por OAuth 2.1: pegas la URL del endpoint y ellos abren una pantalla de autorización de Syncro.

1. Añade un conector/servidor MCP con la URL de arriba.
2. Se abrirá una pestaña pidiendo iniciar sesión (si no lo estabas) y autorizar el acceso.
3. Revisa los permisos solicitados (Leer o Leer y escribir) y pulsa Autorizar.
4. Listo: el asistente ya puede consultar y editar tus datos.

La primera vez verás la pantalla de consentimiento con el nombre de la app que se conecta y los permisos que pide. Puedes cancelar sin autorizar nada.

Conectar un asistente local (stdio + token)

Los asistentes que corren en tu máquina (por ejemplo Claude Desktop u opencode en modo local) usan un token personal en lugar de OAuth:

1. Ve a Perfil → Acceso para agentes.
2. En Tokens de acceso, ponle un nombre, elige permisos (Lectura / Escritura), opcionalmente limita el token a un proyecto y fija una caducidad.
3. Pulsa Crear token y copia el valor (no se volverá a mostrar).

Después configura el asistente con ese token. Ejemplo genérico:

{
  "mcpServers": {
    "syncro": {
      "url": "https://syncrowork.app/api/mcp",
      "headers": { "Authorization": "Bearer syncro_pat_TU_TOKEN" }
    }
  }
}

En cada asistente

Cómo se conecta cada cliente y dónde está su documentación oficial:

Permisos y alcance

• Un token puede limitarse a un proyecto; entonces el asistente solo verá ese proyecto.
• Las columnas y los tableros solo se pueden crear o renombrar si eres propietario o administrador.
• Nunca se puede borrar el proyecto, quitar miembros ni cambiar roles desde un agente.

¿Y ahora qué?

Con el asistente conectado, estas dos guías te ayudan a sacarle partido:

• Qué puedes preguntar a tu agente: resúmenes, búsquedas y estado de tus proyectos.
• Qué puede hacer tu agente en Syncro: crear, mover y comentar tareas, etiquetas y Markdown.

Si algo no funciona

• No conecta: revisa que la URL sea exactamente la del endpoint y que hayas iniciado sesión antes de autorizar.
• Pediste ver un token y lo perdiste: los tokens se muestran una sola vez. Revócalo y crea uno nuevo.
• Un asistente dejó de responder: comprueba en Perfil → Acceso para agentes que la aplicación o el token siguen activos.

Revocar acceso

En Perfil → Acceso para agentes:

• Aplicaciones conectadas: pulsa Revocar para cortar el acceso de un asistente por OAuth.
• Tokens de acceso: pulsa Revocar para invalidar un token local.

El corte es inmediato: el asistente deja de poder leer o escribir.

---

Consejo: Empieza dando solo Lectura para probar; activa Escritura cuando confíes en el flujo. Revisa de vez en cuando Acceso para agentes y revoca lo que no uses.