Quickstart · MCPG

Quickstart · 60 seconds

From zero to a running gateway.

mcpg-ctl quickstart spawns the gateway, the control plane API, and an embedded React dashboard on a single port. State persists in ~/.mcpg/state.db. Browser opens automatically.

Step 1

Install the CLI

Pick the install path that fits your environment.

Step 2

Run quickstart

One command. No config files. No external services.

Step 3

Open the dashboard

Browser auto-opens. The dashboard is the same UI fleet operators use in production.

Step 4

Connect a tool

Define a binding in YAML. The gateway exposes it as an MCP tool immediately.

1. Install

bash

# Cargo
cargo install mcpg-ctl

# Or Homebrew (macOS / Linux)
brew install mcpg-dev/tap/mcpg-ctl

# Or download a binary
curl -fsSL https://mcpg.dev/install.sh | bash

2. Run

bash

mcpg-ctl quickstart

Output: control plane: http://127.0.0.1:7843 · gateway: http://127.0.0.1:8787

3. Connect a tool

yaml

# config.yaml
bindings:
  - id: github
    type: http
    base_url: https://api.github.com
    tools:
      - name: list_repos
        method: GET
        path: /user/repos
        identity_pass_through: true

identity:
  - id: api-key
    type: api-key
    keys:
      - id: alice
        digest: $argon2id$...

policy:
  - id: cedar
    type: policy.cedar
    bundle: ./policies/

4. Reload

bash

mcpg-ctl reload --config config.yaml

You're running MCPG.

Point your MCP client at http://127.0.0.1:8787/mcp. Open the dashboard at http://127.0.0.1:7843 to watch tool calls, plugin status, and audit events stream in.

Production install All guides