update supermemory mcp docs (#1408)

Updates the Supermemory MCP docs for the revamped tool, space, widget, and OAuth flows.

- adds a screenshot-backed ChatGPT Web setup guide with light and dark variants
- refreshes the overview, setup, tools, spaces, and widget docs
- keeps manual JSON configuration in a dropdown

Tested all four local MCP docs routes and image references.

for mcp image light mode -> dark mode images and dark mode has light mode (since the background was blending in i made this way to refocus user attention on the screenshots)

apps/docs/docs.json

@@ -370,7 +370,10 @@
 									{
 										"group": "Setups",
 										"icon": "layers",
-										"pages": ["supermemory-mcp/claude-desktop"]
+										"pages": [
+											"supermemory-mcp/chatgpt-web",
+											"supermemory-mcp/claude-desktop"
+										]
 									}
 								]
 							},

apps/docs/supermemory-mcp/chatgpt-web.mdx

@@ -0,0 +1,199 @@
+---
+title: "ChatGPT Web"
+description: "Connect Supermemory MCP to ChatGPT Web through Plugins and OAuth"
+icon: "/images/openai.svg"
+sidebarTitle: "ChatGPT Web"
+---
+
+Connect Supermemory MCP to [ChatGPT Web](https://chatgpt.com) to use your Supermemory context directly in a conversation.
+
+## Step 1: Open Settings
+
+Open your profile menu in the lower-left corner of ChatGPT Web and select **Settings**.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-1-settings-dark.png"
+  alt="ChatGPT Web profile menu in dark mode with Settings highlighted"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-1-settings-light.png"
+  alt="ChatGPT Web profile menu in light mode with Settings highlighted"
+/>
+
+## Step 2: Open Plugins
+
+Select **Plugins** in the Settings sidebar.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-2-plugins-dark.png"
+  alt="ChatGPT Web Plugins settings in dark mode"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-2-plugins-light.png"
+  alt="ChatGPT Web Plugins settings in light mode"
+/>
+
+## Step 3: Open Developer mode
+
+Scroll to the bottom of **Plugins** and select **Developer mode**.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-dark.png"
+  alt="Developer mode and Browse plugins at the bottom of ChatGPT Web Plugins settings in dark mode"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-light.png"
+  alt="Developer mode and Browse plugins at the bottom of ChatGPT Web Plugins settings in light mode"
+/>
+
+## Step 4: Enable Developer mode
+
+ChatGPT opens the **Developer mode** section under **Security and login**. Turn **Developer mode** on.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-dark.png"
+  alt="Developer mode section under Security and login in ChatGPT Web dark mode"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-light.png"
+  alt="Developer mode section under Security and login in ChatGPT Web light mode"
+/>
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-dark.png"
+  alt="Developer mode enabled in ChatGPT Web dark mode"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-light.png"
+  alt="Developer mode enabled in ChatGPT Web light mode"
+/>
+
+## Step 5: Open Browse plugins
+
+Return to **Plugins**, scroll to the bottom, and select **Browse plugins**.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-dark.png"
+  alt="Browse plugins at the bottom of ChatGPT Web Plugins settings in dark mode"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-light.png"
+  alt="Browse plugins at the bottom of ChatGPT Web Plugins settings in light mode"
+/>
+
+## Step 6: Add a plugin
+
+On the Plugins page, select the **plus icon** in the upper-right corner.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-dark.png"
+  alt="ChatGPT Web Plugins page in dark mode with the plus icon"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-light.png"
+  alt="ChatGPT Web Plugins page in light mode with the plus icon"
+/>
+
+## Step 7: Enter the Supermemory details
+
+Complete the **New Plugin** form:
+
+- In **Name**, enter `Supermemory MCP`.
+- In **Description**, enter `Memory/context for you ai agents`.
+- Under **Connection**, select **Server URL** instead of **Tunnel**.
+- In the URL field, paste `https://mcp.supermemory.ai/mcp`.
+
+The icon is optional. Leave **Advanced OAuth settings** unchanged.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-7-details-dark.png"
+  alt="New Plugin form in dark mode filled with the Supermemory MCP details"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-7-details-light.png"
+  alt="New Plugin form in light mode filled with the Supermemory MCP details"
+/>
+
+## Step 8: Confirm and create
+
+Scroll to the bottom of the form. Select **I understand and want to continue**, then select **Create**.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-8-confirm-dark.png"
+  alt="New Plugin confirmation in dark mode with the acknowledgement selected"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-8-confirm-light.png"
+  alt="New Plugin confirmation in light mode with the acknowledgement selected"
+/>
+
+## Step 9: Sign in to Supermemory
+
+ChatGPT opens the **Add Supermemory MCP to ChatGPT** dialog. Select **Sign in with Supermemory MCP**.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-9-sign-in-dark.png"
+  alt="ChatGPT authorization dialog for Supermemory MCP in dark mode"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-9-sign-in-light.png"
+  alt="ChatGPT authorization dialog for Supermemory MCP in light mode"
+/>
+
+<Accordion title="If Supermemory asks you to choose an organization">
+  Accounts with access to more than one organization may see an organization picker. Select the organization you want ChatGPT Web to use.
+
+  ![Supermemory organization picker shown for accounts with multiple organizations](/images/supermemory-mcp/chatgpt-web/step-9-organization.png)
+</Accordion>
+
+## Step 10: Approve access
+
+On the Supermemory authorization page:
+
+- Select **Read + Write** to let ChatGPT search and save Supermemory context. Select **Read only** if you only want search access.
+- Select **Full access** to use every available space, or **Scoped** to choose specific spaces.
+- Choose how long the connection should remain active.
+- Select **Approve**.
+
+![Supermemory MCP authorization page with permission, access, and expiration controls](/images/supermemory-mcp/chatgpt-web/step-10-authorize.png)
+
+## Step 11: Start using Supermemory
+
+After approval, ChatGPT returns to the Supermemory MCP plugin page. Select **Try in chat**.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/chatgpt-web/step-11-connected-dark.png"
+  alt="Connected Supermemory MCP page in ChatGPT Web dark mode"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/chatgpt-web/step-11-connected-light.png"
+  alt="Connected Supermemory MCP page in ChatGPT Web light mode"
+/>
+
+## Done
+
+Supermemory MCP is now ready to use in ChatGPT Web. You can manage or disconnect it later from the [Plugins page](https://chatgpt.com/plugins).
+
+**See also:** [MCP overview](/supermemory-mcp/mcp) | [Setup and Usage](/supermemory-mcp/setup) | [Claude Desktop](/supermemory-mcp/claude-desktop)

apps/docs/supermemory-mcp/claude-desktop.mdx

@@ -5,7 +5,7 @@ icon: "monitor"
 sidebarTitle: "Claude Desktop"
 ---
 
-This guide walks through adding Supermemory as a **custom connector** in [Claude](https://claude.ai) (Desktop or web): open **Settings → Connectors**, add the MCP URL, connect, and authorize. For other clients and API-key auth, see [Setup and Usage](/supermemory-mcp/setup).
+This guide walks through adding Supermemory as a **custom connector** in [Claude](https://claude.ai) (Desktop or web): open **Settings → Connectors**, add the MCP URL, connect, and authorize. For other clients, see [Setup and Usage](/supermemory-mcp/setup).
 
 ## Step 1 — Open Connectors and add a custom connector
 

apps/docs/supermemory-mcp/mcp.mdx

@@ -1,55 +1,27 @@
 ---
 title: "Overview"
-description: "Unified memory for Claude, Cursor, and every MCP client — one layer across all your tools"
+description: "Give every MCP-compatible assistant shared memory, team spaces, and interactive workflows"
 icon: "brain-circuit"
 ---
 
-Most AI tools forget you the moment the tab closes. You re-explain preferences, restate project context, and re-teach the same lessons in Claude, Cursor, ChatGPT, and everything else.
+Supermemory MCP gives every MCP-compatible assistant a shared memory layer, so technical and non-technical teams can collaborate with AI using the same authorized context. Connect once to search decisions, save knowledge, upload source material, and explore relationships from the AI tools your team already uses.
 
-**Supermemory MCP** is a single memory layer that plugs into any MCP-compatible client. Connect once, and the same long-term memory follows you across tools — coding agents, chat apps, IDEs, and whatever you add next.
-
-## What you get
-
-- **Unified memory across tools** — Facts you save in Claude are available in Cursor (and vice versa). One brain, many surfaces.
-- **Memory that compounds** — Preferences, decisions, and project knowledge accumulate instead of resetting every session.
-- **Profiles that stay current** — Supermemory builds a living user profile from what you share, so assistants start with who you are — not a blank slate.
-- **Project-scoped context** — Keep work, personal, and client work separate with optional project tags.
-- **Works where you already work** — Claude (Connectors), Cursor, Windsurf, VS Code, Cline, and any client that speaks MCP.
-
-### Why a small tool surface is intentional
-
-Supermemory MCP exposes a **minimal** set of tools on purpose.
-
-Assistants don’t need a kitchen-sink API to remember well. They need a few durable actions: save what matters, recall what’s relevant, and know who the user is. Fewer tools means less confusion for the model, clearer behavior, and more reliable use in production.
-
-| Surface | Role |
-| --- | --- |
-| **`memory`** | Save or forget something durable |
-| **`recall`** | Search memories + optionally load the user profile |
-| **`whoAmI`** | Confirm the authenticated user / session |
-| **`context` prompt** | Inject a ready-to-use profile system message (`/context` in many clients) |
-| **Profile / projects resources** | Raw profile and project list for clients that read MCP resources |
-
-That’s enough for agents to build real continuity — without tool sprawl.
-
-## How it fits together
-
-1. You connect your client to `https://mcp.supermemory.ai/mcp` (OAuth).
-2. During conversations, the model stores important facts with **`memory`**.
-3. When context is needed, **`recall`** (and the profile) pull the right history back in.
-4. Switch tools tomorrow — same account, same memory.
-
-Under the hood, the server runs on **Cloudflare Workers** with Durable Objects for scalable, sticky sessions. Your data is isolated per account; open-source implementation is on GitHub.
+Engineering and research teams can carry project context across assistants, while finance, legal, medical, and operations teams can work from their own source material. Ask naturally. The assistant selects the right Supermemory tool without requiring code or tool names. See the [tools reference](#tools) for exact inputs and results.
 
 ## Connect
 
-Server URL:
+Add this remote MCP server to any compatible client:
 
 ```text
 https://mcp.supermemory.ai/mcp
 ```
 
-Add it to your MCP client config:
+After you connect, your client opens Supermemory in a browser. Sign in or create an account, then choose which spaces the client can access. Supermemory uses OAuth, so no API key is required.
+
+For client-specific instructions, see [Setup and Usage](/supermemory-mcp/setup) or the [Claude Desktop guide](/supermemory-mcp/claude-desktop).
+
+<Accordion title="Manual JSON configuration" icon="code">
+MCP clients that use JSON configuration generally accept this shape:
 
 ```json
 {
@@ -60,92 +32,142 @@ Add it to your MCP client config:
   }
 }
 ```
+</Accordion>
 
-The server requires **OAuth**. Your client will discover the authorization server via `/.well-known/oauth-protected-resource` and prompt you to authenticate.
+## How spaces work
 
-For Claude (Settings → Connectors), see **[Claude Desktop](/supermemory-mcp/claude-desktop)**. For client-specific examples, see **[Setup and Usage](/supermemory-mcp/setup)**.
+A **space** keeps a team's documents, memories, and profile context focused, so AI retrieves the right knowledge without mixing unrelated work. Use separate spaces for an engineering launch, research project, finance workflow, legal matter, medical knowledge base, or any other shared initiative. Teammates collaborate within the spaces they are allowed to read or write.
 
-### Project Scoping
-
-Scope all operations to a specific project with `x-sm-project`:
-
-```json
-{
-  "mcpServers": {
-    "supermemory": {
-      "url": "https://mcp.supermemory.ai/mcp",
-      "headers": {
-        "x-sm-project": "your-project-id"
-      }
-    }
-  }
-}
-```
+Name a space to use it for one request without changing your active space. Otherwise, Supermemory uses your active space or account default. Ask to switch spaces when you want future requests to use a different active space.
 
 ## Tools
 
-### `memory`
+Your assistant chooses these tools automatically. Use this table when you need the exact inputs and results.
 
-Save or forget information about the user.
+| Tool | Use it for | Inputs | Result |
+| --- | --- | --- | --- |
+| `search_memory` | Semantic recall from one space, with optional profile context | `query` (required), `includeProfile`, `containerTag` | Profile context and matching memories |
+| `add_memory` | Save information or forget outdated information | `content` (required), `action` (`save` or `forget`), `containerTag` | Save or forget confirmation |
+| `listDocuments` | Browse stored source documents and their summaries | `page`, `limit`, `containerTag` | Document IDs, titles, types, status, dates, and summaries |
+| `getDocument` | Read the available content of one document | `documentId` (required) | Document metadata, summary, and available content |
+| `listMemories` | Browse recent extracted memory entries and their source document IDs | `page`, `limit`, `containerTag` | Memory IDs, text, versions, and source document IDs |
+| `listSpaces` | List accessible spaces and resolve a space name to its key | None | Formatted list plus structured `spaces` and `count` fields |
+| `whoAmI` | Inspect the authenticated account, permissions, scope, and active space | None | Account and access context |
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `content` | string | Yes | The memory content to save or forget |
-| `action` | `"save"` \| `"forget"` | No | Default: `"save"` |
-| `containerTag` | string | No | Project tag to scope the memory |
+### Search
 
-### `recall`
+`search_memory` accepts a natural-language query and returns semantically relevant memories. By default, it also includes stable and recent profile context from the same space. Set `includeProfile` to `false` when only matching memories are needed.
 
-Search memories and get user profile.
+Use the retrieval tools for different questions:
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `query` | string | Yes | Search query to find relevant memories |
-| `includeProfile` | boolean | No | Include user profile summary. Default: `true` |
-| `containerTag` | string | No | Project tag to scope the search |
+- Use `search_memory` to answer a question from remembered context.
+- Use `listDocuments` to discover stored sources, then `getDocument` to read one source in full.
+- Use `listMemories` to inspect the extracted memory entries themselves, including their IDs and source document IDs.
 
-### `whoAmI`
+`listDocuments` and `listMemories` default to 10 results per page and accept up to 50.
 
-Get the current logged-in user's information. Returns `{ userId, email, name, client, sessionId }`.
+### Save or forget
 
-## Resources
+`add_memory` saves the supplied `content` by default. Set `action` to `forget` when a fact is outdated or should be removed. There is no separate forget tool.
 
-| URI | Description |
-|-----|-------------|
-| `supermemory://profile` | User profile with stable preferences and recent activity |
-| `supermemory://projects` | List of available memory projects |
+If the content is already final, the assistant should use `add_memory`. If you want to review, edit, or choose a space before saving, it should open the `guided-save` widget instead.
 
-## Prompts
+### Access control
 
-### `context`
+`whoAmI` returns the current identity, role, access type, granted scope, and active space. `listSpaces` returns only spaces the authenticated account can access, with names, keys, document and memory counts, and recent activity.
 
-Inject user profile and preferences as system context for AI conversations. Returns a formatted message with the user's stable preferences and recent activity.
+## Interactive widgets
 
-In Cursor and Claude Code you can often invoke this with **`/context`**, which gives the model enough profile context to use and query Supermemory effectively.
+Clients that support [MCP Apps](https://modelcontextprotocol.io/extensions/apps/overview) can open these Supermemory widgets directly inside the conversation.
 
-**Purpose:** Unlike the `recall` tool (search for specific information) or the `profile` resource (raw data), the `context` prompt is a pre-formatted system message for conversation start.
+| Tool | What it opens |
+| --- | --- |
+| `select-space` | A searchable space picker |
+| `guided-save` | An editable memory form with a space selector |
+| `upload-file` | A local file picker and upload form |
+| `memory-graph` | An interactive graph of documents and memories |
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `containerTag` | string | No | Project tag to scope the profile (max 128 chars) |
-| `includeRecent` | boolean | No | Include recent activity in the profile. Default: `true` |
+### Select a space
 
-**Output format:**
-- Instructions to save new memories using the `memory` tool
-- **Stable Preferences:** Long-term user facts and preferences
-- **Recent Activity:** Recent interactions and context (when `includeRecent` is `true`)
-- Fallback message when no profile exists yet
+`select-space` opens a searchable space picker and changes the active space for future Supermemory actions. A one-off request in another space does not change the active space.
 
-**When to use:**
-- **`context` prompt** — automatic system context at conversation start
-- **`recall` tool** — search for specific information
-- **`profile` resource** — raw profile data for custom processing
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/widgets/select-space.png"
+  alt="Supermemory MCP searchable space picker"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/widgets/select-space-dark.png"
+  alt="Supermemory MCP searchable space picker"
+/>
+
+### Guided save
+
+`guided-save` opens a draft with editable memory content and a writable-space selector. The assistant can prefill the draft, but nothing is saved until you submit it.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/widgets/guided-save-draft.png"
+  alt="Supermemory MCP guided save draft with editable memory content and a space selector"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/widgets/guided-save-dark.png"
+  alt="Supermemory MCP guided save draft with editable memory content and a space selector"
+/>
+
+### File upload
+
+`upload-file` opens a local file picker and uploads one file at a time to a writable space.
+
+Supported types include text, Markdown, PDF, Word, CSV, common images, MP3, WAV, M4A, MP4, and WebM.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/widgets/upload-file.png"
+  alt="Supermemory MCP file picker with a writable-space selector"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/widgets/upload-file-dark.png"
+  alt="Supermemory MCP file picker with a writable-space selector"
+/>
+
+### Memory graph
+
+`memory-graph` renders the selected space as an interactive graph of source documents and extracted memories.
+
+When no space is named, the server automatically uses the active space or account default. If you name a specific space, the assistant calls `listSpaces` to resolve its name to a space key, then opens that space's graph.
+
+<img
+  className="hidden dark:block"
+  src="/images/supermemory-mcp/widgets/memory-graph.png"
+  alt="Supermemory MCP interactive graph of documents and memories"
+/>
+<img
+  className="block dark:hidden"
+  src="/images/supermemory-mcp/widgets/memory-graph-dark.png"
+  alt="Supermemory MCP interactive graph of documents and memories"
+/>
+
+## Resources and context prompt
+
+Some MCP clients also expose resources and prompts:
+
+| Kind | Name or URI | What it returns |
+| --- | --- | --- |
+| Resource | `supermemory://profile` | Stable and recent profile context for the active space |
+| Resource | `supermemory://spaces` | A compact list of accessible spaces with the active space marked |
+| Prompt | `context` | A ready-to-attach context message for the active space, plus up to three recently active spaces |
+
+The `context` prompt takes no arguments. It returns profile context for the active space and up to three recently active spaces.
 
 <CardGroup cols={2}>
   <Card title="Setup and Usage" icon="settings" href="/supermemory-mcp/setup">
-    Client configs, OAuth, and project scoping.
+    Configure Supermemory in supported MCP clients.
   </Card>
-  <Card title="MCP Server Source" icon="/images/github-icon.svg" href="https://github.com/supermemoryai/supermemory/tree/main/apps/mcp">
-    Open-source implementation.
+  <Card title="Supermemory MCP on GitHub" icon="/images/github-icon.svg" href="https://github.com/supermemoryai/supermemory/tree/main/apps/mcp">
+    View the source code.
   </Card>
 </CardGroup>

apps/docs/supermemory-mcp/setup.mdx

@@ -1,7 +1,7 @@
 ---
-title: 'Setup and Usage'
-description: 'How to set up and use Supermemory MCP Server 4.0'
-icon: 'settings'
+title: "Setup and Usage"
+description: "Connect Supermemory to an MCP client with OAuth and choose how requests use spaces"
+icon: "settings"
 ---
 
 ## Server URL
@@ -10,7 +10,7 @@ icon: 'settings'
 https://mcp.supermemory.ai/mcp
 ```
 
-Add this to your MCP client config (Claude, Cursor, Windsurf, VS Code, etc.):
+Add the remote server to your MCP client:
 
 ```json
 {
@@ -22,36 +22,30 @@ Add this to your MCP client config (Claude, Cursor, Windsurf, VS Code, etc.):
 }
 ```
 
-The server requires **OAuth authentication**. Your MCP client will automatically discover the authorization server via `/.well-known/oauth-protected-resource` and prompt you to authenticate.
+Supermemory MCP uses OAuth. Your client opens the authorization page so you can sign in and approve access. No API key or custom header is required.
 
-## Project Scoping (Optional)
+## Choose a space
 
-To scope all operations to a specific project, add the `x-sm-project` header:
+After connecting, space-aware tools use your active Supermemory space or account default. You can work in another space in two ways:
 
-```json
-{
-  "mcpServers": {
-    "supermemory": {
-      "url": "https://mcp.supermemory.ai/mcp",
-      "headers": {
-        "x-sm-project": "your-project-id"
-      }
-    }
-  }
-}
-```
+- Name a space for a one-off action without changing your active space.
+- Ask to switch your active space for future actions.
 
-This keeps memories organized by project, useful when working on multiple codebases or contexts.
+See [How spaces work](/supermemory-mcp/mcp#how-spaces-work) for examples and routing rules.
 
-## Client-Specific Setup
+## Client-specific setup
 
-### Claude Desktop
+### ChatGPT Web
 
-For a screenshot-backed walkthrough (Settings → Connectors → Add custom connector with the URL above), see **[Claude Desktop](/supermemory-mcp/claude-desktop)**.
+Enable developer mode, add Supermemory from the ChatGPT Plugins page, and complete OAuth. See the [ChatGPT Web guide](/supermemory-mcp/chatgpt-web) for the complete flow.
+
+### Claude Desktop and Claude web
+
+Open **Settings > Connectors**, add a custom connector, and enter the server URL. See the [Claude Desktop guide](/supermemory-mcp/claude-desktop) for the complete flow.
 
 ### Cursor
 
-Add to `~/.cursor/mcp.json`:
+Add the server to `~/.cursor/mcp.json`:
 
 ```json
 {
@@ -63,8 +57,22 @@ Add to `~/.cursor/mcp.json`:
 }
 ```
 
-Or use the one-click install button at [app.supermemory.ai](https://app.supermemory.ai).
+You can also use the install option in [app.supermemory.ai](https://app.supermemory.ai).
 
-### Windsurf / VS Code
+### Other MCP clients
 
-Configuration varies by extension. Generally, add the server URL (`https://mcp.supermemory.ai/mcp`) to your MCP settings.
+Add `https://mcp.supermemory.ai/mcp` as a remote HTTP MCP server and complete the OAuth flow opened by your client. Exact menu names and configuration locations vary between clients.
+
+Clients with MCP Apps support render the space picker, guided save, file upload, and memory graph directly in the conversation.
+
+## Verify the connection
+
+Start with any of these requests:
+
+- "What Supermemory spaces can I access?"
+- "What is my active Supermemory space?"
+- "Search my saved context for the launch plan."
+- "I want to upload a file to Supermemory."
+- "Show my memory graph."
+
+The [MCP overview](/supermemory-mcp/mcp) documents every tool, widget, resource, and the `context` prompt.