> ## Documentation Index
> Fetch the complete documentation index at: https://mcpconfig.plaino.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install mcpconfig and run your first commands

## Get started in three steps

Install mcpconfig and see your MCP configs and servers in a few minutes.

### Step 1: Install mcpconfig

<Steps>
  <Step title="Install globally (recommended)">
    ```bash theme={null}
    npm install --global @yash_pandit/mcpconfig
    ```

    This gives you the `mcpconfig` command everywhere.
  </Step>

  <Step title="Or run without installing">
    ```bash theme={null}
    npx @yash_pandit/mcpconfig list-clients
    npx @yash_pandit/mcpconfig list-servers
    ```

    Use this to try it once or in scripts.
  </Step>
</Steps>

<Tip>
  You need **Node.js 16 or newer**. Check with `node --version`.
</Tip>

### Step 2: List your MCP configs

See which MCP config files exist on your system and where they are:

```bash theme={null}
mcpconfig list-clients
```

You get one line per config: app name, ✓ or ✗ (found or not), and the full path when found.

To see every known config location (including ones that don't exist yet):

```bash theme={null}
mcpconfig list-clients --all
```

### Step 3: List all MCP servers (or add one)

See every MCP server from every found JSON config and Codex TOML in one table:

```bash theme={null}
mcpconfig list-servers
```

The table shows **APP**, **SERVER**, **COMMAND**, and **ARGS**.

To add a new MCP server to one or more configs interactively:

```bash theme={null}
mcpconfig add-server
```

You select which apps to write to (↑/↓ move, **Space** toggle, **Enter** continue), then enter server name, command, and args. The server is written to every selected config (JSON or Codex TOML).

## Next steps

<CardGroup cols={2}>
  <Card title="Install options" icon="download" href="/install">
    Install from source or use npm link for development.
  </Card>

  <Card title="Commands" icon="terminal" href="/commands/overview">
    Full command and option reference.
  </Card>

  <Card title="Add a server" icon="plus" href="/commands/add-server">
    Interactive add-server flow and supported configs.
  </Card>

  <Card title="Remove a server" icon="trash" href="/commands/delete-server">
    Interactive delete-server flow.
  </Card>

  <Card title="Supported apps" icon="gear" href="/reference/supported-apps">
    Config paths for each supported app.
  </Card>
</CardGroup>