Saltar al contenido

Changelog de la API

Historial de cambios de la API de Vemudo y de /mcp para agentes de IA, con la fecha de disponibilidad en api.vemudo.com y la política de cambios.

Por Equipo Vemudo · Actualizado el

Las fechas de este changelog son la fecha en la que cada cambio está disponible en api.vemudo.com, no la del desarrollo interno. Todo lo que no aparece en una entrada, incluido lo que ya existía antes de la primera, es la versión inicial de /v1.

2026-11-17 — MCP remoto con OAuth 2.1, herramientas de escritura y de claves

OAuth 2.1 en /mcp

https://api.vemudo.com/mcp admite la autorización de MCP con OAuth 2.1, además de las claves de API: descubrimiento automático (/.well-known/oauth-protected-resource y /.well-known/oauth-authorization-server), registro dinámico de clientes y PKCE S256. El cliente solo necesita la URL; al conectar, la persona entra en Vemudo y elige organización, entorno (test o live) y permisos (mcp:read, mcp:send, mcp:write, mcp:keys). Sin credenciales, /mcp responde 401 con WWW-Authenticate y la dirección de los metadatos.

El token de acceso dura 1 hora y se renueva con un token de refresco rotatorio. Cada conexión trabaja en un solo entorno y cada organización admite hasta 10 conexiones activas (409 oauth_connection_limit), que no cuentan para el máximo de claves activas del plan. Los tokens OAuth no valen en /v1, solo en /mcp. Las conexiones se ven y se revocan en el panel, en «Claves de API > Conexiones de IA».

Herramientas nuevas, solo con OAuth

  • Con mcp:write: escrituras sobre dominios, plantillas, contactos, listas, bajas, webhooks y campañas (incluido enviarlas desde una conexión live). Las destructivas exigen confirm: true.
  • Con mcp:keys: list_api_keys, create_api_key y revoke_api_key. El secreto de una clave nueva se devuelve una sola vez en el resultado de create_api_key.

Con una clave de API, /mcp y @vemudo/mcp siguen ofreciendo las mismas 21 herramientas de consulta y envío. Instrucciones por cliente en MCP y asistentes de IA.

2026-11-14 — Agentes de IA: MCP remoto, referencia pública y límites propios

MCP remoto (POST /mcp)

La API expone el protocolo Model Context Protocol (se abre en una pestaña nueva) por HTTP, sin instalar nada: POST https://api.vemudo.com/mcp con la misma clave, los mismos scopes y los mismos límites que /v1. Es Streamable HTTP sin sesiones ni SSE: cada petición es un único mensaje JSON-RPC 2.0 y la respuesta es siempre application/json; GET /mcp y DELETE /mcp devuelven 405.

Las herramientas que devuelve tools/list están filtradas por el scope de la clave que llama. El cuerpo de la petición tiene un máximo de 1 MB y el resultado de una herramienta se recorta a 50 KB con truncated: true si lo supera. Más detalle, con ejemplos, en MCP y asistentes de IA.

Referencia pública del contrato (GET /v1/openapi.json)

GET https://api.vemudo.com/v1/openapi.json sirve el contrato OpenAPI completo de /v1, sin clave, y es cacheable durante 1 hora.

Límites por plan para claves y agentes

Cada clave de API y cada organización tienen, además de la cuota de emails, límites propios de uso como agente: peticiones por minuto por clave, unidades de coste por día por organización (con coste ponderado por operación), peticiones simultáneas por clave y claves activas por organización.

PlanPeticiones/min por claveUnidades de coste/díaPeticiones simultáneasClaves activas
Inicio12010.00033
Beta24020.00055
Crece30050.000510
Pro600150.0001025

El contador de unidades por día es por organización y se reinicia a las 00:00 UTC. Al pasarse cualquiera de estos límites llega un 429 rate_limited con Retry-After. Más detalle en Planes y cuotas y en Errores y límites.

Códigos de error nuevos

Estos códigos son propios de /v1 y de POST /mcp (en /mcp llegan dentro del resultado de la herramienta, con isError: true, en vez de como estado HTTP):

EstadoCódigoQué hacer
403api_key_blockedLa clave está bloqueada por la plataforma. Contacta con soporte.
403agents_blockedLa organización tiene los agentes bloqueados. Contacta con soporte.
403origin_invalidSolo en /mcp: el Origin del navegador no está en la lista permitida.
409api_key_limitSe alcanzó el máximo de claves activas del plan. Revoca una clave o cambia de plan.
429rate_limited (rpm, rpd o concurrencia)Espera Retry-After. extensions lleva limit, window y planCode.
503agents_disabledLos agentes están desactivados temporalmente en la plataforma. Reintenta más tarde.
503rate_limit_unavailableSolo en envíos: el contador de límites no está disponible. Reintenta con espera.
503openapi_unavailableGET /v1/openapi.json no puede leer el contrato en este momento. Reintenta.

Detalle completo del formato de error y del resto de códigos en Errores y límites.

Dos familias de cabeceras de límite

A partir de esta entrada conviven dos familias de cabeceras de límite en las respuestas autenticadas: RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (la ráfaga de 10 peticiones por segundo y organización) y X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (el límite de minuto o de día que se esté aplicando). Ninguna de las dos se retirará sin aviso en esta misma página.

Política de cambios

  • Aditivo, entra sin aviso en esta página: campos nuevos en una respuesta, cabeceras nuevas, endpoints nuevos, valores nuevos en un campo que ya era abierto (por ejemplo, un nuevo tipo de evento de webhook), y nuevos códigos de error dentro de un estado HTTP ya documentado.
  • Se considera ruptura: quitar o renombrar un campo o una cabecera, cambiar el tipo o el significado de un campo existente, cambiar el estado HTTP de un error ya documentado, o quitar un código de error sin sustituirlo.
  • Versión: la API se versiona por el prefijo de ruta (/v1). Un cambio de ruptura implica una nueva versión; /v1 no cambia de forma incompatible mientras siga activo.
  • Retirada: cualquier retirada de un campo, una cabecera o un endpoint lleva aviso previo en este changelog y, en la propia respuesta, las cabeceras Deprecation y Sunset antes de desaparecer.