Mogplex · charlesrhoward · Sep 22, 2026 · Sep 22, 2026 · Sep 22, 2026 · Sep 22, 2026
@@ -122,7 +122,7 @@ OAuth resource on the `https://mogplex.com` origin shown above.
 ## Personal access token fallback
 
 OAuth is the preferred path. If a client cannot complete remote MCP OAuth,
-create a personal access token in **Mogplex → Settings → API Keys** and send it
+create a personal access token in [Settings → Mogplex Keys](/web/settings#mogplex-keys) and send it
 as `Authorization: Bearer mog_...`. Never put a PAT in a prompt, repository, or
 checked-in configuration file.
 

@@ -8,6 +8,9 @@ import { Callout } from 'fumadocs-ui/components/callout';
 Use this guide to choose a plan and understand each charge. For current account
 details, open [Settings → Billing](https://mogplex.com/settings/billing).
 
+Use **Billing Settings** for the plan, payments, invoices, and credit purchases.
+Use **Usage** for the inference balance and recent usage costs.
+
 ## Individual plans
 
 Each Individual plan includes one named user, parallel agent runs, Storage, and
@@ -34,7 +37,7 @@ See [Mogplex pricing](https://mogplex.com/pricing) for the public pricing page.
 $1 of inference credit pays for $1 of model usage at the model provider price.
 Included credit resets each month. Purchased credit never expires.
 
-Billing offers these one-time purchases:
+**Billing Settings** offers these one-time purchases:
 
 - Pay $1 and get $1 of inference credit.
 - Pay $10 and get $10 of inference credit.
@@ -49,7 +52,7 @@ amount excludes money reserved for work that is still in progress.
 
 To add credit:
 
-1. Open **Settings → Billing**.
+1. Open **Settings → Billing → Billing Settings**.
 2. Find **Add inference credit** below the current plan.
 3. Select an amount.
 4. Complete the Stripe checkout.
@@ -58,7 +61,7 @@ The new balance appears after Stripe confirms the payment.
 
 ## Hosted usage rates
 
-Mogplex shows recent usage costs in Billing. These costs use the available
+Mogplex shows recent usage costs in **Billing → Usage**. These costs use the available
 inference-credit balance.
 
 Mogplex lists each model call after the cost settles. For a code review, the
@@ -90,19 +93,19 @@ account. Pending work does not use a run slot.
 When all slots are in use, new work waits for a slot. A slot becomes available
 when a run finishes or you stop one.
 
-Billing shows the plan limit as a static entitlement. It does not show a live
+**Billing Settings** shows the plan limit as a static entitlement. It does not show a live
 usage meter. Use the active-run surfaces to see current work and find the
 runs that use slots.
 
-If your account can buy more parallel agent runs, Billing shows these recurring
+If your account can buy more parallel agent runs, **Billing Settings** shows these recurring
 add-ons:
 
 | Add-on | Price |
 | --- | ---: |
 | 10 more parallel agent runs | $5 per month, per quantity |
 | 50 more parallel agent runs | $15 per month, per quantity |
 
-Some accounts cannot buy new parallel-run add-ons. Billing only shows the
+Some accounts cannot buy new parallel-run add-ons. **Billing Settings** only shows the
 actions available for the selected account.
 
 ## Storage add-ons
@@ -116,7 +119,7 @@ Storage add-ons increase retained storage. The plan stays the same.
 | 50 GB | $60 per month, per quantity |
 | 100 GB | $100 per month, per quantity |
 
-For each capacity change, Billing shows the new limit, monthly change, amount
+For each capacity change, **Billing Settings** shows the new limit, monthly change, amount
 due now, and effective date before confirmation. Increases take effect after
 payment. Decreases and cancellations take effect at the end of the billing
 period.
@@ -146,10 +149,10 @@ does not display or store the full card number in the Billing page.
 
 Select **Update payment method** to make changes in Stripe. Mogplex creates an
 invoice for each plan payment, add-on payment, and inference-credit payment.
-Usage charges appear in **Recent usage costs**. They do not produce Stripe
+Usage charges appear in **Usage → Recent usage costs**. They do not produce Stripe
 invoices. They spend credit that is already in the account.
 
-Billing shows the latest 20 invoices. Select an invoice number to open its
+**Billing Settings** shows the latest 20 invoices. Select an invoice number to open its
 hosted invoice or PDF. Select **View all invoices** to open the complete Stripe
 history.
 
@@ -165,7 +168,7 @@ token.
 
 <Callout title="Check the selected account">
   Billing follows the personal or company account selected in Mogplex. Confirm
-  the account name at the top of Billing before you report an invoice that you
+  the account name on **Billing Settings** before you report an invoice that you
   cannot find or an incorrect balance.
 </Callout>
 

@@ -20,7 +20,7 @@ This page is the complete reference for the versioned Mogplex API.
 
 ## Quickstart
 
-Create a personal access token in **Mogplex → Settings → API Keys**, then set:
+Create a personal access token in [Settings → Mogplex Keys](/web/settings#mogplex-keys), then set:
 
 ```bash
 export MOGPLEX_BASE_URL="https://mogplex.com/api/v1/mogplex"
@@ -65,7 +65,7 @@ Authorization: Bearer mog_...
 
 Personal access tokens use the `mog_` prefix. The plaintext token is shown
 once, then stored by Mogplex as a SHA-256 hash. Revoke or replace a token from
-**Settings → API Keys**.
+[Settings → Mogplex Keys](/web/settings#mogplex-keys).
 
 The MCP transport also accepts OAuth 2.1 access tokens issued through the
 browser consent flow. Use a PAT for direct REST integrations. Use OAuth when

@@ -13,11 +13,20 @@ surfaces.
 
 | Older route | Current destination | Best doc page |
 | --- | --- | --- |
+| `/settings/billing` | The signed-in user's `/<scope>/settings/billing` page | [Settings](/web/settings) |
+| `/<scope>/settings` | Personal **Account** or team **Members** page | [Settings](/web/settings) |
+| `/<scope>/settings?tab=account`, `?tab=teams`, or `?tab=keys` | The matching `/<scope>/settings/<section>` page | [Settings](/web/settings) |
+| `/<scope>/settings?tab=keys&sub=cli` | `/<scope>/settings/mogplex-keys` for personal accounts | [Settings](/web/settings) |
+| `/<scope>/settings?tab=billing` | `/<scope>/settings/billing`, with checkout return messages preserved | [Settings](/web/settings) |
+| `/<team>/settings?tab=members`, `?tab=models`, or `?tab=audit` | The matching team Settings page | [Settings](/web/settings) |
 | `/<scope>/settings?tab=connections` or `/<scope>/settings#connections` | `/<scope>/connections`, with OAuth and Slack return messages preserved | [Connections and MCP](/configure-and-extend/connections-and-mcp) |
 | `/flows` | `/automations` | [Flows](/web/flows) or [Automations](/web/automations) |
 | `/library` | `/agents/skills` by default, with tab-specific redirects for rules, context, and models | [Library](/web/library) |
 | `/primitives` | `/agents/skills` by default, with tab-specific redirects for rules and context | [Primitives](/web/primitives) |
 
+**MCP Servers** keeps its route at `/<scope>/settings/mcp`.
+It now has a link in the personal Settings sidebar.
+
 ## When the old route names still matter
 
 You will still run into these names when you:

@@ -43,8 +43,9 @@ behavior, or why something ran the way it did, the answer usually starts here.
   cron, and triage work.
 - **Observability** tracks runs, pressure, failures, model calls, tool usage,
   and sandbox-linked activity.
-- **Settings** manages GitHub identity, App coverage, connections, access
-  tokens, models, preferences, billing access, and synced MCP definitions.
+- **Settings** opens a secondary sidebar with separate pages for account,
+  teams, keys, MCP servers, and billing. Billing has **Billing Settings** and
+  **Usage** tabs.
 - **Available Models** explains the live model catalog, enabled-state rules,
   default-model behavior, plan access, CLI sync, and repo-level exclusions.
 

@@ -24,9 +24,9 @@ the Supabase `ai_models` table by `pnpm gen:models`.
 
 ## Where to see models
 
-Open [Settings](/web/settings) and use the **Models** section.
+Open **Models** in the main sidebar.
 
-That section is the product-facing model catalog. It shows the models Mogplex
+The Models page contains the model catalog. It shows the models Mogplex
 can currently present to the signed-in account, including:
 
 - provider
@@ -122,22 +122,22 @@ provider, model family, or cost profile.
 
 That scope split is:
 
-- global enabled state in **Settings → Models**
+- global enabled state in **Models**
 - repo-specific exclusions in the repo or space settings
 
 ## Troubleshooting
 
 | Symptom | Check |
 | --- | --- |
-| No models appear in an agent picker | Open Settings → Models and confirm at least one model is enabled. |
+| No models appear in an agent picker | Open Models and confirm at least one model is enabled. |
 | A model appears but a run fails with access errors | Check the account plan, entitlement state, and model availability. |
 | The CLI signs in but no shared model list appears | Confirm the web account has model access and that the CLI is using account-backed login. |
 | A saved agent references a hidden or stale model | Move it to a visible enabled model in the agent editor. |
 | A repo cannot use a globally enabled model | Check repo settings for a repo-specific model exclusion. |
 
 ## Read next
 
-- [Settings](/web/settings) for account preferences, access tokens, and models
+- [Settings](/web/settings) for account access and Mogplex Keys
 - [API → Models](/reference/api#models) for the route contract behind the catalog
 - [Agents](/web/agents) for model choice on reusable agents
 - [CLI → Authentication](/cli/guides/authentication) for account-backed model

@@ -1,14 +1,47 @@
 ---
 title: Settings
-description: Manage GitHub identity, App coverage, access keys, account preferences, and billing.
+description: Find account and team settings, provider credentials, Mogplex access tokens, and billing.
 ---
 
-Settings is the account-level control plane for Mogplex.
+Open **Settings** in the sidebar to manage your account or team.
 
-If something about your identity, repo coverage, model access, or
-CLI sync looks wrong, this is the first page to inspect.
+Settings opens a secondary sidebar. Select a section to open its page.
+Use the back arrow beside **Settings** to return to the main navigation.
+On mobile, open the navigation menu to select a Settings page.
 
-## Use this page to fix account problems, not routing logic
+## Settings pages
+
+Each section has its own URL. Reloads and bookmarks open the same section.
+
+| Personal page | Route |
+| --- | --- |
+| Account | `/<scope>/settings/account` |
+| Teams | `/<scope>/settings/teams` |
+| Provider Keys | `/<scope>/settings/keys` |
+| Mogplex Keys | `/<scope>/settings/mogplex-keys` |
+| MCP Servers | `/<scope>/settings/mcp` |
+| Billing | `/<scope>/settings/billing` |
+
+Team Settings includes **Members**, **Provider Keys**, **Models**, and **Billing**.
+Owners and admins also see **Audit**.
+Each uses the same route pattern, such as `/<team>/settings/models`.
+Personal keys and account preferences stay in the personal scope.
+
+Each old tab link opens its section's page.
+For example, `?tab=keys&sub=cli` opens **Mogplex Keys**.
+
+## Billing
+
+Open **Settings → Billing** for two tabs:
+
+- **Billing Settings**: manage the plan, payment method, invoices, inference credit, and available add-ons.
+- **Usage**: view the inference balance and recent usage costs.
+
+The Usage tab uses `/<scope>/settings/billing?tab=usage`.
+Reloads and browser Back preserve the selected tab.
+Team billing uses the current team and its permissions.
+
+## Account setup and workflow setup
 
 Settings is where you answer questions like:
 
@@ -37,41 +70,22 @@ actually support them.
 
 ## What lives here
 
-Settings currently groups together:
-
-- **Account** state for GitHub identity, GitHub App coverage, and account
-  readiness
-- **Access Tokens** for CLI, API, and script authentication
-- **Preferences** for theme and default model
-- **Run checks**, one switch for the automatic judgments Mogplex makes about
-  agent work
+- **Account** shows GitHub identity, App coverage, account access, and **Run checks**.
+- **Teams** lists team memberships and controls.
+- **Provider Keys** stores keys for model providers.
+- **Mogplex Keys** manages tokens for CLI, API, and script access.
+- **MCP Servers** manages server definitions for CLI sync.
+- **Billing** contains **Billing Settings** and **Usage**.
 
 **Models** and **Connections** have their own sidebar destinations.
 For model setup, see [Available Models](/web/models).
 
 For the connection-specific operating guide, see
 [Connections and MCP](/configure-and-extend/connections-and-mcp).
 
-## Start at the top of the page first
-
-The top of Settings is intentionally opinionated.
-
-It is the part of the product that tells you:
-
-- whether GitHub is connected at all
-- whether the GitHub App is installed on the right owner
-- whether synced repos exist yet
-- whether billing, model access, or sandbox access still needs action
-- what the next most likely setup step is
-
-Treat that top block as the “what is missing?” answer before you debug any
-deeper form.
-
 ## Account section
 
-The top of Settings is intentionally operational, not decorative.
-
-It shows:
+The **Account** page shows:
 
 - current GitHub connection mode and status
 - GitHub App coverage and synced repo counts
@@ -110,8 +124,8 @@ default.
 
 | Where the work runs | Who decides | Where the switch is |
 | --- | --- | --- |
-| Inside a team | A team owner or admin | Team Settings, **Models** tab |
-| Outside a team | You | Settings, **Account** tab |
+| Inside a team | A team owner or admin | Team Settings, **Models** page |
+| Outside a team | You | Settings, **Account** page |
 
 Work inside a team always follows the team's setting, never a member's own.
 Every change to a team's setting is written to the team audit log.
@@ -141,7 +155,7 @@ normal hosted work. If a model picker is empty or a sandbox cannot launch
 because access is missing, check the account plan or entitlement state before
 editing agents, prompts, or repo launch settings.
 
-The Billing section shows the monthly plan cost, next due date, protected card
+The **Billing Settings** tab shows the monthly plan cost, next due date, protected card
 summary, and recent invoices. It also lets an authorized owner or admin update
 the payment method, open the complete invoice history, buy inference credit,
 and manage available capacity add-ons.
@@ -256,15 +270,20 @@ reply conversationally. In a linked channel, a real instruction after
 
 For the full Slack model, see [Slack](/integrations/slack).
 
-## Access Tokens
+## Provider Keys
+
+Open **Settings → Provider Keys** to add or remove your own model-provider credentials.
+This page supports AI Gateway, Anthropic, OpenAI, and OpenRouter.
+Personal keys belong to your account. Team keys use the selected team's permissions.
 
-Access tokens are for authenticating Mogplex clients and scripts. They are not
-model-provider credentials.
+<span id="access-tokens" />
 
-Use them when the CLI or another Mogplex-aware script needs to authenticate as
-you against Mogplex itself.
+## Mogplex Keys
 
-The section supports:
+Open **Settings → Mogplex Keys** to manage access tokens for Mogplex clients and scripts.
+These tokens authenticate with Mogplex itself.
+
+The page supports:
 
 - naming each token
 - optional expiration windows
@@ -278,8 +297,9 @@ user-supplied provider or sandbox credentials.
 
 ## Preferences and Models
 
-Settings owns account preferences. Open **Models** in the sidebar to manage
-model access and defaults.
+Open the user menu to change the theme.
+Open **Models** in the main sidebar to manage model access.
+Use **Models → Configuration** to set the primary model and fallbacks.
 
 The important split is: