SparkLaunch

Paquetes de Agentes Conectados de SparkLaunch

Este repositorio construye habilidades de SparkLaunch y metadatos de paquetes MCP nativos para ChatGPT/Codex, Claude Code, Cursor, Gemini CLI y Muse Code a partir de un único árbol fuente editado a mano.

SparkLaunch ayuda a fundadores a seleccionar o crear un proyecto de negocio, validar una idea, generar activos de marca, publicar superficies de lanzamiento medibles, revisar señales de campañas y páginas de aterrizaje, operar flujos de trabajo CRM privados y preparar casos de incorporación con control de acceso por entitlement con tareas específicas del Action Center por persona.

Soporte de Hosts

Host	Paquete generado	Estado MCP protegido	Límite de distribución
ChatGPT y Codex	plugins/sparklaunch/	OAuth gestionado por el host; se conservan la presentación existente a ChatGPT y los metadatos de Codex	Candidato local; no presentado ni aprobado por este cambio
Claude Code	plugins/claude/sparklaunch/	OAuth MCP basado en navegador a través de Claude Code	Validación de manifiesto nativo superada; candidato local/privado
Cursor	plugins/cursor/sparklaunch/	OAuth MCP gestionado por el cliente	Candidato local/privado/equipo; el Marketplace público está bloqueado por la licencia propietaria actual
Gemini CLI	plugins/gemini/sparklaunch/	/mcp auth sparklaunch a través de Gemini CLI	Candidato CLI heredado compatible con API-key empresarial; el acceso individual Free/Pro/Ultra se trasladó a Antigravity CLI en junio de 2026; la prueba en vivo sigue pendiente
Muse Code	plugins/muse/sparklaunch/	Deshabilitado por diseño: Muse no documenta el ciclo de vida de OAuth que SparkLaunch requiere	Las habilidades son empaquetables; no se reivindica paridad de herramientas protegidas

El aviso de Gemini CLI del 18 de junio de 2026 de Google es la fuente de la transición de cuentas individuales en esta tabla. El adaptador de Gemini sigue siendo distinto de un plugin de Antigravity.

Todos los paquetes habilitados se conectan al mismo endpoint HTTP Streamable:

https://sparklaun.ch/api/mcp/

Ningún paquete contiene un token de portador, clave de API, secreto de cliente, código de autorización o cabecera de autorización estática. Nunca agregue uno como solución alternativa.

Estructura del Repositorio

• src/skills/: fuente canónica de habilidades neutral al host, editada a mano
• src/recipes/: flujos de trabajo canónicos de fundador con múltiples herramientas, editados a mano
• adapters/: manifiestos nativos de host, fragmentos de recuperación de conexión y notas de distribución
• contracts/tools.snapshot.json: descriptores de 61 herramientas derivados del runtime y esquemas de entrada/salida verificados
• plugins/: paquetes generados determinísticamente para los cinco hosts
• sparklaunch-*/ y recipes/: espejos heredados generados compatibles con OpenAI conservados para consumidores existentes
• submission/: evidencia de candidato de revisión de ChatGPT y puertas solo de portal
• release-state.json: límites explícitos de candidato local, Registry, runtime y distribución

No edite archivos generados bajo plugins/, las carpetas de nivel superior sparklaunch-* ni la carpeta de nivel superior recipes/. Edite src/ o adapters/ y luego reconstruya.

Construcción y Validación

Construya cada paquete y espejo de compatibilidad:

python scripts/sync_plugin.py --write

Ejecute la validación independiente sin el repositorio de la aplicación:

python scripts/sync_plugin.py
python scripts/generate_submission.py --check
python scripts/validate_host_packages.py
python scripts/validate_submission.py
python -m pytest tests/test_host_packages.py tests/test_claude_adapter.py tests/test_cursor_adapter.py tests/test_gemini_adapter.py tests/test_muse_adapter.py -q

La instantánea de herramientas verificada hace que un clon independiente de SparkLaunch-Skills sea autónomo para la validación de paquetes y presentación a ChatGPT. Clone los repositorios de aplicación y habilidades como directorios hermanos cuando cambie el contrato de runtime de MCP, luego actualice la instantánea desde el exportador aislado en modo de prueba. La fuente de runtime predeterminada es ../SparkLaunch/backend:

parent/
  SparkLaunch/
    backend/
  SparkLaunch-Skills/

python scripts/export_tool_contract_snapshot.py
python scripts/export_tool_contract_snapshot.py --check
python scripts/generate_submission.py

El exportador construye el runtime hermano contra una base de datos SQLite temporal y registra los descriptores resultantes. No despliega el servidor ni llama a un entorno SparkLaunch alojado.

Entradas Portátiles

incorporation.update_draft acepta exactamente una de dos fuentes sin dirección:

• un objeto estructurado cerrado draft, portátil entre hosts MCP; o
• draft_file, solo cuando el host actual proporciona una referencia de archivo JSON UTF-8 compatible con el servidor.

El mismo límite serializado de 256 KiB, el rechazo de campos extra anidados, el rechazo de campos de dirección, la verificación de versión esperada y el contrato de idempotencia se aplican a ambas rutas.

crm.ingest_business_card sigue siendo intencionalmente limitado. Solo acepta una referencia de archivo host HTTPS de corta duración aprobada por el servidor; los llamadores no deben sustituir URLs arbitrarias, base64 o URLs de datos.

Para hosts sin metadatos de adjuntos compatibles, crm.prepare_business_card_import crea una entrega de primera parte que expira sin importar nada. El fundador inicia sesión en SparkLaunch y elige explícitamente Subir e importar; crm.get_business_card_import luego informa estado seguro. La página, no el agente, suministra la única imagen acotada directamente a la ruta de ingesta de CRM después de que se vuelva a verificar el acceso actual de usuario/proyecto. Este contrato de servicio 1.4.0 se empaqueta localmente; el despliegue y la ejecución en vivo del host siguen sin verificar.

La portabilidad de OAuth tiene el mismo límite de evidencia. El DCR existente es la ruta de registro verificada en producción. El servicio 1.4.0 agrega soporte de Documento de Metadatos de ID de Cliente con control de funciones, con controles de fetch acotado, SSRF, redirección, persistencia/caché y regresión de DCR; la puerta permanece desactivada en la configuración de despliegue verificada, y el comportamiento CIMD alojado no se reivindica en esta compilación de paquete.

Contrato de Seguridad Compartido

1. La autenticación es gestionada por el host. Las habilidades nunca recopilan credenciales ni cabeceras de transporte.
2. projects.list es la fuente de verdad para proyectos accesibles, y las herramientas con ámbito de proyecto reciben un project_id explícito.
3. Cada escritura usa un idempotency_key estable para la mutación exacta. Una escritura incierta se lee de nuevo antes de cualquier reintento.
4. El plan de proyecto, el rol de proyecto, el alcance de OAuth y el entitlement comercial son puertas separadas.
5. Las herramientas destructivas o de estado público exponen anotaciones veraces y usan el límite de vista previa/confirmación gobernada o de versión/idempotencia del runtime.
6. Los archivos generados usan referencias HTTPS de corta duración, nunca base64 crudo ni URLs de datos.
7. Los identificadores y versiones de concurrencia permanecen como estado opaco de llamadas de herramienta; la salida orientada al usuario usa nombres legibles por humanos.
8. Los activos configurados, el estado publicado, el tráfico, la conversión, la persistencia de CRM, el estado de formación, el despliegue y la publicación en marketplace son capas de prueba separadas.

Candidato ChatGPT y MCP Registry

Construya el ZIP del portal de ChatGPT con:

python scripts/build_submission_bundle.py

Los requisitos previos solo de portal permanecen en submission/portal-prerequisites.json. Valídelos con python scripts/validate_portal_prerequisites.py --allow-pending mientras las puertas pendientes explícitas sigan sin resolverse. Un paquete local o una pasada de prueba no prueba la revisión de ChatGPT, el despliegue alojado, el comportamiento de OAuth ni una ejecución real de herramienta.

El server.json raíz es el descriptor de MCP Registry para io.github.SparkLaunch-Dev/sparklaunch. La versión candidata de Registry, la última versión publicada conocida, la versión de instantánea de runtime y el estado de publicación se registran por separado en release-state.json. Publicar una versión inmutable de Registry requiere su flujo de trabajo aprobado dedicado y no se realiza mediante la generación de paquetes.

Habilidades Actuales

• sparklaunch-platform: enrutador amplio de flujos de trabajo de fundador
• sparklaunch-projects: descubrimiento y gestión de proyectos
• sparklaunch-idea-validation: análisis de mercado, competidores y TAM/SAM/SOM
• sparklaunch-color-palettes: generación y recuperación de paletas
• sparklaunch-logo-generation: generación de logotipos y entrega de archivos
• sparklaunch-campaigns: campañas, enlaces cortos, QR, atribución y estadísticas
• sparklaunch-landing-pages: creación de páginas de aterrizaje, publicación, analíticas y leads
• sparklaunch-sales-crm: flujos de trabajo de leads, contactos, negocios, actividades y tarjetas de presentación compatibles
• sparklaunch-incorporation: entitlement, preparación de casos sin dirección, tareas de participantes privados, correcciones, estado y envío interno de Filing Operations

Soporte, Seguridad y Licencia

• Soporte: support@sparklaun.ch
• Reportes de seguridad: SECURITY.md
• Privacidad: Política de Privacidad de SparkLaunch
• Términos: Términos y Condiciones de SparkLaunch
• Licencia: Aviso de Licencia Propietaria de SparkLaunch

La licencia propietaria se conserva. En particular, generar un paquete de Cursor no satisface el requisito de código abierto de Cursor para la presentación al Marketplace público.

Los paquetes de agentes instalados pueden almacenarse en caché por versión de plugin. Por lo tanto, cualquier cambio en el contenido de un paquete publicado requiere una nueva versión gobernada; reconstruir un candidato local no publica ni invalida una caché existente.