From fdd4db89f93f9e539e5d26b0411edbf41c243267 Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Tue, 22 Sep 2026 11:09:36 -0400 Subject: [PATCH 1/5] docs: explain Settings pages and Billing tabs --- content/docs/plans-and-billing.mdx | 7 ++- content/docs/web/guides/legacy-routes.mdx | 5 ++ content/docs/web/index.mdx | 5 +- content/docs/web/settings.mdx | 76 ++++++++++++++--------- 4 files changed, 58 insertions(+), 35 deletions(-) diff --git a/content/docs/plans-and-billing.mdx b/content/docs/plans-and-billing.mdx index 27864be..046b09e 100644 --- a/content/docs/plans-and-billing.mdx +++ b/content/docs/plans-and-billing.mdx @@ -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 @@ -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 diff --git a/content/docs/web/guides/legacy-routes.mdx b/content/docs/web/guides/legacy-routes.mdx index 72b7c69..bba1ee6 100644 --- a/content/docs/web/guides/legacy-routes.mdx +++ b/content/docs/web/guides/legacy-routes.mdx @@ -13,6 +13,11 @@ surfaces. | Older route | Current destination | Best doc page | | --- | --- | --- | +| `//settings` | Personal **Account** or team **Members** page | [Settings](/web/settings) | +| `//settings?tab=account`, `?tab=teams`, or `?tab=keys` | The matching `//settings/
` page | [Settings](/web/settings) | +| `//settings?tab=keys&sub=cli` | `//settings/mogplex-keys` for personal accounts | [Settings](/web/settings) | +| `//settings?tab=billing` | `//settings/billing`, with checkout return messages preserved | [Settings](/web/settings) | +| `//settings?tab=members`, `?tab=models`, or `?tab=audit` | The matching team Settings page | [Settings](/web/settings) | | `//settings?tab=connections` or `//settings#connections` | `//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) | diff --git a/content/docs/web/index.mdx b/content/docs/web/index.mdx index 1e2a38b..52c0bf1 100644 --- a/content/docs/web/index.mdx +++ b/content/docs/web/index.mdx @@ -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. diff --git a/content/docs/web/settings.mdx b/content/docs/web/settings.mdx index c46a297..57cb007 100644 --- a/content/docs/web/settings.mdx +++ b/content/docs/web/settings.mdx @@ -3,10 +3,43 @@ title: Settings description: Manage GitHub identity, App coverage, access keys, account preferences, 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. + +## Settings pages + +Each section has its own URL. Reloads and bookmarks open the same section. + +| Personal page | Route | +| --- | --- | +| Account | `//settings/account` | +| Teams | `//settings/teams` | +| Provider Keys | `//settings/keys` | +| Mogplex Keys | `//settings/mogplex-keys` | +| MCP Servers | `//settings/mcp` | +| Billing | `//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 `//settings/models`. +Personal keys and account preferences stay in the personal scope. + +Old Settings tab links redirect to the matching 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 `//settings/billing?tab=usage`. +Reloads and browser Back preserve the selected tab. +Team billing follows the current team scope and its existing permissions. ## Use this page to fix account problems, not routing logic @@ -37,14 +70,12 @@ 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). @@ -52,26 +83,9 @@ 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. From a16b3af9773b06809a5c2cb4d2eef71870f0e073 Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Tue, 22 Sep 2026 11:10:10 -0400 Subject: [PATCH 2/5] docs: clarify legacy links and team scope --- content/docs/web/settings.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/web/settings.mdx b/content/docs/web/settings.mdx index 57cb007..ba470a9 100644 --- a/content/docs/web/settings.mdx +++ b/content/docs/web/settings.mdx @@ -27,7 +27,7 @@ Owners and admins also see **Audit**. Each uses the same route pattern, such as `//settings/models`. Personal keys and account preferences stay in the personal scope. -Old Settings tab links redirect to the matching page. +Each old tab link opens its section's page. For example, `?tab=keys&sub=cli` opens **Mogplex Keys**. ## Billing @@ -39,7 +39,7 @@ Open **Settings → Billing** for two tabs: The Usage tab uses `//settings/billing?tab=usage`. Reloads and browser Back preserve the selected tab. -Team billing follows the current team scope and its existing permissions. +Team billing uses the current team and its permissions. ## Use this page to fix account problems, not routing logic From 84cd40ef1b18f38ec98f83c1988190f2ac1e9239 Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Tue, 22 Sep 2026 11:20:29 -0400 Subject: [PATCH 3/5] docs: align detailed Settings and Models directions --- content/docs/web/guides/legacy-routes.mdx | 4 +++ content/docs/web/models.mdx | 8 ++--- content/docs/web/settings.mdx | 40 +++++++---------------- 3 files changed, 19 insertions(+), 33 deletions(-) diff --git a/content/docs/web/guides/legacy-routes.mdx b/content/docs/web/guides/legacy-routes.mdx index bba1ee6..d0b6ae4 100644 --- a/content/docs/web/guides/legacy-routes.mdx +++ b/content/docs/web/guides/legacy-routes.mdx @@ -13,6 +13,7 @@ surfaces. | Older route | Current destination | Best doc page | | --- | --- | --- | +| `/settings/billing` | The signed-in user's `//settings/billing` page | [Settings](/web/settings) | | `//settings` | Personal **Account** or team **Members** page | [Settings](/web/settings) | | `//settings?tab=account`, `?tab=teams`, or `?tab=keys` | The matching `//settings/
` page | [Settings](/web/settings) | | `//settings?tab=keys&sub=cli` | `//settings/mogplex-keys` for personal accounts | [Settings](/web/settings) | @@ -23,6 +24,9 @@ surfaces. | `/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 `//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: diff --git a/content/docs/web/models.mdx b/content/docs/web/models.mdx index 4426473..467ed7c 100644 --- a/content/docs/web/models.mdx +++ b/content/docs/web/models.mdx @@ -24,7 +24,7 @@ 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 can currently present to the signed-in account, including: @@ -122,14 +122,14 @@ 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. | @@ -137,7 +137,7 @@ That scope split is: ## 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 diff --git a/content/docs/web/settings.mdx b/content/docs/web/settings.mdx index ba470a9..426d5ba 100644 --- a/content/docs/web/settings.mdx +++ b/content/docs/web/settings.mdx @@ -270,42 +270,24 @@ reply conversationally. In a linked channel, a real instruction after For the full Slack model, see [Slack](/integrations/slack). -## Access Tokens +## Provider Keys -Access tokens are for authenticating Mogplex clients and scripts. They are not -model-provider credentials. +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. -Use them when the CLI or another Mogplex-aware script needs to authenticate as -you against Mogplex itself. + -The section supports: +## Mogplex Keys -- naming each token -- optional expiration windows -- one-time token display at creation -- copy-on-create flow -- last-used metadata -- revocation - -Hosted model and sandbox access comes from the account plan, not from -user-supplied provider or sandbox credentials. +Open **Settings → Mogplex Keys** to manage access tokens for Mogplex clients and scripts. +These tokens authenticate with Mogplex itself. ## Preferences and Models -Settings owns account preferences. Open **Models** in the sidebar to manage -model access and defaults. - -The important split is: - -- **Models page** controls what models are available to the account -- **Agent settings** choose which available model a specific agent should use - -If an agent cannot select the model you expect, check **Models** before you -edit the agent itself. - -Use [Available Models](/web/models) when you need the fuller model-access -mental model: enabled state, defaults, plan access, CLI sync, hidden legacy -models, and repo-level exclusions. +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. ## Fast troubleshooting map From 33333cc702b1a7a3558b1eea59f9e1407d01430d Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Tue, 22 Sep 2026 11:20:49 -0400 Subject: [PATCH 4/5] docs: retain key controls and model setup details --- content/docs/web/settings.mdx | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/content/docs/web/settings.mdx b/content/docs/web/settings.mdx index 426d5ba..7cea2f1 100644 --- a/content/docs/web/settings.mdx +++ b/content/docs/web/settings.mdx @@ -283,12 +283,36 @@ Personal keys belong to your account. Team keys use the selected team's permissi 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 +- one-time token display at creation +- copy-on-create flow +- last-used metadata +- revocation + +Hosted model and sandbox access comes from the account plan, not from +user-supplied provider or sandbox credentials. + ## Preferences and Models 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: + +- **Models page** controls what models are available to the account +- **Agent settings** choose which available model a specific agent should use + +If an agent cannot select the model you expect, check **Models** before you +edit the agent itself. + +Use [Available Models](/web/models) when you need the fuller model-access +mental model: enabled state, defaults, plan access, CLI sync, hidden legacy +models, and repo-level exclusions. + ## Fast troubleshooting map - **Triggers page is empty**: GitHub OAuth may be connected, but App coverage is From fe7b43a9bf2feb347c393984063f4f8ad12c1e7f Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Tue, 22 Sep 2026 11:33:11 -0400 Subject: [PATCH 5/5] docs: update token guides and Billing tab directions --- content/docs/mcp/install.mdx | 2 +- content/docs/plans-and-billing.mdx | 16 ++++++++-------- content/docs/reference/api.mdx | 4 ++-- content/docs/web/models.mdx | 2 +- content/docs/web/settings.mdx | 6 +++--- 5 files changed, 15 insertions(+), 15 deletions(-) diff --git a/content/docs/mcp/install.mdx b/content/docs/mcp/install.mdx index 70858e7..1c0e698 100644 --- a/content/docs/mcp/install.mdx +++ b/content/docs/mcp/install.mdx @@ -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. diff --git a/content/docs/plans-and-billing.mdx b/content/docs/plans-and-billing.mdx index 046b09e..95aaaff 100644 --- a/content/docs/plans-and-billing.mdx +++ b/content/docs/plans-and-billing.mdx @@ -37,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. @@ -93,11 +93,11 @@ 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 | @@ -105,7 +105,7 @@ add-ons: | 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 @@ -119,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. @@ -149,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. @@ -168,7 +168,7 @@ token. 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. diff --git a/content/docs/reference/api.mdx b/content/docs/reference/api.mdx index 5b2fc7f..9e40a8b 100644 --- a/content/docs/reference/api.mdx +++ b/content/docs/reference/api.mdx @@ -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 diff --git a/content/docs/web/models.mdx b/content/docs/web/models.mdx index 467ed7c..181610a 100644 --- a/content/docs/web/models.mdx +++ b/content/docs/web/models.mdx @@ -26,7 +26,7 @@ the Supabase `ai_models` table by `pnpm gen:models`. 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 diff --git a/content/docs/web/settings.mdx b/content/docs/web/settings.mdx index 7cea2f1..4431e07 100644 --- a/content/docs/web/settings.mdx +++ b/content/docs/web/settings.mdx @@ -1,6 +1,6 @@ --- 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. --- Open **Settings** in the sidebar to manage your account or team. @@ -41,7 +41,7 @@ The Usage tab uses `//settings/billing?tab=usage`. Reloads and browser Back preserve the selected tab. Team billing uses the current team and its permissions. -## Use this page to fix account problems, not routing logic +## Account setup and workflow setup Settings is where you answer questions like: @@ -155,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.