Configurar proyectos mediante MCP

Conexión y permisos

El servidor MCP está en https://api.sparki.app/external-ai/mcp y usa OAuth. Cada conexión pertenece a un portal y a un usuario.

• La lectura y escritura tienen scopes separados para proyectos, contenido y agendas.
• Los scopes nuevos requieren volver a conectar y dar consentimiento explícito.
• El catálogo devuelto por tools/list es la referencia.

Aprobación de escrituras

Cada escritura comienza con una vista previa sin approved. Después de revisarla, repite exactamente los mismos argumentos con approved: true y el approvalToken. La aprobación caduca a los diez minutos.

• Reutiliza la misma idempotencyKey al reintentar.
• Los argumentos modificados necesitan otra vista previa.
• Una herramienta no puede cambiar de portal mediante un ID.

Tareas disponibles

MCP puede actualizar traducciones de contenido, preparar borradores, subir imágenes, conectar agendas y publicar un borrador aprobado. Los campos traducidos usan un objeto como { default: 'Texto', esES: 'Texto', enGB: 'Text' }.

• Publicar y añadir disponibilidad requieren aprobaciones separadas.
• MCP no crea reservas de clientes ni modifica la facturación.
• Prueba las configuraciones nuevas en un portal de demostración.

Miniatura del proyecto

get_project y list_projects devuelven thumbnail o null. Sube la imagen con upload_project_draft_image y pasa input: { thumbnail: { draftFileId: "archivo-uuid" } } a update_project_draft. Una miniatura existente del mismo proyecto usa { id }. Una imagen de la galería requiere una subida independiente. Omitir el campo conserva la miniatura; thumbnail: null la elimina al publicar. La galería no cambia. Siguen siendo necesarias la vista previa, la revisión y la aprobación de publicación.

Formularios y ofertas

create_project_draft y update_project_draft aceptan workflowId y preValidationWorkflowId existentes del mismo portal. El primero admite GENERAL o BIDDING; el segundo solo PRE_VALIDATION. Usa null para quitar la conexión. Estas herramientas no crean ni editan formularios.

Para preparar las ofertas, usa settings: { isBiddingActive: true, biddingStatus: "open" }. Los estados son not-started, open, closed y cancelled. Los demás ajustes se conservan. Publicar tras la aprobación puede habilitar ofertas públicas, pero no publica un registro de ofertas. Se mantienen las revisiones, los permisos del portal y los límites del plan. Los borradores del panel solo se completan en el panel.

Si se deniega el acceso a Content después de reconectar, comprueba allowedScopes del cliente OAuth. El consentimiento no puede superar esa lista. Registra un cliente con content:read y content:write, vuelve a conectar y aprueba esos scopes. Los clientes y permisos existentes no se amplían automáticamente.