| name | deploying-ge-mcp-cowork-portal |
| description | Replicates, configures, and spins up the local Gemini Enterprise MCP Co-work Portal web application. Use when the user requests replicating, deploying, or testing the co-work portal web app. |
Deploying the Gemini Enterprise MCP Co-work Portal
This skill provides a self-contained replication playbook to clone the co-work portal, compile dependencies, configure credentials, and run it locally.
When to use this skill
- Creating a sandbox replication of the Co-work Portal.
- Re-deploying the React frontend and FastAPI backend under a new GCP project or Vertex AI Engine configuration.
- Instantiating a clean copy of the portal for testing new MCP features.
Workflow
To execute the deployment and verify it:
- Replication & Configuration: Run the interactive setup script
setup.py. The script copies the core source template to a fresh destination folder, writes a local .env with the project settings, and runs package installs.
- Startup: Navigate to the destination directory and launch
./start.sh to spin up both the FastAPI backend (port 8001) and React/Vite server (port 5173).
- Browsing: Navigate to
http://localhost:5173/ and test tools or follow-up recommendation shortcuts.
- Teardown: Run the teardown script
teardown.py to remove the cloned directory and clear tracking logs.
graph TD
A[Start] --> B[setup.py]
B --> B1[Prompt user or resolve CLI arguments]
B1 --> B2[Create target clone folder]
B2 --> B3[Write .env configuration]
B3 --> B4[Run npm install & setup backend]
B4 --> C[Run ./start.sh]
C --> D[Open http://localhost:5173/]
D --> E[teardown.py]
E --> E1[Confirm delete target folder]
E1 --> E2[Clean up metadata]
E2 --> F[End]
Instructions
1. Running the Setup
Execute the following command in the workspace root:
uv run agy-recipes/ge-mcp-cowork/scripts/setup.py
Tip: To run silently (non-interactively) during automation playbooks, pass parameters directly:
uv run agy-recipes/ge-mcp-cowork/scripts/setup.py \
--destination ~/IdeaProjects/my-portal-clone \
--project-id vtxdemos \
--project-number 254356041555 \
--engine-id jira-testing_1778158449701 \
--non-interactive
2. Startup & Execution
Go to the target folder and start:
cd ~/IdeaProjects/my-portal-clone
./start.sh
3. Cleaning Up
To delete the created portal folder and all files to save space:
uv run agy-recipes/ge-mcp-cowork/scripts/teardown.py
Resources
