Kobiton for Claude Code

Kobiton for Claude Code connects Claude Code to the Kobiton mobile testing platform. You can manage devices, upload apps, run automation tests, and review results using natural language commands without switching between the terminal, the Kobiton portal, and local test scripts.

Join our Discord Kobiton Cloud

  • For the best experience, use Claude Code instead of Claude.ai. MCP integration in Claude.ai may be unreliable.

  • The instructions in this document applies to Cloud only. Standalone and Cloud with custom domain instructions are coming soon.

Get started

Open a workspace folder

Before using Claude Code, open a command-line tool on your machine:

  • macOS: Terminal

  • Windows: PowerShell or Command Prompt

Create a folder:

mkdir kobiton-project

You can create this folder anywhere, for example in your Documents directory.

Next, start Claude Code from that location:

cd kobiton-project
claude

Claude Code uses this folder as its workspace.

Install the plugin

Once Claude Code starts in your Terminal, run the following commands one at a time in that window:

/plugin marketplace add kobiton/automate

then

/plugin install automate@kobiton

Both steps are required and must be run separately.

Authentication

Kobiton MCP supports:

  • OAuth authentication (recommended)

  • API key authentication

OAuth authentication is the default authentication method for Claude Code.

OAuth authentication (recommended)

Add the Kobiton MCP server to .mcp.json:

{
  "mcpServers": {
    "kobiton": {
      "type": "http",
      "url": "https://api.kobiton.com/mcp"
    }
  }
}

The first time you use the plugin, Claude Code opens a browser window for authentication.

Sign in using:

  • Kobiton credentials

  • Google

  • GitHub

Claude Code stores OAuth tokens automatically for future sessions.

API key authentication

Use API key authentication for:

  • CI/CD pipelines

  • headless environments

  • systems without browser access

Generate an API key in Kobiton Portal > Settings > API Keys. Then set:

export KOBITON_AUTH="Basic $(echo -n 'username:api-key' | base64)"

Update .mcp.json to include the Authorization header.

OAuth and API key authentication cannot be used together in the same .mcp.json configuration.

OAuth uses browser-based authentication and token management, while API key authentication uses explicit authorization headers. Configure only one authentication method at a time.

Run a command

After authentication, enter commands in Claude Code using natural language.

Show available Android devices
Show results for session 12345
Upload app.apk and run tests/smoke_test.js

Common workflows

The Claude Code plugin supports common mobile testing workflows, including device management, app uploads, test execution, and session review.

Device management

  • View available devices

  • Check device status

  • Reserve and release devices

App management

  • Upload Android and iOS apps

  • View uploaded apps

  • Get app details

Test execution

The run-automation-suite workflow guides you through the full test lifecycle:

  • Upload or select an app

  • Select a device

  • Parse capabilities from your script

  • Run the test

  • Return results and artifacts

Supported languages:

Language Extension Command

Node.js

.js

node <script> <udid>

Python

.py

python <script> <udid>

.NET

.cs / .csproj

dotnet test

Java

.java

mvn test or java -cp …​

Session management

  • View active and past sessions

  • Get logs, screenshots, and videos

  • Stop running sessions

Example prompts

Device management

Show available Android devices
Check if Galaxy S23 is available
Reserve Pixel 6 for 60 minutes

App management

Show uploaded Android apps
Upload resources/apps/GS.apk

Test execution

Run tests/smoke_test.js on a Pixel device

Session management

Show running sessions
Get details for session 12345
Download logs from last failed session

For a complete reference of available Claude Code plugins, commands, agents, and skills, see the plugin and tools reference.

Troubleshooting

Claude keeps asking to open a folder

Open or create a folder in Claude Code before running plugin commands.

Browser does not open for login

Ensure a default browser is set and you are not in a restricted environment.

Device not found

The device may be unavailable. Filter for available devices.

Upload timeout

Large files or slow connections can cause timeouts. Retry the upload.

Session stuck

Terminate the session and run it again.

Authentication not recognized

Reload your shell and restart Claude Code.

Additional resources