Give your AI the app's commands

Two things connect your AI to lite.computer. The paragraph in Connect your AI to the app tells it where to write. This one gives it the app's commands: list every page, search, read one, check for broken links, put a page on your screen, and lay windows across your displays.

The app runs a small connection point while it is open — an MCP server, the standard AI tools use to talk to software. It listens only on your own Mac. There is nothing to install. You give your agent the address once, with the line for it below.

Claude Code

Run once, in a terminal

claude mcp add --scope user --transport http lite-computer http://127.0.0.1:48484/mcp

--scope user makes every project see it.

Codex

Run once, in a terminal

codex mcp add lite-computer --url http://127.0.0.1:48484/mcp

Codex inside the ChatGPT desktop app reads the same settings file.

Claude Desktop, including Cowork

Claude Desktop starts its helpers itself rather than connecting to an address, so it needs a small go-between called mcp-remote. Paste this into ~/Library/Application Support/Claude/claude_desktop_config.json — inside mcpServers if the file already has entries — then quit and reopen Claude Desktop.

claude_desktop_config.json

{ "mcpServers": { "lite-computer": { "command": "npx", "args": ["-y", "mcp-remote", "http://127.0.0.1:48484/mcp"] } } }

The first run downloads mcp-remote, which needs Node.js on your Mac.

Cursor

Create or edit .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project.

.cursor/mcp.json

{ "mcpServers": { "lite-computer": { "url": "http://127.0.0.1:48484/mcp" } } }

Gemini CLI

Run once, in a terminal

gemini mcp add lite-computer http://127.0.0.1:48484/mcp

Anything else

Give it http://127.0.0.1:48484/mcp as a Streamable HTTP MCP server. If your tool can only start helpers, wrap the address with mcp-remote exactly as in the Claude Desktop example.

Check it worked

With the app open on a Showspace, ask your agent:

Which lite.computer tools do you have? List them by name.

It should name fourteen. Then:

List every page in my Showspace.

It should answer with the real paths from your folder. If it says it has no such tool, restart the agent and check the line above. If it answers from memory, tell it to use the tool.

What the messages mean

Cannot connectThe app is not open. Or its usual port, 48484, was taken by another program — the app shows a banner naming the one it is using instead, and the address changes to match.

no vault openThe app is open with no Showspace. Open one.

license requiredThe trial has ended and no key is entered. Every command waits for a license.

unknown toolThe agent asked for a command that is not in this version. The list is in Every command your AI has.

not in indexThe page was saved a moment ago, or the folder is past the 500-file limit. Ask again.

What it can do once it is connected: What your AI can ask the app to do, in plain words, and Every command your AI has, the list by name.