Skip to main content

Start with the MCP Server

The Kotzilla MCP Server is the fastest path from zero to fixing production issues in your app. Once installed in your AI coding assistant, a single prompt registers your app on the Kotzilla Platform and applies all SDK changes to your project, so your first captured session is ready for root cause analysis and guided fixes.

Prerequisites​

  • An MCP-compatible tool (Claude Code, Cursor, Windsurf, Android Studio, or any other MCP-compatible assistant).
  • A Kotzilla account. If you do not have one yet, create a free account at console.kotzilla.io.
  • Access to the project files for the app you want to monitor.

Step 1: Install the MCP Server​

Add the Kotzilla MCP Server to your AI assistant's MCP configuration file:

  • Claude Code: ~/.claude/.mcp.json
  • Cursor: .cursor/mcp.json
  • Windsurf: ~/.codeium/windsurf/mcp_config.json
  • Android Studio: MCP configuration depends on the AI assistant plugin you use. For JetBrains AI Assistant or Junie, add the Kotzilla server from their MCP settings panel (typically under Settings → Tools → AI Assistant, the path varies by Android Studio version). You can also run Claude Code (or any of the CLI assistants listed above) from the Android Studio terminal.
  • Any other MCP-compatible tool: configure the endpoint https://mcp.kotzilla.io/mcp using the mcp-remote transport.

Use the following configuration:

{
  "mcpServers": {
    "kotzilla": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.kotzilla.io/mcp"]
    }
  }
}

Step 2: Authenticate with your Kotzilla account​

On first use, your assistant will prompt you to authenticate with your Kotzilla account. Follow the browser flow to complete sign-in.

If you do not have a Kotzilla account yet, switch to the Sign up tab in the authentication form to create a free one without leaving the flow.

Step 3: Register your app and set up the SDK​

In your assistant, ask:

Register my app on Kotzilla and set up the SDK

The assistant will:

  1. Read your project structure to detect the package name and app type.
  2. Register the app on the Kotzilla Platform.
  3. Apply all SDK changes: version catalog entries, Gradle plugin, kotzilla.json, and the monitoring() call in your Koin setup.

Review the proposed changes, sync the project, and run a build.

Step 4: Capture your first session and start asking​

Run your app. As soon as the first session is captured, you can start asking performance and stability questions through natural language. See What you can ask for example prompts covering reports, version comparison, root cause analysis, crash investigation, and guided fixes.

Manual setup​

If you prefer to set up the SDK manually without MCP tools, use one of the following flows:

You can then follow the dedicated SDK setup steps for your app type:

Technical requirements​

The MCP Server works with any project that meets the Kotzilla SDK requirements. See the Get started overview for the full supported matrix.