From 852b672caf79ec76bacdfeb3cfe6a6a6cd3a4d4c Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Tue, 22 Sep 2026 12:50:43 -0400 Subject: [PATCH 1/2] docs: move MCP Servers guidance to Connections --- .../docs/configure-and-extend/connections-and-mcp.mdx | 11 +++++++++-- content/docs/web/guides/legacy-routes.mdx | 5 +++-- content/docs/web/settings.mdx | 3 +-- 3 files changed, 13 insertions(+), 6 deletions(-) diff --git a/content/docs/configure-and-extend/connections-and-mcp.mdx b/content/docs/configure-and-extend/connections-and-mcp.mdx index a3c166b..f7120fb 100644 --- a/content/docs/configure-and-extend/connections-and-mcp.mdx +++ b/content/docs/configure-and-extend/connections-and-mcp.mdx @@ -11,8 +11,13 @@ links, and the live endpoint where other MCP clients call into Mogplex. ## Open Connections Select **Connections** in the app sidebar. The page lives at -`//connections` and contains service presets, saved connections, -the custom connection form, and Slack setup. +`//connections` and has two tabs: + +- **Integrations** contains service presets, saved connections, the custom connection form, and Slack setup. +- **MCP Servers** manages server definitions that sync with the Mogplex CLI. + +The MCP Servers tab uses `//connections?tab=mcp`. +Reloads and browser Back preserve the selected tab. Connections belong to your personal account. Shared team connections are not available yet. In a team scope, select **Open personal connections** to manage @@ -20,6 +25,8 @@ your own services. Old Settings links with `?tab=connections` or `#connections` still work. OAuth and Slack return messages follow the redirect to the new page. +The old `//settings/mcp` page and Settings links with `?tab=mcp` or +`#mcp` open the MCP Servers tab. ## Direction matters diff --git a/content/docs/web/guides/legacy-routes.mdx b/content/docs/web/guides/legacy-routes.mdx index d0b6ae4..be07867 100644 --- a/content/docs/web/guides/legacy-routes.mdx +++ b/content/docs/web/guides/legacy-routes.mdx @@ -20,12 +20,13 @@ surfaces. | `//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) | +| `//settings/mcp`, `//settings?tab=mcp`, or `//settings#mcp` | `//connections?tab=mcp` | [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 `//settings/mcp`. -It now has a link in the personal Settings sidebar. +**MCP Servers** is now a tab in personal **Connections**. +Old links preserve unrelated query values. Team scopes direct users to their personal connections. ## When the old route names still matter diff --git a/content/docs/web/settings.mdx b/content/docs/web/settings.mdx index 4431e07..3f0f7fa 100644 --- a/content/docs/web/settings.mdx +++ b/content/docs/web/settings.mdx @@ -19,7 +19,6 @@ Each section has its own URL. Reloads and bookmarks open the same section. | 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**. @@ -74,10 +73,10 @@ actually support them. - **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. +Open **Connections → MCP Servers** to manage server definitions for CLI sync. For model setup, see [Available Models](/web/models). For the connection-specific operating guide, see From f18807f5a307c6ce71fcde35f3f933ca36a84ad9 Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Tue, 22 Sep 2026 12:56:45 -0400 Subject: [PATCH 2/2] docs: align overview and CLI links with the MCP tab --- content/docs/cli/guides/configuration-and-flags.mdx | 2 +- content/docs/cli/reference/drawers.mdx | 2 +- content/docs/web/index.mdx | 2 +- content/docs/web/settings.mdx | 4 +++- 4 files changed, 6 insertions(+), 4 deletions(-) diff --git a/content/docs/cli/guides/configuration-and-flags.mdx b/content/docs/cli/guides/configuration-and-flags.mdx index cad6ed4..456229c 100644 --- a/content/docs/cli/guides/configuration-and-flags.mdx +++ b/content/docs/cli/guides/configuration-and-flags.mdx @@ -95,7 +95,7 @@ Permissions are managed by editing the JSON files above or by using `/permission ## Configuring MCP -MCP servers are configured in [Web Settings](/web/settings) and synced to the +MCP servers are configured in [Connections → MCP Servers](/configure-and-extend/connections-and-mcp) and synced to the CLI when you are signed in to Mogplex. The CLI's MCP drawer surfaces what is configured and supports sync or reauth actions. diff --git a/content/docs/cli/reference/drawers.mdx b/content/docs/cli/reference/drawers.mdx index f85f0f5..4a8994e 100644 --- a/content/docs/cli/reference/drawers.mdx +++ b/content/docs/cli/reference/drawers.mdx @@ -33,7 +33,7 @@ What you can do: - inspect available tools per server - see why a server is `unavailable` or `degraded` -- follow links into [Web Settings](/web/settings) for shared MCP configuration +- open [Connections → MCP Servers](/configure-and-extend/connections-and-mcp) for shared MCP configuration ## Memory diff --git a/content/docs/web/index.mdx b/content/docs/web/index.mdx index 52c0bf1..03ad356 100644 --- a/content/docs/web/index.mdx +++ b/content/docs/web/index.mdx @@ -44,7 +44,7 @@ behavior, or why something ran the way it did, the answer usually starts here. - **Observability** tracks runs, pressure, failures, model calls, tool usage, and sandbox-linked activity. - **Settings** opens a secondary sidebar with separate pages for account, - teams, keys, MCP servers, and billing. Billing has **Billing Settings** and + teams, keys, 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 3f0f7fa..20c07a9 100644 --- a/content/docs/web/settings.mdx +++ b/content/docs/web/settings.mdx @@ -187,6 +187,8 @@ work?** Open **Connections** from the app sidebar to add or manage external services. This page now lives at `//connections`, outside Settings. +Use **Integrations** for services and **MCP Servers** for CLI server definitions. +The MCP Servers tab has a direct link at `//connections?tab=mcp`. Old Settings links still redirect to it. @@ -200,7 +202,7 @@ Mogplex supports two connection categories: - **REST API** connections - **MCP Server** connections -The page supports: +The Integrations tab supports: - quick-add MCP presets - fully custom REST or MCP endpoints