Create wiki page 'Quick Start'

2026-05-14 19:43:42 +00:00
parent 9b273594ac
commit e89564efb4
1 changed files with 53 additions and 0 deletions
@@ -0,0 +1,53 @@
+# ⚡ Quick Start
+
+Get the Strava MCP Server running in under 2 minutes — no repository clone required.
+
+## Step 1: Authenticate
+
+Run the interactive setup wizard. It will open a browser window, guide you through creating a Strava API app, and save your credentials automatically.
+
+```bash
+uvx --from strava-mcp-server-hnrx auth
+```
+
+The wizard will:
+1. Open `http://localhost:8765` in your browser
+2. Show you how to create a Strava API application
+3. Accept your **Client ID** and **Client Secret**
+4. Redirect you to Strava for OAuth authorization
+5. Save all credentials to `~/.config/strava-mcp-server/config.env`
+
+> ℹ️ You only need to run `auth` once. The credentials are stored permanently in your user config directory.
+
+## Step 2: Run the Server
+
+```bash
+uvx --from strava-mcp-server-hnrx server
+```
+
+The server starts in **STDIO mode** by default — perfect for use with Claude Desktop, Cursor, or the MCP Inspector.
+
+For HTTP mode (e.g. for Docker or OpenWebUI):
+
+```bash
+MCP_TRANSPORT=http uvx --from strava-mcp-server-hnrx server
+```
+
+## Step 3: Connect your AI Client
+
+→ See [MCP Clients](MCP-Clients) for Claude Desktop, OpenWebUI, and other client configurations.
+
+---
+
+## What happens next?
+
+Once connected, your AI assistant can:
+- Analyze your training load and weekly volume
+- Compare activities across seasons
+- Identify your best segments and performances
+- Track gear mileage and recommend maintenance
+- Generate structured training reports
+
+---
+
+*Back to [Home](Home)*