ADmiraNeXT · MCP · Generador de Presentaciones

Conecta tu asistente al Generador de Presentaciones.

De un cliente y un problema a una presentación viva. Este servidor MCP deja que un consejero de silicio, o cualquier persona con su asistente (Claude, Cursor, OpenCode…), liste, cree, regenere y restaure presentaciones con los mismos permisos que tiene en /usuarios.

1 · Conectar

Endpoint: https://www.admiranext.com/mcp · JSON-RPC 2.0 · Streamable HTTP (responde JSON, o SSE si pides text/event-stream).
Autenticación: Authorization: Bearer anmcp_… — token personal, ligado a tu usuario del directorio.

Configuración para Claude / Cursor / OpenCode

{
  "mcpServers": {
    "admiranext-presentaciones": {
      "url": "https://www.admiranext.com/mcp",
      "headers": { "Authorization": "Bearer anmcp_TU_TOKEN" }
    }
  }
}

Prueba desde la terminal

curl -s https://www.admiranext.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer anmcp_TU_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"help"}}'

2 · Conseguir un token

Tu usuario tiene que existir en /usuarios, activo y con el proyecto generador-de-presentaciones (o *).
Un administrador crea el token: POST /api/mcp-tokens con {"email":"[email protected]","label":"mi asistente"} desde su sesión (o desde el panel de usuarios).
El token se muestra una sola vez. Se guarda solo su huella. Revocarlo, o darte de baja, corta el acceso al instante.

Sin token puedes hacer initialize, tools/list y help; nada más.

3 · Tools

Tool	Qué hace	Rol mínimo
`help`	Esta ayuda. `tema` opcional: `crear`, `presentaciones`, `versiones`, `permisos`, `informes`, `catalogo`, `demo`, `estructura`, `propuesta`.	ninguno
`list_presentations`	Catálogo / censo vivo (GET `/presentaciones/api/clients`): slug, nombre, web, languages, outputs, passwordSet, versionCount, updatedAt… Consultar antes de crear o Mejorar.	viewer
`get_catalog`	Alias de `list_presentations`: el catálogo es el gesto principal.	viewer
`list_decks`	Packs de deck (antes/después) para `create_presentation`.	viewer
`get_presentation`	Contenido vivo de una presentación (láminas, idiomas, secuencia). `{client}`	viewer
`create_presentation`	Crea o mejora (`overwrite:true`) a partir de `displayName`, `website`, `problem`, `audience`… Antes: `list_presentations`. Un cliente = un slug. `marca` (id de `GET /marcablanca/api/marcas`) viste el deck en modo prospect. `prospectUrl` (https de la web del cliente) la analiza con /marcablanca y guarda la marca en el catálogo como propuesta no oficial. Una de las dos, no las dos. Acepta `slideMedia`, `exampleVideoUrl`/`videoUrl`, `includeExampleVideo`, `demoVideo`/`requireExampleVideo` (exige `videoUrl`). Si `outputs` incluye `video` o hay TikTok, inyecta un MP4 real de flota (BEST). Devuelve jobId, slug y URLs.	editor
`create_yokup_report`	Informe Yokup: mejora in situ la presentación del cliente (`overwrite:true` si existe). Resuelve por `cliente`/`client`/`slug` o `displayName`. Nunca crea `yokup-flt-…`. Opcional `videoUrl` / `exampleVideoUrl` / `includeExampleVideo`; con `demoVideo:true` exige `videoUrl` (captura). Devuelve `mode` improved\|created, URLs, pass y `yokupBlock`.	editor
`generation_status`	Estado del alta: queued, running, saved o failed. `{client}` o `{job}`. El fallo queda escrito.	viewer
`cancel_presentation_job`	Cancela un alta `queued` o `running` y libera el identificador. `{client}` o `{job}`. No borra una presentación ya guardada.	editor
`list_versions`	Historial de versiones. `{client}`	viewer
`restore_version`	Restaura una versión. `{client, id}`	editor
`presentation_urls`	URLs de la presentación, la sala y el historial. `{client}`	ninguno
`delete_slide`	Elimina una lámina del esqueleto (`blockId`) sin regenerar el deck. En sala: `Ctrl+E` → Eliminar o `Ctrl+Backspace`.	editor
`update_slide`	Actualiza título/mensaje/detalle de una lámina (`blockId`) sin regenerar. Campos: `title`, `message`, `detail`, `language`.	editor
`roadmap_reglas`	Reglas del roadmap: método 123 y abc, plan diario a las 7:30 (Europe/Madrid), aprobado salvo objeción de Carlos, horizontes y responsables por vertical.	viewer
`roadmap_leer`	Plan con progreso. `{vista: proyecto\|agente\|consejero, id?, horizonte?}`	viewer
`roadmap_plan_diario`	Escribe tu plan de un horizonte: hasta 3 ideas × 3 subobjetivos. `{persona, horizonte, ideas[{titulo, subs[3]}]}`. La etiqueta del token debe llevar tu nombre.	editor
`roadmap_marcar`	Marca un subobjetivo a/b/c o un % manual de una idea de tu plan. `{persona, id_idea, sub, hecho \| pct}`. Ayer no se edita.	editor
`roadmap_ayer`	Resumen de ayer: hecho / parcial / no hecho / sin registro. `{persona}`	viewer
`roadmap_declarar_hecho`	Agente: declara hecho un ítem con evidencia (URL o fichero). `{persona, id_idea, evidencia, nota?}`	agente
`roadmap_sellar`	Consejero supervisor: sello ok \| rechazado (Elon supervisa a Oráculo y Morfeo). `{revisor, id_idea, veredicto, nota?}`	consejero
`roadmap_aprobar`	"OK Carlos" del plan de un consejero. `{persona, ok?}`	admin
`list_media`	Biblioteca multimedia de una presentación: recursos, láminas y `slideMedia`. `{client}`	viewer
`upload_media`	Sube imagen/audio/vídeo (≤40 MB) en `dataBase64` a la biblioteca privada; con `slide` lo asigna. `acceptedByCarlos:true` obligatorio. Para vídeos grandes: el mismo token como `Authorization: Bearer` en `POST /presentaciones/api/media-library` (multipart `client`, `acceptedByCarlos=true`, `file`).	editor
`assign_media`	Asigna un recurso (`assetId`) a una lámina (`slide`).	editor
`delete_media`	Retira un recurso de la biblioteca, de sus láminas y del almacenamiento privado.	editor
`lanzar_propuesta`	Propuesta comercial automática ante una oportunidad: `{url?, marca?, idea?, idioma?, destinatario?, rehacer?}` → marca en el catálogo de /marcablanca (analizada de su web o neutra, pendiente de logo) → estudio de la compañía (web pública + IA; lo deducido va como hipótesis) → presentación vestida con su marca (Studio, Store, App, Biz y «Su galaxia») → enlaces de las 4 soluciones con `?marca=<id>`. Idempotente por id. Solo a petición o con criterio comercial; nunca en bucle (20 al día por usuario). Página privada: `/marcablanca/propuesta/<id>`. Tema de ayuda: `propuesta`.	editor
`estado_propuesta`	Estado de una propuesta ya lanzada: pasos, marca, estudio (fuentes y confianza), presentación (URL y clave) y plataforma. `{id}`	viewer

4 · Estructura AdmiraNeXT

45 minutos en tres actos de 15 (admira.studio, admira.store, admira.app): portada + capítulos a/b/c por acto. En create_presentation:

structure: "admiranext" o slides:[{code,title,message,duration,promise,act}]
beforeDeck / afterDeck: pack de list_decks o slug de otra presentación (error si no existe)
insertDeck: {slug, afterBlock} — inserta otra sala tras una lámina
footer configurable · campos desconocidos → error · brief sin corte a 1.200

5 · Flujo típico de un consejero (gesto catálogo)

list_presentations / get_catalog → catálogo: ¿ya existe el cliente? Un cliente = un slug.
Si existe: create_presentation con overwrite:true (Mejorar). Si no: crea con nombre, web, problema y audiencia.
generation_status hasta saved (o failed, con el error guardado). create_presentation vuelve al momento con jobId.
presentation_urls → comparte la URL privada y la contraseña con el cliente. La sala (/presentacion) tiene salida de audiencia sin notas.

UI: /presentaciones/galeria (Registro vivo) · /presentaciones/?improve=<slug>. Help: tema: catalogo.

4b · Flujo informe Yokup (norma 22) · reutilizar destino

El generador es el generador de informes Yokup. Misma regla que webmaster: un cliente = un destino. El informe mejora la presentación existente; no crea un yokup-flt-… por misión. El catálogo es list_presentations / get_catalog (y el «Registro vivo» en /presentaciones/galeria).

list_presentations → localiza el slug del cliente.
create_yokup_report con mision (FLT-…), titulo, resumen, cliente/slug (o displayName) y verificado. Si existe → overwrite:true por defecto (versión capturada). Opcional: tiempo, puntos, total, qualityHint, videoUrl / exampleVideoUrl, includeExampleVideo, videoSlide. forceNew:true solo si realmente necesitas otro slug (desaconsejado).
Abre la sala con ?quality=best (vídeo en movimiento si hay videoUrl / ejemplo de flota, o figura descriptiva) o better (fondos temáticos).
Captura evidencia de escritorio → yokup_evidencia.
Cierra con yokup_informe pegando la URL+pass (el tool devuelve yokupBlock listo).

Help MCP: help con tema: informes.

4c · Gesto DEMO en vídeo (FLT-100316)

Las demos completas terminan como vídeo embebido en la presentación. El consejero graba la demo en vivo (p.ej. Tour DOOH en admira.app), sube el MP4 y lo pasa a videoUrl. En la sala, BEST muestra el motion sin abrir la plataforma.

Graba pantalla de la demo (OBS, ffmpeg o screen record del box).
Hostea bajo https://www.admira.live/assets/… o /presentaciones/<slug>/media/.
create_presentation / create_yokup_report con videoUrl + opcional videoSlide (closing o clave demo). Con demoVideo:true o requireExampleVideo:true el MCP rechaza sin videoUrl.
Abre la sala ?quality=best — el MP4 va en la lámina; no hace falta abrir admira.app.

Help MCP: tema: demo · doc GESTO-DEMO-VIDEO.md · stand-in flota: https://www.admira.live/assets/mouth-v2/boca-v2-ciclo.mp4.

5 · Permisos y seguridad

El token no lleva privilegios: en cada llamada se cruza con el directorio. admin → todo · editor → crear, regenerar, restaurar · viewer → solo lectura.
Cada tool llama a la API que el generador ya tiene, en el mismo origen, con una sesión de 5 minutos emitida a nombre del dueño del token. Todo queda en la auditoría de accesos del generador.
El MCP no guarda contraseñas de clientes ni tokens: solo huellas.

Pixeria · novedades / Pixeria updates

/demo pixeria novedades: ocho capítulos preparados con voz opcional y vídeo, desde los previos de Creador hasta URBAN FLOW en el gemelo 360. Se mantiene en el editor hasta que quieras borrarla. Eliminar la entrada Studio retira sus referencias sólo en este navegador; conserva otras demos y la campaña. Exporta antes para poder recuperarla.

/demo pixeria updates: eight prepared chapters with optional narration and video, from Creator previews to URBAN FLOW in the 360 twin. Keep it in the editor until you want to delete it. Removing the Studio entry affects this browser only; other demos and the campaign remain. Export first for recovery.

Demo · Editor · Tutorial ES/EN · Manifiesto / Manifest