Comprende los agentes de IA y la API
Qué pueden hacer agentes de IA como Claude, ChatGPT, Claude Code, Codex y Cursor en tu espacio de trabajo de Clevera, las formas de conectarlos, los planes (Pro en adelante), los límites, los roles, los costes y la seguridad.
AI agents & API permite que aplicaciones de IA como Claude, ChatGPT, Claude Code, Codex y Cursor, así como tus propios scripts, trabajen en tu espacio de trabajo de Clevera: buscar grabaciones, solicitar vídeos, clips sociales y artículos, exportar vídeos y trabajar en sitios de documentación. Tú decides exactamente qué puede hacer cada agente, cuántos créditos puede gastar y cuándo debe aprobar algo una persona.
Qué pueden hacer los agentes
| Área | Qué puede hacer un agente |
|---|---|
| Vídeos | Listar y leer tus grabaciones, vídeos, artículos y transcripciones; solicitar vídeos explicativos, demostraciones de productos, vídeos limpios y estilizados a partir de una grabación, clips sociales, artículos a partir de una grabación y traducciones de vídeo; exportar MP4s hasta 4K; añadir imágenes, vídeos y PDFs a tus subidas. |
| Sitios de documentación | Leer, redactar, organizar, traducir y publicar páginas de sitios de documentación y el registro de cambios, responder a lectores desde páginas publicadas, leer información sobre los lectores y cambiar los ajustes del sitio o crear sitios. |
Los agentes aún no pueden realizar investigaciones en sitios web ni recorridos grabados.
El agente realiza la solicitud; la IA de Clevera crea el vídeo o el artículo, de la misma manera que cuando lo inicias en la aplicación. Un agente nunca ve más de lo que su propietario podría ver: las grabaciones en una colección privada permanecen ocultas a menos que el propietario del token tenga acceso.
Formas de conectar
| Forma | Para | Configurar en |
|---|---|---|
| Token de API | Claude Code, Codex CLI, Cursor, cualquier cliente MCP y tus propios scripts a través de la API REST | Tokens → Nuevo token. Consulta Crear un token de API. |
| Aplicaciones conectadas | Claude (claude.ai) y ChatGPT como conector personalizado; sin token, inicias sesión | La aplicación, con la URL del conector desde Aplicaciones conectadas. Consulta Conectar aplicaciones y agentes de IA. |
| API REST | Scripts y servicios de backend | Un token de API. Consulta Usar la API REST. |
El servidor MCP es https://app.clevera.ai/mcp y la API REST está bajo https://app.clevera.ai/api/v1.
Encontrar la página
Abre el menú del espacio de trabajo y elige AI agents & API. En los sitios de documentación, también se encuentra en la página de inicio de Docs y en el menú de Ajustes de un sitio. La página ("Deja que Claude, Codex, ChatGPT y tus scripts trabajen en este espacio de trabajo.") tiene cinco pestañas, cada una con su recuento:
| Pestaña | Qué hay allí |
|---|---|
| Tokens | Tus tokens de API; los propietarios y administradores ven cada token. Gestionar tokens de API |
| Aplicaciones conectadas | La URL del conector y las aplicaciones que la gente conectó. Conectar aplicaciones y agentes de IA |
| Solicitudes del agente | Trabajo pagado esperando a que una persona lo apruebe, con una insignia de recuento, y el historial. Controlar el gasto y las aprobaciones del agente |
| Webhooks | Notificaciones firmadas a tus propios sistemas. Configurar webhooks |
| Actividad | Lo que hicieron los agentes. Leer la actividad del agente |
Planes
AI agents & API está disponible en los planes Pro, Negocios y Personalizado. Esto incluye tokens de API, conectores para Claude y ChatGPT, y webhooks.
En los planes Free y Starter, la página muestra "AI agents & API están incluidos en Pro": "Actualiza para dejar que Claude, ChatGPT y tus scripts trabajen en este espacio de trabajo. Los tokens y aplicaciones existentes dejarán de funcionar hasta entonces; aún puedes revocarlos aquí." Haz clic en Actualizar a Pro. Los controles bloqueados dicen "La API y el acceso de agentes están en Pro en adelante.", "Los conectores de Claude.ai y ChatGPT están en Pro en adelante." o "Los webhooks están en Pro en adelante."
| Límite | Pro, Negocios, Personalizado |
|---|---|
| Tokens de API activos por espacio de trabajo | 50 |
| Aplicaciones conectadas por persona | 20 |
| Webhooks por espacio de trabajo | 10 |
| Aprobar automáticamente por debajo de como máximo | Pro y Negocios: 500 créditos. Personalizado: 1.000 créditos. |
Si el espacio de trabajo deja el plan Pro
No se elimina nada, pero todo se pausa hasta que vuelvas a actualizar:
| Después de cambiar a Starter o Free | |
|---|---|
| Tokens de API | Permanecen listados y pueden revocarse. Cada llamada es rechazada: "La API de agentes no está en el plan de este espacio de trabajo. Está en Pro en adelante." No pueden regenerarse (Regenerar secreto abre el diálogo de actualización). |
| Aplicaciones conectadas | Permanecen listadas y pueden desconectarse. Sus llamadas fallan; Claude o ChatGPT solo pueden decir que no pudieron conectar. |
| Webhooks | Permanecen listados, pero no se envía nada. Enviar evento de prueba y Reenviar dicen "Los webhooks no están en tu plan." |
| Solicitudes del agente | Aprobar dice "La API y el acceso de agentes no están en tu plan." Denegar sigue funcionando. |
| Nuevos tokens | "La API y el acceso de agentes no están en tu plan." |
Actualizar de nuevo a Pro hace que los tokens, aplicaciones y webhooks vuelvan a funcionar. Los tokens siguen caducando en sus fechas originales.
Quién puede hacer qué
Un agente actúa como la persona que creó su token o lo conectó, dentro de lo que permite el rol de esa persona. Nunca puede hacer más de lo que esa persona podría hacer en la aplicación, y el rol se verifica en cada llamada, por lo que un cambio de rol surte efecto de inmediato.
| Tarea | Propietario | Administrador | Editor | Creador de contenido |
|---|---|---|---|---|
| Crear tokens y conectar aplicaciones para ti mismo | Sí | Sí | Sí | Sí |
| Ver y revocar cada token y aplicación en el espacio de trabajo | Sí | Sí | Solo propios | Solo propios |
| Dar permiso a un agente para solicitar vídeos y gastar créditos | Sí | Sí | No | Sí |
| Dar permiso a un agente para publicar sitios de documentación | Sí | Sí | Sí | No |
| Aprobar trabajo pagado solicitado por agentes | Sí | Sí | No | No |
| Gestionar webhooks | Sí | Sí | No | No |
La lista completa está en Permisos de agente.
Qué cuesta
- Las llamadas a la API y MCP son gratuitas: leer, buscar, citar y comprobar un trabajo no cuesta créditos. Tampoco las exportaciones de vídeo.
- El trabajo que utiliza IA cuesta créditos, igual que cuando lo inicias en la aplicación: vídeos, clips sociales, artículos a partir de grabaciones, traducciones y páginas de sitios generadas por IA.
- Un agente solo puede iniciar trabajo pagado con un token que tenga
credits:spend. Cada inicio se presupuesta primero y se verifica contra los límites de gasto del token, y una persona lo aprueba a menos que esté por debajo de la línea de Aprobar automáticamente por debajo de del token. Consulta Controlar el gasto y las aprobaciones del agente.
Cómo mantiene Clevera a los agentes seguros
- Los tokens siempre caducan: después de 7 días, 30 días, 90 días o 1 año. No existe el "nunca".
- Los secretos se muestran una vez. Clevera solo almacena una huella digital y muestra los últimos cuatro caracteres.
- Acceso mínimo. Cada token solo tiene los permisos, sitios de documentación y direcciones IP que tú elijas.
- Las personas aprueban el dinero. Un agente no puede aprobar su propio gasto; solo el propietario del espacio de trabajo o un administrador puede hacerlo.
- Los tokens filtrados se revocan. Un token de Clevera encontrado en un repositorio público de GitHub se revoca automáticamente.
- Se detiene la actividad inusual. Las ráfagas de llamadas rechazadas revocan el token; las ráfagas de cambios o gastos lo pausan, y se notifica al propietario.
- Todo queda registrado en Actividad, conservado durante 13 meses. Las ediciones de sitios de documentación de un agente también aparecen en el historial de la página como "Agente nombre (token)".