Claude Code

Integrate GBOX with Claude Code for seamless Android app testing and development workflow.

If you have not installed Claude Code, please check the installation instructions before proceeding.

Getting Started

1. Install GBOX CLI

   Install the GBOX CLI tool to manage your GBOX configuration.

   # Install GBOX CLI
   brew install gbox
   
   # Update GBOX if already installed
   brew update && brew upgrade gbox
   
2. Login and Configure GBOX

   Authenticate with your GBOX account and set up the configuration.

   gbox login
   

   This command will prompt you to enter your GBOX API key and configure your account.

3. Configure the GBOX Android MCP Server for Claude Code using the GBOX CLI

   Enter the command in the command line

   #Using GBOX CLI
   
   #scope param: MCP server scope for claude-code (local|project|user) (default "user")
   gbox mcp export --merge-to claude-code --scope user
   
   #Check merging result
   claude mcp list
   #Expected Output: gbox-android: npx -y @gbox.ai/mcp-server
   
4. Develop and Test Your Android App

   If the installation is correct, you will see the gbox-android mcp server when you type /mcp in Claude.

   

   Then you can give Claude Code instructions using natural language, for example:

   

   By default, GBOX MCP uses a cloud android VM. To connect GBOX to your own Android devices, see Register Local Devices.

   Demo