Publicar con tu agente
Guía general del servidor MCP: dirección de conexión, capacidades del agente, manejo de fotos, fechas y límites operativos.
Guía para IAs: cómo conectar un agente y qué conviene saber antes de publicar.
A través del servidor MCP de CMS Bridge, tu agente de inteligencia artificial puede redactar, editar, programar y publicar contenido directamente en los portales de Medios CMS que tengas vinculados. Cualquier cuenta puede hacerlo: cada persona ve solo sus sitios, sus claves y sus publicaciones.
Todo ocurre con total seguridad: tu clave de API de Medios nunca pasa por el agente ni se expone en el chat, sino que permanece resguardada en tu cuenta de CMS Bridge.
- Dirección del servidor MCP (Producción):
https://app.cmsbridge.dev/mcp - Tipo de transporte: Servidor remoto mediante Streamable HTTP (conexión web estándar).
Qué necesitás para empezar
- Una cuenta en CMS Bridge: Registrate en https://app.cmsbridge.dev/register o iniciá sesión en https://app.cmsbridge.dev/login.
- Al menos un sitio vinculado: Conectá tu portal de Medios por API en https://app.cmsbridge.dev/sitios usando el recuadro Conectar otro sitio (ver Conectar uno o varios sitios).
- El agente conectado: Vinculá tu asistente mediante inicio de sesión OAuth (Autorizar aplicación) o creando un token propio en https://app.cmsbridge.dev/agentes. Seguí el paso a paso en Conectar un agente.
Autenticación mediante Token
Si conectás tu agente usando un token manual, crealo en Agentes → Token del agente → Crear token. El código comienza con cmsb_ y se muestra una única vez. Tu cliente lo enviará en cada petición mediante la cabecera:
Authorization: Bearer cmsb_...*(Nunca pegues este token dentro de una conversación de chat. Si creés que quedó expuesto, revocalo al instante en https://app.cmsbridge.dev/agentes).*
Qué puede hacer el agente
Al conectarse, el agente recibe automáticamente la lista de acciones disponibles sin que tengas que configurarle nada a mano. Puede:
- Listar los sitios de Medios CMS que tenés conectados y ver su estado.
- Crear y publicar notas nuevas, o guardarlas como borrador.
- Leer notas existentes y buscar en el listado del portal.
- Consultar los autores, categorías y etiquetas disponibles en el sitio.
- Actualizar notas ya publicadas o en borrador.
- Subir imágenes, audios o videos a la nota.
- Enviar notas a la papelera o eliminar borradores.
- Verificar si una publicación se completó correctamente.
Reglas de publicación, fechas y formato
- Sin duplicados accidentales: Repetir exactamente el mismo pedido de creación de una nota no se duplica.
- Estados: *Publicada* sale en vivo al instante; *Borrador* queda guardada en el panel para revisión humana.
- Programar a futuro: Para programar, la nota tiene que quedar publicada con una fecha y hora futuras (si no especificás zona horaria, se asume la hora de Argentina). Si la dejás en *borrador* o *archivada*, la fecha se guarda como dato pero la nota no saldrá sola.
- Fechas pasadas: Podés pedir fechas históricas anteriores al día de hoy, siempre que sean posteriores a 1990. *(Tanto la programación futura como las fechas pasadas requieren que el sitio esté conectado por API).*
- Etiquetas e imágenes: El agente puede asignar hasta 10 etiquetas por nota. La primera imagen insertada en el cuerpo actúa como portada principal y como imagen para redes sociales al compartir (salvo que indiques otra distinta). Los epígrafes se muestran debajo de cada foto.
- Ediciones parciales: Todo lo que no pidas modificar permanece intacto. Si solo pedís cambiar el título, el cuerpo, las fotos y la URL no se alteran.
Flujo recomendado para publicar una nota
- Indicale al agente en qué sitio trabajar mencionando su dominio (por ejemplo,
misitio.com). - Aclarale el estado deseado (*publicada* o *borrador*) y si lleva alguna fecha especial (futura o pasada).
- Si lleva fotos, pasale el enlace público de la imagen o pedile que genere un enlace temporal de subida (pegando la imagen directo en el chat no le llega el archivo).
- Al terminar, el agente te devolverá el enlace directo a la nota creada.
Leer y corregir notas existentes
- Partir siempre del original: Pedile al agente que primero busque o lea la nota por su número identificador y edite sobre ese texto. Si la nota ya tiene fotos en Medios y le pedís que reemplace todo el contenido por un texto nuevo sin incluirlas, esas fotos desaparecerán de la nota.
- Notas abiertas en el panel web: Si tenés una nota publicada abierta en el editor web de Medios, Medios crea automáticamente una copia en borrador con otro ID. El agente siempre debe editar la nota original (puede leer la copia, pero Medios bloqueará cualquier intento de escritura sobre ella).
- Conflictos de edición (`force`): Si alguien dejó un borrador abierto sobre una nota publicada, la actualización se detendrá por precaución. Podés cerrar ese borrador en Medios o autorizar al agente a reintentar forzando la escritura (
force: true). *Tené en cuenta que forzar la edición no borra el borrador abierto en el panel, por lo que si alguien intenta publicarlo después, Medios frenará el choque.* - Cambios en la URL (slug): Si modificás el tramo final de la dirección de una nota ya publicada, cambiará su URL pública y el archivo de redirecciones que hayas descargado antes no se actualizará solo. Confirmalo antes de hacerlo.
Borrar notas
Pedile siempre confirmación explícita al agente:
- Borrar una nota publicada o archivada la envía a la papelera.
- Borrar un borrador (o una nota que ya está en la papelera) la elimina de forma permanente e irreversible.
Qué NO puede hacer el agente
- Destacados o colas de portada: No existen estrellas ni colas automáticas. El orden en la portada, solo al editar, también lo cambia el agente con importancia: 1 es la máxima, 2 superior, 3 media y 4 inferior.
- Flujos de moderación: No existe un estado *"en revisión"*; las notas solo pueden estar en *borrador*, *publicada* o *archivada*. El usuario de Medios asociado a la clave de API debe tener permisos para administrar artículos sin depender de la aprobación de otro editor.
- Gestión de la galería multimedia: El agente no puede listar archivos viejos del centro multimedia ni borrar imágenes del servidor. Para reutilizar una foto ya subida, tenés que darle su número identificador; para eliminar archivos, hacelo desde el panel de Medios.
- Iniciar migraciones: Las mudanzas desde WordPress se realizan exclusivamente desde el asistente web de CMS Bridge, y el archivo
.txtde redirecciones se descarga manualmente al finalizar.
Fotos que el usuario adjunta en el chat
Si pegás una foto en el chat, el asistente la ve, pero no recibe el archivo. Ningún asistente puede hacerlo. No intentarlo.
- Enlace temporal de subida (recomendado): Pedile un enlace para subirla. Abrilo, elegí la foto o arrastrala, y cuando diga que está lista, volvé al chat y avisale. El enlace sirve una sola vez y deja de funcionar a los 15 minutos. Si ya no anda, pedile otro.
- Enlace público: También podés pedile el enlace público de la foto, por ejemplo el de una imagen de tu centro multimedia de Medios. La imagen se vuelve a subir, así que puede quedar repetida.
- Archivo local: Si el asistente puede ejecutar un comando y la foto está guardada como archivo, puede subirla sin escribirla entera. Hace falta el token
cmsb_al alcance de ese comando, creado en https://app.cmsbridge.dev/agentes, y que la persona permita la salida de red. Algunos clientes bloquean la red hasta que la persona lo permite.
Ritmo y manejo de errores
- Límite de velocidad: Medios permite 2 solicitudes por segundo por sitio. CMS Bridge regula la cola automáticamente y reintenta solo lecturas o altas con ID externo. Las ediciones, borrados y subidas nunca se reintentan solos; si una subida de archivo queda en duda por un corte, no la repitas sin verificar para evitar duplicados.
- Si algo falla:
- *Sin acceso o token inválido:* Volvé a autorizar la app o generá un token nuevo en Agentes. - *Sitio no encontrado:* Asegurate de haberlo agregado en Mis sitios. - *Medios rechazó la clave:* Revisala en Mis sitios (verificá que empiece con medios_ y nunca la pegues en el chat). - *Servidor ocupado o pide esperar:* Aguardá unos segundos y volvé a intentarlo.
La especificación técnica completa para agentes está disponible en https://cmsbridge.dev/llms.txt.
In English
Your AI agent can publish, schedule, edit, and delete content on your connected Medios CMS sites via the CMS Bridge MCP server at https://app.cmsbridge.dev/mcp (using Streamable HTTP). Your Medios API key stays securely in CMS Bridge and is never exposed to the agent.
- Setup: Create an account at https://app.cmsbridge.dev/register, link your Medios site at https://app.cmsbridge.dev/sitios, and connect your agent via OAuth sign-in or a
cmsb_token from https://app.cmsbridge.dev/agentes. - Publishing & Dates: Set status to *published* with a future date/time (defaults to Argentina timezone) to schedule a post, or use any past date after 1990. Agents can add up to 10 tags per article; the first body image becomes the cover and social share image.
- Editing & Deleting: Always instruct the agent to edit based on the existing note content so attached images aren't removed. If a published note is open in the Medios web editor, the agent must target the original note ID rather than Medios's auto-created draft copy. Deleting a published/archived note moves it to trash; deleting a draft removes it permanently.
- Uploading Photos: Pasting an image into chat does not send the file. Instead, ask your agent for a one-time upload link (valid for 15 minutes), provide a public image URL, or let a CLI-enabled agent upload a local file using your
cmsb_token. - Limitations: Agents cannot manage featured queues (only cover priority
1–4when editing), list/delete media library files, or start WordPress migrations. Technical documentation for LLMs is available at https://cmsbridge.dev/llms.txt.