orquestra-mcp 1.18.1 → 1.20.0

package/README.md

@@ -1,6 +1,6 @@
 # orquestra-mcp
 
-Servidor MCP (Model Context Protocol) para Orquestra. Expone **89 tools**
+Servidor MCP (Model Context Protocol) para Orquestra. Expone **90 tools**
 que llaman a la API de `orquestra-infra`: lectura de contexto/dashboard/
 workspace/infra/paridad/listados, escritura de tareas/ideas/changelog/
 notas/docs/módulos/flujo/categorías/infra/proyectos, y corridas de QA —
@@ -192,7 +192,7 @@ create/update sigue siendo criterio del agente y del humano.
 
 ## Estado
 
-89 tools: lectura (contexto, dashboard, workspace, infra, paridad, standup,
+90 tools: lectura (contexto, dashboard, workspace, infra, paridad, standup,
 sync report, setup guide, playbooks de etapa y de plataforma, catálogo de
 skills, search) + `list_*` de cada colección + creación/edición de tareas
 (con checklist, tiempo, adjuntos, merge), ideas (con comentarios), notas,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orquestra-mcp",
-  "version": "1.18.1",
+  "version": "1.20.0",
   "description": "Servidor MCP de Orquestra -- 89 tools para leer y escribir tareas, ideas, changelog, infraestructura, contenido, QA y más desde un agente de IA",
   "type": "module",
   "bin": {

package/src/api.mjs

@@ -4,19 +4,23 @@ const DEFAULT_API_BASE = 'https://api.orquestra.me'
 
 export function loadConfig() {
   const fileConfig = readConfigFile()
-  const apiBase = process.env.ORQUESTRA_API_BASE || fileConfig?.apiBase || DEFAULT_API_BASE
-  const apiToken = process.env.ORQUESTRA_API_TOKEN || fileConfig?.apiToken
-  const workspaceId = process.env.ORQUESTRA_WORKSPACE_ID || fileConfig?.workspaceId
+  // Todo sale de la MISMA carpeta mapeada (ver resolveProjectForCwd) --
+  // apiToken/workspaceId/projectId siempre son de una sola cuenta, nunca
+  // el token de una carpeta con el proyecto de otra.
+  const folderConfig = resolveProjectForCwd(fileConfig?.projects, process.cwd())
+
+  const apiBase = process.env.ORQUESTRA_API_BASE || folderConfig?.apiBase || DEFAULT_API_BASE
+  const apiToken = process.env.ORQUESTRA_API_TOKEN || folderConfig?.apiToken
+  const workspaceId = process.env.ORQUESTRA_WORKSPACE_ID || folderConfig?.workspaceId
 
   // ORQUESTRA_DEFAULT_PROJECT_ID (env var, ej. desde un MCP config con
   // scope local/project de Claude Code) siempre gana -- es una anulación
-  // explícita. Si no hay env var, se busca en el mapa carpeta->proyecto del
-  // config file, subiendo desde cwd (ver resolveProjectForCwd). Si ninguna
-  // carpeta ancestro está mapeada, defaultProjectId queda undefined a
-  // propósito -- resolveProjectId() en server.mjs debe fallar explícito en
-  // vez de usar el proyecto de otra carpeta.
-  const defaultProjectId = process.env.ORQUESTRA_DEFAULT_PROJECT_ID
-    || resolveProjectForCwd(fileConfig?.projects, process.cwd())
+  // explícita. Si no hay env var, se usa el projectId de la carpeta
+  // resuelta arriba. Si ninguna carpeta ancestro está mapeada,
+  // defaultProjectId queda undefined a propósito -- resolveProjectId() en
+  // server.mjs debe fallar explícito en vez de usar el proyecto de otra
+  // carpeta.
+  const defaultProjectId = process.env.ORQUESTRA_DEFAULT_PROJECT_ID || folderConfig?.projectId
 
   const missing = []
   if (!apiToken) missing.push('ORQUESTRA_API_TOKEN')

package/src/configFile.mjs

@@ -4,13 +4,40 @@ import { join, dirname, sep } from 'path'
 
 export const CONFIG_PATH = join(homedir(), '.orquestra', 'mcp-config.json')
 
+// Formato viejo (hasta v1.18.1): apiBase/apiToken/workspaceId GLOBALES a
+// nivel raíz, projects={folderPath: projectId}. Eso pisaba la cuenta de
+// TODAS las carpetas cada vez que corrías "setup" con una cuenta distinta
+// -- no había forma real de tener un proyecto de una cuenta y otro de otra
+// cuenta al mismo tiempo. Migra en el momento a projects={folderPath:
+// {apiBase, apiToken, workspaceId, projectId}}, reusando las credenciales
+// globales viejas para cada carpeta ya mapeada (siguen apuntando a la
+// cuenta con la que se logueó por última vez -- si eso ya está mal, hay
+// que volver a correr "setup" en esa carpeta puntual).
+function migrateLegacyConfig(raw) {
+  const entries = Object.entries(raw.projects || {})
+  if (!entries.some(([, value]) => typeof value === 'string')) return raw
+
+  const { apiBase, apiToken, workspaceId } = raw
+  const projects = {}
+  for (const [folderPath, value] of entries) {
+    projects[folderPath] = typeof value === 'string'
+      ? { apiBase, apiToken, workspaceId, projectId: value }
+      : value
+  }
+  return { projects }
+}
+
 export function readConfigFile() {
   if (!existsSync(CONFIG_PATH)) return null
+  let raw
   try {
-    return JSON.parse(readFileSync(CONFIG_PATH, 'utf8'))
+    raw = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'))
   } catch {
     return null
   }
+  const migrated = migrateLegacyConfig(raw)
+  if (migrated !== raw) writeConfigFile(migrated)
+  return migrated
 }
 
 export function writeConfigFile(data) {
@@ -18,21 +45,24 @@ export function writeConfigFile(data) {
   writeFileSync(CONFIG_PATH, JSON.stringify(data, null, 2), { mode: 0o600 })
 }
 
-// Guarda/actualiza el projectId de UNA carpeta sin pisar las demás -- setup
-// se puede correr varias veces, una por cada carpeta contenedora de repos
-// (ver resolveProjectForCwd), y cada corrida solo debe tocar su propia
-// entrada.
+// Guarda/actualiza la cuenta+proyecto de UNA carpeta sin pisar las demás --
+// setup se puede correr varias veces, una por cada carpeta contenedora de
+// repos (ver resolveProjectForCwd), y cada corrida solo debe tocar su
+// propia entrada -- incluida la cuenta (apiToken/workspaceId), para poder
+// tener una carpeta en una cuenta de Orquestra y otra carpeta en otra
+// cuenta distinta al mismo tiempo.
 export function upsertProjectMapping({ apiBase, apiToken, workspaceId, folderPath, projectId }) {
-  const existing = readConfigFile() || {}
+  const existing = readConfigFile() || { projects: {} }
   const projects = { ...(existing.projects || {}) }
-  projects[folderPath] = projectId
-  writeConfigFile({ apiBase, apiToken, workspaceId, projects })
+  projects[folderPath] = { apiBase, apiToken, workspaceId, projectId }
+  writeConfigFile({ projects })
 }
 
 // Busca, subiendo desde cwd hacia la raíz, la carpeta mapeada más específica
 // -- mismo criterio que .editorconfig/.gitconfig: el ancestro más cercano
-// gana, así que un repo individual con su propio mapeo puede sobreescribir
-// el de la carpeta contenedora que lo engloba.
+// gana, así que un repo individual con su propio mapeo (y su propia cuenta)
+// puede sobreescribir el de la carpeta contenedora que lo engloba. Devuelve
+// el objeto {apiBase, apiToken, workspaceId, projectId} de esa carpeta.
 export function resolveProjectForCwd(projects, cwd) {
   if (!projects) return undefined
   let best = null

package/src/platformPlaybooks.mjs

@@ -265,4 +265,122 @@ export const PLATFORM_PLAYBOOKS = {
       },
     ],
   },
+  web: {
+    label: 'Web — SEO y analítica',
+    color: '#4A7CFF',
+    // Sin formulario de tienda ni "Completar con IA": una web no declara
+    // nada en una consola, solo tiene el checklist y la guía de referencia
+    // (DistributionGuide.jsx esconde la columna del formulario si es false).
+    hasForm: false,
+    consoleName: 'SEO y analítica',
+    moduleName:        'SEO y analítica web',
+    moduleDescription: 'Checklist para que la web/landing nazca medible e indexable: Search Console, analítica, rendimiento y SEO básico, para que no se olvide nada al lanzar.',
+    moduleTags:        ['playbook', 'seo', 'analitica'],
+
+    referenceGuide: [
+      {
+        key: 'search_console',
+        title: 'Google Search Console',
+        body: 'Sin esto Google no te dice si te indexó ni por qué no apareces. Agrega la propiedad (mejor tipo "Dominio", verificando por registro DNS TXT, así cubre www, http/https y subdominios), envía el sitemap.xml y revisa el informe de Páginas indexadas a la semana. Es gratis y es la fuente real de errores de indexación y consultas de búsqueda.',
+      },
+      {
+        key: 'analytics',
+        title: 'Google Analytics 4 / Firebase Analytics',
+        body: 'Mide visitas, origen y conversiones. Si el sitio ya usa Firebase, activa Google Analytics en el proyecto y usa el SDK web (measurementId); si no, crea una propiedad GA4 y pega la etiqueta. Define al menos un evento de conversión (registro, clic en CTA, descarga). Si el sitio sirve a usuarios de la UE/México, acuerda el aviso de cookies y consentimiento antes de activar.',
+      },
+      {
+        key: 'bing_webmaster',
+        title: 'Bing Webmaster Tools (opcional)',
+        body: 'Importa la propiedad directo desde Search Console en un clic. Cubre Bing, DuckDuckGo y parte de los asistentes con IA que usan su índice.',
+      },
+      {
+        key: 'sitemap_robots',
+        title: 'sitemap.xml y robots.txt',
+        body: 'Ambos en la raíz del dominio y respondiendo 200. robots.txt debe apuntar al sitemap y NO bloquear todo (Disallow: /) por un resto del entorno de staging. En SPAs (React/Vite) verifica que el sitemap lo genere el build, no que sea un archivo olvidado a mano.',
+      },
+      {
+        key: 'meta_tags',
+        title: 'Título, meta description y etiquetas por página',
+        body: 'Cada página indexable necesita <title> único (≤60 caracteres) y meta description (≤155) que venda el clic, un solo <h1>, y <link rel="canonical">. Una SPA que sirve el mismo <title> en todas las rutas pierde casi todo el SEO: usa prerender/SSR o un manejador de head por ruta.',
+      },
+      {
+        key: 'social_preview',
+        title: 'Open Graph / Twitter Cards',
+        body: 'og:title, og:description y og:image (1200x630) para que al compartir el enlace en WhatsApp, LinkedIn o X se vea una tarjeta, no una URL pelona. Pruébalo pegando el enlace en cada red antes de lanzar.',
+      },
+      {
+        key: 'performance',
+        title: 'Rendimiento: Core Web Vitals / PageSpeed',
+        body: 'Mide con PageSpeed Insights (móvil primero). Los puntos que casi siempre pesan: imágenes sin comprimir ni dimensiones (usa WebP/AVIF y lazy-loading), fuentes bloqueantes, JS sin dividir. LCP < 2.5s, CLS < 0.1, INP < 200ms son los umbrales de "bueno" de Google.',
+      },
+      {
+        key: 'structured_data',
+        title: 'Datos estructurados (schema.org)',
+        body: 'JSON-LD de Organization (y SoftwareApplication, FAQPage o Product según el sitio) para optar a resultados enriquecidos. Valida con la prueba de resultados enriquecidos de Google antes de publicar.',
+      },
+      {
+        key: 'https_domain',
+        title: 'HTTPS, dominio canónico y redirecciones',
+        body: 'Elige una sola versión (con o sin www) y redirige 301 las demás, incluido http → https. Evita cadenas de redirecciones y páginas duplicadas bajo dos URLs.',
+      },
+      {
+        key: 'privacy_legal',
+        title: 'Privacidad y consentimiento',
+        body: 'Si usas analítica o cookies, la política de privacidad debe mencionarlas y estar enlazada en el pie. Es requisito de Google Analytics aceptar sus términos de procesamiento de datos.',
+      },
+    ],
+
+    tasks: [
+      {
+        title:       'Agregar el sitio a Google Search Console y enviar el sitemap',
+        description: 'Crear la propiedad (tipo Dominio, verificación por DNS TXT), enviar sitemap.xml y confirmar que no marque errores de indexación. Sin esto no hay forma de saber si Google ve el sitio.',
+        type: 'tech', priority: 'high', tags: ['seo', 'web', 'search-console'], offsetDays: 1,
+      },
+      {
+        title:       'Instalar analítica (Google Analytics 4 / Firebase Analytics) y definir una conversión',
+        description: 'Activar GA4 (o Google Analytics en el proyecto Firebase y usar el SDK web con measurementId), confirmar en Tiempo real que registra visitas propias y marcar al menos un evento como conversión (registro, CTA, descarga).',
+        type: 'tech', priority: 'high', tags: ['seo', 'web', 'analytics'], offsetDays: 2,
+      },
+      {
+        title:       'Verificar que sitemap.xml y robots.txt respondan 200 y no bloqueen el sitio',
+        description: 'Abrirlos en el navegador en el dominio de producción. Revisar que robots.txt no tenga "Disallow: /" heredado de staging y que apunte al sitemap. En SPAs, comprobar que el hosting no devuelva index.html para estas rutas.',
+        type: 'tech', priority: 'high', tags: ['seo', 'web'], offsetDays: 2,
+      },
+      {
+        title:       'Revisar título, meta description, h1 y canonical de cada página indexable',
+        description: 'Un <title> único (≤60) y meta description (≤155) por página, un solo h1 y canonical. Si es SPA, confirmar que cada ruta los entrega al rastreador (prerender/SSR o manejador de head).',
+        type: 'tech', priority: 'medium', tags: ['seo', 'web'], offsetDays: 3,
+      },
+      {
+        title:       'Configurar Open Graph / Twitter Cards con imagen 1200x630',
+        description: 'og:title, og:description, og:image y twitter:card. Probar el enlace pegándolo en WhatsApp, LinkedIn y X.',
+        type: 'business', priority: 'medium', tags: ['seo', 'web', 'social'], offsetDays: 3,
+      },
+      {
+        title:       'Medir y corregir Core Web Vitals en PageSpeed Insights (móvil)',
+        description: 'Correr PageSpeed Insights sobre la home y las páginas clave. Objetivo: LCP < 2.5s, CLS < 0.1, INP < 200ms. Atacar primero imágenes sin comprimir, fuentes bloqueantes y JS sin dividir.',
+        type: 'tech', priority: 'medium', tags: ['seo', 'web', 'performance'], offsetDays: 5,
+      },
+      {
+        title:       'Fijar dominio canónico y redirecciones 301 (www / http → https)',
+        description: 'Elegir una sola versión del dominio y redirigir las demás con 301, sin cadenas de redirecciones. Confirmar HTTPS válido.',
+        type: 'tech', priority: 'medium', tags: ['seo', 'web'], offsetDays: 3,
+      },
+      {
+        title:       'Agregar datos estructurados (JSON-LD) y validarlos',
+        description: 'Organization como mínimo, más SoftwareApplication/FAQPage/Product según el sitio. Validar con la prueba de resultados enriquecidos de Google.',
+        type: 'tech', priority: 'low', tags: ['seo', 'web'], offsetDays: 7,
+      },
+      {
+        title:       'Importar la propiedad a Bing Webmaster Tools',
+        description: 'Importar desde Search Console en un clic. Opcional, pero cubre Bing/DuckDuckGo y asistentes de IA que usan su índice.',
+        type: 'business', priority: 'low', tags: ['seo', 'web'], offsetDays: 7,
+      },
+      {
+        title:       'Verificar/crear política de privacidad que mencione la analítica y cookies',
+        description: 'Si el sitio usa analítica o cookies, la política de privacidad tiene que mencionarlo y estar enlazada en el pie. Revisar también si hace falta aviso de consentimiento de cookies.',
+        type: 'business', priority: 'medium', tags: ['seo', 'web', 'compliance'], offsetDays: 3, checkKey: 'privacy',
+      },
+    ],
+  },
 }

package/src/server.mjs

@@ -369,7 +369,7 @@ export function createServer() {
     'get_platform_playbook',
     {
       description: 'Guía de referencia + checklist accionable para publicar en App Store Connect (iOS) o Google Play Console (Android) -- "Platform Playbook", paralelo a get_stage_playbook pero sobre una PLATAFORMA/distribución concreta, no la etapa del proyecto. No llama a la API -- datos estáticos. "referenceGuide" es texto de referencia (no genera tareas); "tasks" es el checklist accionable (misma forma que get_stage_playbook, se puede convertir en módulo + tareas reales).',
-      inputSchema: { platform: z.enum(['ios', 'android']).describe('ios (App Store Connect) | android (Google Play Console)') },
+      inputSchema: { platform: z.enum(['ios', 'android', 'web']).describe('ios (App Store Connect) | android (Google Play Console) | web (SEO y analítica: Search Console, GA4/Firebase Analytics, sitemap, meta tags, Core Web Vitals)') },
     },
     async ({ platform }) => textResult(PLATFORM_PLAYBOOKS[platform])
   )
@@ -508,7 +508,7 @@ export function createServer() {
       categoryId: z.string().optional(),
       moduleId: z.string().describe('OBLIGATORIO -- módulo al que pertenece esta tarea, para poder agruparla/revisarla después. Si no existe uno relacionado, llamá primero a list_modules (para no duplicar) y create_module.'),
       dueDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'Formato esperado: YYYY-MM-DD').describe('OBLIGATORIO -- fecha estimada de término (YYYY-MM-DD), calculada con criterio real según prioridad/tamaño del trabajo (mismo criterio que la "revisión de sincronización" de get_sync_report), nunca un valor arbitrario.'),
-      reviewDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'Formato esperado: YYYY-MM-DD').optional().describe('Fecha para volver a MIRAR esta tarea -- recordatorio, NO un entregable. Úsalo para tareas de espera sin deadline real (ej. "esperar respuesta de Apple y revisar en 5 días"): en ese caso NO llenes dueDate, llena reviewDate. Distinto de dueDate (fecha de término real de un entregable) -- una tarea puede tener ambos, uno solo, o ninguno. Dispara un aviso (notificación + correo) al assignedTo el día que llega, un solo disparo.'),
+      reviewDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'Formato esperado: YYYY-MM-DD').optional().describe('Fecha para volver a MIRAR esta tarea -- recordatorio, NO un entregable. Para un aviso CON HORA (ej. en 5 horas) usa set_task_reminder. Úsalo para tareas de espera sin deadline real (ej. "esperar respuesta de Apple y revisar en 5 días"): en ese caso NO llenes dueDate, llena reviewDate. Distinto de dueDate (fecha de término real de un entregable) -- una tarea puede tener ambos, uno solo, o ninguno. Dispara un aviso (notificación + correo) al assignedTo el día que llega, un solo disparo.'),
       assignedTo: z.string().optional().describe('uid del miembro asignado'),
       tags: z.array(z.string()).optional(),
       scope: z.array(z.object({ distId: z.string(), layer: z.string().optional(), done: z.boolean() })).optional()
@@ -613,6 +613,70 @@ export function createServer() {
     }
   )
 
+  // Recordatorio con hora de una tarea (2 oct 2026, a pedido de José) --
+  // "recuérdame en 5 horas revisar X con Ana" / "mañana revisa Y para poder
+  // cerrarla". Azúcar sobre PATCH /v1/tasks { remindAt (epoch ms), remindNote }:
+  // el job orquestra-reminders (modo remindAt, cada ~15 min) avisa por
+  // notificación + correo a assignedTo (o createdBy) y deja remindAt en null.
+  // El cálculo de "en 5h"/"mañana" se hace ACÁ (hora local de la máquina del
+  // usuario), no en el server, que no conoce su zona horaria.
+  const REMIND_IN_RE = /^(\d+)\s*(m|min|h|hr|d)$/i
+  function resolveRemindAt({ remindIn, remindAt }) {
+    if (remindIn && remindAt) throw new Error('Manda remindIn O remindAt, no los dos.')
+    if (remindAt) {
+      const ms = Date.parse(remindAt)
+      if (Number.isNaN(ms)) throw new Error('remindAt inválido -- formato ISO 8601, idealmente con zona (ej. 2026-10-03T09:00:00-06:00).')
+      return ms
+    }
+    if (!remindIn) throw new Error('Falta remindIn (ej. "5h", "30m", "2d", "tomorrow") o remindAt (ISO 8601).')
+    const v = remindIn.trim().toLowerCase()
+    if (v === 'tomorrow' || v === 'mañana') {
+      const d = new Date()
+      d.setDate(d.getDate() + 1)
+      d.setHours(9, 0, 0, 0)
+      return d.getTime()
+    }
+    const m = REMIND_IN_RE.exec(v)
+    if (!m) throw new Error('remindIn inválido -- usa "30m", "5h", "2d" o "tomorrow" (mañana 9:00 hora local).')
+    const n = Number(m[1])
+    const unit = m[2][0] // m | h | d
+    const ms = unit === 'm' ? n * 60000 : unit === 'h' ? n * 3600000 : n * 86400000
+    return Date.now() + ms
+  }
+
+  server.registerTool(
+    'set_task_reminder',
+    {
+      description: 'Programa (o quita) un recordatorio CON HORA sobre una tarea: a esa hora Orquestra avisa por notificación in-app + correo a la persona asignada (o a quien creó la tarea si no hay asignado), una sola vez. Úsalo para "recuérdame mañana revisar X para poder cerrarla" o "en 5 horas revisarla con Ana": pasa la nota con QUÉ hay que revisar/con quién. Resolución real ~15 min (no es un reloj al minuto). Para un recordatorio por DÍA sin hora sigue sirviendo reviewDate en update_task. Mandar clear=true quita el recordatorio pendiente.',
+      inputSchema: {
+        projectId: z.string().optional().describe(PROJECT_ID_DESC),
+        taskId: z.string().describe('Tarea sobre la que se programa el recordatorio'),
+        remindIn: z.string().optional().describe('Relativo a ahora: "30m", "5h", "2d" o "tomorrow" (mañana 9:00, hora local). Alternativa a remindAt.'),
+        remindAt: z.string().optional().describe('Momento exacto en ISO 8601, idealmente con zona horaria (ej. 2026-10-03T16:30:00-06:00). Alternativa a remindIn.'),
+        note: z.string().max(500).optional().describe('Qué hay que revisar o con quién (aparece en la notificación y el correo). Muy recomendable.'),
+        clear: z.boolean().optional().describe('true = quita el recordatorio pendiente de la tarea (ignora remindIn/remindAt).'),
+      },
+    },
+    async ({ projectId, taskId, remindIn, remindAt, note, clear }) => {
+      try {
+        const body = { projectId: resolveProjectId(projectId), id: taskId }
+        if (clear) {
+          body.remindAt = null
+        } else {
+          body.remindAt = resolveRemindAt({ remindIn, remindAt })
+          if (note !== undefined) body.remindNote = note
+        }
+        const data = await apiPatch(config, '/v1/tasks', body)
+        return textResult({
+          ...data,
+          reminder: clear ? 'quitado' : { remindAt: new Date(body.remindAt).toISOString(), note: note ?? null },
+        })
+      } catch (err) {
+        return errorResult(err)
+      }
+    }
+  )
+
   // Postproxy (integración de Contenido, 24 ago 2026) -- server.registerTool
   // directo, mismo criterio que merge_task/unmerge_task: son POST a
   // `${path}/${id}/connect-postproxy|publish-postproxy`, no un CRUD
@@ -622,7 +686,7 @@ export function createServer() {
   server.registerTool(
     'connect_postproxy_channel',
     {
-      description: 'Inicia la conexión de un canal (facebook/instagram/tiktok/linkedin) a Postproxy. Devuelve UNA de dos formas: {url} -- OAuth hosteado por Postproxy, el usuario tiene que abrirlo y completarlo a mano (el agente no puede terminar un OAuth por su cuenta), pásale esa URL tal cual; o {needsPageSelection, profileId, profileLabel, pages} -- pasa con facebook y linkedin, cuando ya hay un login de esa red conectado en la cuenta (un solo login da acceso a varias Pages de Facebook, o al perfil personal y las Organization Pages de LinkedIn, no hace falta repetir el OAuth) y hace falta elegir cuál corresponde a este canal. Esa elección hoy es un flujo de la web (Cuentas conectadas) -- si te llega `needsPageSelection`, dile al usuario que complete la selección ahí, esta tool no tiene una contraparte para elegir la página. Modelo real de Postproxy: cada perfil (login) vive en UN solo profile group y Orquestra usa un group por proyecto -- el OAuth de esta tool deja el perfil nuevo en el group de este proyecto; una cuenta de Instagram/TikTok conectada desde otro proyecto NO se puede reusar acá (sería publicar en la cuenta de otro proyecto), hay que conectar la cuenta correcta. Solo para los tipos que soporta Postproxy -- un canal newsletter (Buttondown) se conecta desde la web, no con esta tool.',
+      description: 'Inicia la conexión de un canal (facebook/instagram/tiktok/linkedin) a Postproxy. DISPONIBLE BAJO SOLICITUD (1 oct 2026): si el workspace no tiene Postproxy habilitado, la API responde 403 `postproxy_not_enabled` -- no reintentes ni busques otra vía; dile al usuario que un admin la solicite desde Contenido → Cuentas conectadas → "Solicitar conexión" en la web (se habilita a mano, le avisan por correo). Puede seguir planeando y redactando la pieza mientras tanto. Devuelve UNA de dos formas: {url} -- OAuth hosteado por Postproxy, el usuario tiene que abrirlo y completarlo a mano (el agente no puede terminar un OAuth por su cuenta), pásale esa URL tal cual; o {needsPageSelection, profileId, profileLabel, pages} -- pasa con facebook y linkedin, cuando ya hay un login de esa red conectado en la cuenta (un solo login da acceso a varias Pages de Facebook, o al perfil personal y las Organization Pages de LinkedIn, no hace falta repetir el OAuth) y hace falta elegir cuál corresponde a este canal. Esa elección hoy es un flujo de la web (Cuentas conectadas) -- si te llega `needsPageSelection`, dile al usuario que complete la selección ahí, esta tool no tiene una contraparte para elegir la página. Modelo real de Postproxy: cada perfil (login) vive en UN solo profile group y Orquestra usa un group por proyecto -- el OAuth de esta tool deja el perfil nuevo en el group de este proyecto; una cuenta de Instagram/TikTok conectada desde otro proyecto NO se puede reusar acá (sería publicar en la cuenta de otro proyecto), hay que conectar la cuenta correcta. Solo para los tipos que soporta Postproxy -- un canal newsletter (Buttondown) se conecta desde la web, no con esta tool.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         channelId: z.string().describe('Canal a conectar (ver list_channels) -- su `type` tiene que ser facebook/instagram/tiktok/linkedin'),
@@ -1060,7 +1124,7 @@ export function createServer() {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
         ideaId: z.string().describe('Idea -- usá search para encontrar su id'),
         text: z.string().describe('Texto del comentario'),
-        authorName: z.string().optional().describe('Default "IA" -- solo cambialo si el comentario es una cita textual de otra persona, no lo tuyo.'),
+        authorName: z.string().optional().describe('Default: el nombre del agente registrado al instalar el MCP ("IA" si no hay) -- solo cambialo si el comentario es una cita textual de otra persona, no lo tuyo.'),
       },
     },
     async ({ projectId, ideaId, text, authorName }) => {
@@ -1836,7 +1900,7 @@ export function createServer() {
       description: 'Aplica el Platform Playbook de publicación (iOS App Store / Google Play) sobre una distribución real: crea el módulo + tareas de la plantilla (igual que apply_stage_playbook) y, si mandás publishForm, también completa el formulario de la Guía de publicación de esa distribución (mismo dato que llena DistributionGuide.jsx en la web). Solo completá campos para los que tengas una base real del proyecto (código, get_project_context, servicios/entornos configurados) -- nunca inventes pricing, availability, package/bundle ID, cuentas demo para el reviewer, o el nombre exacto de la app; dejalos afuera de publishForm para que el usuario los complete a mano. Si la distribución YA tiene valores guardados en alguna de las claves que mandás, la tool NO los sobreescribe en silencio -- devuelve publishFormConflict con el valor actual vs. el propuesto por cada clave en conflicto, sin tocar publishForm. Mostrale ese conflicto al usuario y volvé a llamar con confirmReplace:true SOLO si confirma explícitamente el reemplazo. Si este playbook YA se aplicó antes sobre esta misma distribución (módulo+tareas ya creados), la tool lo detecta sola (mismo mecanismo que el badge "Ya aplicado" de DistributionGuide.jsx) y NO vuelve a crear módulo/tareas duplicados -- devuelve alreadyApplied:true. Volvé a llamar con force:true SOLO si el usuario pide explícitamente un checklist nuevo encima del que ya existe.',
       inputSchema: {
         projectId: z.string().optional().describe(PROJECT_ID_DESC),
-        platform: z.enum(['ios', 'android']).describe('ios (App Store Connect) | android (Google Play Console) -- ver get_platform_playbook para el contenido'),
+        platform: z.enum(['ios', 'android', 'web']).describe('ios (App Store Connect) | android (Google Play Console) | web (SEO y analítica, sin formulario) -- ver get_platform_playbook para el contenido'),
         distributionId: z.string().describe('Distribución real sobre la que aplicar el playbook (ver list_distributions) -- ahí vive el publishForm existente, si lo hay.'),
         moduleName: z.string().optional().describe('Nombre del módulo -- default: el de la plantilla'),
         publishForm: z.record(z.string()).optional().describe('Respuestas a completar, clave = key de referenceGuide (ver get_platform_playbook). Omitido o vacío = solo crea módulo + tareas, sin tocar el formulario.'),
@@ -1890,7 +1954,9 @@ export function createServer() {
           result.markedApplied = true
         }
 
-        if (publishForm && Object.keys(publishForm).length > 0) {
+        if (publishForm && Object.keys(publishForm).length > 0 && playbook.hasForm === false) {
+          result.publishFormIgnored = 'La guía web no tiene formulario de publicación (no hay consola que declarar) -- publishForm se ignoró.'
+        } else if (publishForm && Object.keys(publishForm).length > 0) {
           const distributions = await apiGet(config, '/v1/distributions', { projectId: pid })
           const dist = distributions.items.find(d => d.id === distributionId)
           if (!dist) {