stitch-setup

Stitch Setup Command

Set up and verify the Stitch MCP server connection for automated screen generation.

Execution

Step 1: Check MCP Availability

Check if Stitch MCP tools are available by looking for the generate_screen_from_text tool.

• If available: Proceed to Step 2 (verification)
• If not available: Proceed to Step 3 (setup guidance)

Step 2: Verify Connection

If MCP tools are detected:

1. Call list_projects to verify the connection works

2. Handle errors:

   • If 403 Forbidden: The Stitch API requires preview/allowlist access from Google. Report:

     Stitch MCP: Connection Failed (403 Forbidden)
     
     The Google Stitch API requires preview access. This API is not yet
     generally available and requires allowlist approval from Google.
     
     To stop the failing MCP server from retrying:
       claude mcp remove stitch
     
     To check MCP status:
       claude mcp list
     
     Once you have Stitch API access, run /stitch-setup again.
     

   • If authentication error (message contains "invalid authentication credentials", "OAuth 2 access token", or "Token fetch failed"):

     The MCP server connected but the isolated credentials at ~/.stitch-mcp/config have expired. This commonly happens when doctor passes but API calls fail.

     Proceed directly to Step 2b (Credential Refresh) - no diagnostic needed since the error message already identifies the issue.

   • If MCP tools unavailable but stitch is configured: The MCP server may be failing to connect. Proceed to Step 2a (Proxy Diagnostic).

   • If other error: Report the error and suggest checking ADC credentials

3. On success, run the doctor command to validate the full setup:

   npx @_davideast/stitch-mcp doctor
   

   This validates: CLI installation, user login, credentials, project config, API reachability.

4. Report status:

   Stitch MCP: Connected
   Projects found: {count}
   Project ID: {STITCH_PROJECT_ID or "not set"}
   
   Ready to use:
     /prompt       - Author Stitch prompts (with auto-generate offer)
     /stitch-generate - Full pipeline: author -> generate -> fetch