MCP server

Octoweb serves the Model Context Protocol on localhost:3434/mcp. Any MCP-compatible client — Claude Desktop, octomind, your own script — can navigate, read, and interact with real pages in a window you can watch.

Connecting a client

The server starts with the browser — there is nothing to install, enable, or run. Point any MCP client at the URL above.

Claude Code

Claude Desktop, Cursor, and other JSON clients

{
  "mcpServers": {
    "octoweb": {
      "type": "http",
      "url": "http://localhost:3434/mcp"
    }
  }
}

octomind

Add the server to your octomind config. The session /mcp command is read-only — use /mcp list to confirm the tools arrived.

[[mcp.servers]]
name = "octoweb"
type = "http"
url = "http://localhost:3434/mcp"
timeout_seconds = 30

Focus and workspace rules

• browser_navigate always opens in the background, in a new tab or in place via tab_id. It never steals focus.
• browser_switch_tab is the only tool that changes what you are looking at.
• One server covers every workspace. The X-Octoweb-Workspace header decides which workspace a request acts on; callers without a token fall through to the first one.
• Set OCTOWEB_MCP_PORT and OCTOWEB_CONFIG_DIR to run a second, isolated instance — useful for test suites.