Installation

Otto integrates with VS Code through a lightweight extension that connects to the Otto MCP server. This guide covers installation, configuration, and troubleshooting.

System Requirements

  • VS Code 1.85 or later
  • Claude Code subscription (required for implementing recommendations)
  • Node.js 18+ (for Claude Code CLI)
  • Internet connection (Otto runs as a cloud-hosted MCP server)

Install the Extension

Search for Otto in the VS Code Extensions marketplace and click Install. The extension adds an Otto panel to the sidebar and registers MCP server commands.

How It Works

Otto is a cloud-hosted MCP server. The VS Code extension is a thin client that communicates with the server. When you request an assessment or recommendation:

  1. The extension sends context about your project to the Otto MCP server
  2. Otto's proprietary framework processes the request server-side
  3. Computed results are returned to your local environment
  4. Claude Code implements the recommendations using your subscription

Your source code never leaves your machine. Otto only receives metadata and context needed to generate recommendations.

Configuration

After installation, the extension works with default settings. Optional configuration is available in VS Code settings under otto.*:

  • otto.server.region — Preferred server region (default: auto)
  • otto.notifications.enabled — Enable/disable in-editor notifications
  • otto.autoAssess — Automatically run assessments when opening a project

Troubleshooting

Extension not connecting

Check your internet connection and ensure the extension is up to date. Run Otto: Check Connection from the command palette.

Authentication expired

Run Otto: Sign In from the command palette to re-authenticate. Sessions expire after 30 days of inactivity.

No recommendations appearing

Ensure your application is registered in the Otto dashboard and the current repo is associated with it.