lite
Buy now

Help Desk › Working with your AI

Connection settings for each AI

The Setup prompt connects your AI for you. Your AI finds its own settings here.

The Setup prompt sends your AI to this page to find the settings for its own kind of AI. Use it yourself only if your AI asks you to do a step.

lite.computer connects to AI tools through MCP (Model Context Protocol), the standard way AI tools work with other apps. The connection stays on your Mac. Once connected, your AI can find, open and arrange your pages for you. See What a connected AI can do for you.

Claude Code

Run once, in a terminal

claude mcp add --scope user lite-computer -- /Applications/lite.computer.app/Contents/MacOS/lite-computer --mcp-stdio

--scope user makes every project see it.

In the Claude desktop app’s Code tab, the claude command may not be installed. Ask Claude to add the lite-computer entry from the Claude Desktop example below to its own user settings instead, so every project sees it.

Codex

Run once, in a terminal

codex mcp add lite-computer -- /Applications/lite.computer.app/Contents/MacOS/lite-computer --mcp-stdio

It saves to ~/.codex/config.toml, which Codex inside the ChatGPT desktop app reads too.

Claude Desktop, including Cowork

Paste this into ~/Library/Application Support/Claude/claude_desktop_config.json. If the file already has entries, add only the lite-computer block inside its mcpServers. Then quit and reopen Claude Desktop.

claude_desktop_config.json

{ "mcpServers": { "lite-computer": { "command": "/Applications/lite.computer.app/Contents/MacOS/lite-computer", "args": ["--mcp-stdio"] } } }

Cursor

Create or edit ~/.cursor/mcp.json so it works in every project. A .cursor/mcp.json inside one folder works only in that folder.

~/.cursor/mcp.json

{ "mcpServers": { "lite-computer": { "command": "/Applications/lite.computer.app/Contents/MacOS/lite-computer", "args": ["--mcp-stdio"] } } }

If the file already lists servers, add only the lite-computer entry inside mcpServers.

Gemini CLI

Run once, in a terminal

gemini mcp add --scope user lite-computer /Applications/lite.computer.app/Contents/MacOS/lite-computer -- --mcp-stdio

The -- passes --mcp-stdio to the app rather than to Gemini CLI.

The command saves the connection in ~/.gemini/settings.json. If an older lite-computer entry sits there or in a project’s .gemini/settings.json, remove it and run the command again.

Google Antigravity

Add this entry to the settings file, then run /mcp inside agy to reload the settings and see the server’s status. In the editor, the same file opens from the agent panel: MCP Servers, then Manage MCP Servers, then View raw config.

~/.gemini/config/mcp_config.json

{ "mcpServers": { "lite-computer": { "command": "/Applications/lite.computer.app/Contents/MacOS/lite-computer", "args": ["--mcp-stdio"] } } }

If the file already lists servers, add only the lite-computer entry inside mcpServers.

ChatGPT

In the ChatGPT desktop app, go to Settings, then MCP servers, then Add server. Pick STDIO, name it lite-computer, enter the command below and the argument --mcp-stdio, save, and restart the app. ChatGPT in a web browser cannot reach an app on your Mac.

Command

/Applications/lite.computer.app/Contents/MacOS/lite-computer

Argument: --mcp-stdio

Cline

For the command-line tool, add the configuration below to ~/.cline/mcp.json. In the editor extension, open MCP Servers, then Configure, then Configure MCP Servers, and add the entry under mcpServers.

~/.cline/mcp.json

{ "mcpServers": { "lite-computer": { "command": "/Applications/lite.computer.app/Contents/MacOS/lite-computer", "args": ["--mcp-stdio"], "disabled": false } } }

If the file already lists servers, add only the lite-computer entry inside mcpServers.

DeepSeek Harness

Merge this patch into ~/.dsh/cordis.patch.yml to connect every profile. Keep any patches already in the file.

cordis.patch.yml entry

- insert: - id: lite-computer name: '@deepseek-ai/dsh-mcp-client' config: serverName: lite-computer transport: stdio command: /Applications/lite.computer.app/Contents/MacOS/lite-computer args: ['--mcp-stdio']

Grok Build

Run this once in a terminal. It adds the app for your whole account, so every folder can use it.

Run once, in a terminal

grok mcp add lite-computer -- /Applications/lite.computer.app/Contents/MacOS/lite-computer --mcp-stdio

Then run grok mcp doctor lite-computer to check the connection.

Hermes Agent

Add this to ~/.hermes/config.yaml, under mcp_servers.

~/.hermes/config.yaml

mcp_servers: lite-computer: command: "/Applications/lite.computer.app/Contents/MacOS/lite-computer" args: ["--mcp-stdio"]

Then run /reload-mcp in an open session.

Kiro

Add this to ~/.kiro/settings/mcp.json. The IDE and the CLI both read this file, and a change applies when you save it.

~/.kiro/settings/mcp.json

{ "mcpServers": { "lite-computer": { "command": "/Applications/lite.computer.app/Contents/MacOS/lite-computer", "args": ["--mcp-stdio"] } } }

If the file already lists servers, add only the lite-computer entry inside mcpServers.

Mistral Vibe

Add these lines to ~/.vibe/config.toml, or to a project’s own .vibe/config.toml if it has one.

Your Vibe config.toml

[[mcp_servers]] name = "lite-computer" transport = "stdio" command = "/Applications/lite.computer.app/Contents/MacOS/lite-computer" args = ["--mcp-stdio"]

Keep your existing settings and server entries.

Muse Code

Add lite.computer to Muse Code as a local (stdio) MCP server named lite-computer, with the command below and the one argument --mcp-stdio. Muse Code keeps its servers in ~/.config/muse/settings.json.

Command

/Applications/lite.computer.app/Contents/MacOS/lite-computer

Argument: --mcp-stdio

Qwen Code

Run this once, in a terminal.

Run once, in a terminal

qwen mcp add --scope user lite-computer /Applications/lite.computer.app/Contents/MacOS/lite-computer --mcp-stdio

It saves to ~/.qwen/settings.json, so every project sees it.

TraeCode

In TraeCode, open Settings, then MCP, then Add, and choose Add Manually. Paste this config.

Add Manually

{ "mcpServers": { "lite-computer": { "command": "/Applications/lite.computer.app/Contents/MacOS/lite-computer", "args": ["--mcp-stdio"] } } }

If the list already has servers, add only the lite-computer entry inside mcpServers.

Anything else

Add it as a local (stdio) MCP server named lite-computer: the command /Applications/lite.computer.app/Contents/MacOS/lite-computer with the one argument --mcp-stdio. The app answers only the Mac account that runs it, so your AI must run on this Mac, signed in as you.

Set up before version 1.5?

Connections made before lite.computer 1.5 used an address, http://127.0.0.1:48484/mcp, that now answers only with a message to update your setup. Replace that entry with the one for your AI above, or paste the Setup prompt into your AI again: it replaces the old entry for you.

Check it worked

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

List every page in my Showspace.

It should answer with the real pages from your folder. If it says it has no lite.computer tools, quit and reopen your AI, then ask again.

What the messages mean

lite.computer is not running. Open it, then start a new conversation.Open lite.computer, then start a new conversation with your AI. A conversation that was already open when the app closed does not reconnect by itself.
lite.computer 1.5 changed how AIs connectYour AI still has a setting from before version 1.5. Replace it with the one for your AI on this page, or paste the Setup prompt again.
no vault openThe app is open with no Showspace. Open one.
lite.computer needs an active license to do this. Open the app to check.The app needs an active trial or a valid license. Open lite.computer to check its status.
unknown toolYour AI asked for a command this version does not have. The list is in Every command your AI has.
not in indexIf the page was saved a moment ago, ask again. The app sees up to 2,000 pages and 20 folders deep, so a page beyond that stays hidden. Move it nearer the top, or split the Showspace.

Still stuck? Write to support@lite.computer.