Quick start

Each application below launches zshot as a local MCP server over stdio by running zshot --mcp-local-server as a subprocess communicating over stdin and stdout. See Agents for transport differences and MCP for HTTP server mode.

The bundled Agent Skill teaches the agent what ZShot does and how to call it. Install it into the directory each app loads skills from, shown below. LM Studio loads no skills and relies on the MCP server’s own tool descriptions.

Claude Code

claude mcp add --transport stdio zshot -- zshot --mcp-local-server
mkdir -p ~/.claude/skills && zshot --install-skill ~/.claude/skills/

Claude Code MCP docs.

Claude Desktop

Add ZShot to claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "zshot": {
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

The file lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS. Build a skill bundle to import from Settings with zshot --install-skill ./zshot.zip.

Claude Desktop MCP docs.

Cursor

Add ZShot to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "zshot": {
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

Install the skill where Cursor loads them:

mkdir -p ~/.cursor/skills && zshot --install-skill ~/.cursor/skills/

Cursor MCP docs · skills.

VS Code

Add ZShot to VS Code’s mcp.json under the top-level servers key:

{
  "servers": {
    "zshot": {
      "type": "stdio",
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

The file lives at ~/Library/Application Support/Code/User/mcp.json on macOS and ~/.config/Code/User/mcp.json on Linux. Copilot’s agent mode loads MCP servers directly — no skill needed.

VS Code MCP docs.

OpenCode

Add ZShot to the mcp block of opencode.json:

{
  "mcp": {
    "zshot": {
      "type": "local",
      "command": ["zshot", "--mcp-local-server"],
      "enabled": true
    }
  }
}

Install the skill where OpenCode loads them:

mkdir -p ~/.agents/skills && zshot --install-skill ~/.agents/skills/

OpenCode MCP docs · skills.

OpenAI Codex CLI

Add the server in one command:

codex mcp add zshot -- zshot --mcp-local-server

Or write the equivalent block to ~/.codex/config.toml:

[mcp_servers.zshot]
command = "zshot"
args = ["--mcp-local-server"]

Install the skill where Codex loads them:

mkdir -p ~/.agents/skills && zshot --install-skill ~/.agents/skills/

Codex MCP docs · skills.

LM Studio

Add ZShot to LM Studio’s mcp.json:

{
  "mcpServers": {
    "zshot": {
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

LM Studio MCP docs.