Upload-to-Stitch

Envoyez des ressources locales (images, maquettes, fichiers HTML) vers un projet Stitch en utilisant le script fourni, qui contourne les limites de tokens de sortie en base64 de l'outil MCP.

[!NOTE] Le modèle IA ne peut pas envoyer des fichiers via les outils MCP directement car l'encodage base64 d'un petit fichier dépasse déjà la limite de tokens de sortie du modèle (~16K tokens). Ce script lit le fichier et l'envoie directement via HTTP.

Steps

1. Identify Target Project

Utilisez list_projects pour trouver le projectId correct.

2. Get the API Key

Localisez votre fichier de configuration MCP server actif et extrayez la clé API :

• Antigravity: .gemini/antigravity/mcp_config.json ou .gemini/jetski/mcp_config.json
• Gemini CLI: ~/.gemini/settings.json ou ~/.gemini/extensions/Stitch/gemini-extension.json
• Claude Code: ~/.claude.json

Extrayez :

• API Key: Du header X-Goog-Api-Key ou de l'argument auth
• MCP URL (optionnel): Du httpUrl ou de l'argument endpoint (par défaut https://stitch.googleapis.com)

[!IMPORTANT] Si vous ne trouvez pas la clé API dans aucun de ces emplacements, ou si vous ne pouvez pas accéder à ces fichiers, vous DEVEZ demander à l'utilisateur de fournir la clé API Stitch. N'avancez pas sans une clé API valide.

3. Run Upload Script

[!WARNING] Checkpoint — Confirmation utilisateur requise. Avant d'exécuter le script d'envoi, vous DEVEZ faire une pause et présenter le(s) fichier(s) à envoyer (chemins, tailles et types) à l'utilisateur et attendre l'approbation explicite. N'exécutez PAS le script d'envoi avant que l'utilisateur ne confirme.

Utilisez run_command pour exécuter le script Python :

python3 <SKILL_DIR>/scripts/upload_to_stitch.py \
  --project-id <PROJECT_ID> \
  --file-path <PATH_TO_FILE> \
  --api-key <API_KEY> \
  [--api-url <STITCH_API_URL>] \
  [--title <SCREEN_TITLE>]

[!TIP] macOS / Dépannage du certificat SSL: Si l'envoi échoue avec ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] unable to get local issuer certificate, cela signifie que votre installation Python n'a pas d'autorités de certificat racine configurées. Corrigez-le en utilisant le préfixe SSL_CERT_FILE avec le bundle certifi :

SSL_CERT_FILE=$(python3 -c "import certifi; print(certifi.where())") python3 <SKILL_DIR>/scripts/upload_to_stitch.py \
  --project-id <PROJECT_ID> \
  --file-path <PATH_TO_FILE> \
  --api-key <API_KEY>

Supported File Types

Le script détecte automatiquement le type MIME à partir de l'extension du fichier.

Script Defaults

• --api-url est par défaut https://stitch.googleapis.com
• --api-key est requis
• Les instances d'écran sont créées automatiquement pour l'affichage
• Pour les fichiers HTML, screenType est défini à DOCUMENT ; pour les images, IMAGE