Sparki Docs

Configurar proyectos mediante MCP

Prepara borradores, sube imágenes, conecta agendas y publica tras la aprobación.

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.

On this page