Quickstart

Get a working Forgeline server running in about a minute. This assumes Python 3.11+ and a recent uv or pip.

1. Install

# via uv (recommended)
uv tool install forgeline-mcp

# or via pip
pip install forgeline-mcp

2. Configure

Create ~/.forgeline/.env:

FORGELINE_HOST=127.0.0.1
FORGELINE_PORT=8766
FORGELINE_WORKSPACE_ROOT=/home/you/work
FORGELINE_AUTH_TOKEN=<generate a random string>

The server refuses to start if FORGELINE_AUTH_TOKEN is empty. This is intentional — the public tunnel variant of the server exposes tools that can read and write files.

3. Run

forgeline serve

You should see:

[forgeline] workspace=/home/you/work auth=enforced
[forgeline] listening on http://127.0.0.1:8766/mcp

4. Connect a client

Point any MCP client at http://127.0.0.1:8766/mcp with the bearer token you set. For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "forgeline": {
      "url": "http://127.0.0.1:8766/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

5. Optional — expose via tunnel

For remote clients (Notion AI, ChatGPT):

cloudflared tunnel --url http://127.0.0.1:8766

Use the trycloudflare.com URL it prints. Bearer auth is now your only perimeter — keep the token private.