Merge pull request #35 from basicmachines-co/codex/app-store-install-docs

docs: add app store installation guides

Author: phernandez

content/01.start-here/2.quickstart-cloud.md

@@ -27,38 +27,36 @@ After sign-up, the app prepares your workspace and opens a seeded **Getting Star
 
 ## 2. Connect your AI assistant
 
-Use the remote MCP endpoint URL:
+The published ChatGPT and Claude listings are the quickest setup paths. Choose your assistant, connect the listing, and complete the Basic Memory authorization flow.
 
-```bash
-https://cloud.basicmemory.com/mcp
-```
-
-### For Claude Desktop
+### For Claude
 
-1. In Claude Desktop or Claude.ai, go to **Settings → Claude → Connectors** and click **Add custom connector**.
-2. Enter the name **Basic Memory** and the server URL `https://cloud.basicmemory.com/mcp`, then click **Connect** and complete the OAuth flow.
-3. Confirm Basic Memory appears in the tools menu in chat.
+1. Open the [Claude Directory](https://claude.ai/directory), or go to **Settings → Customize → Connectors** and select **+**.
+2. Search for **Basic Memory Cloud**, open the published connector, and select **Install**.
+3. Complete authorization, then ask Claude to list your Basic Memory projects.
 
-Full walkthrough with screenshots: [Claude Desktop](/integrations/claude-desktop).
+The remote connector works across Claude web, desktop, mobile, Cowork, and Claude Code. Full walkthrough and manual connector fallback: [Claude Desktop](/integrations/claude-desktop).
 
 ### For ChatGPT
 
-::note
-ChatGPT requires a **Plus or Pro subscription** to use remote MCP servers.
-::
-
 ::steps
-### Add the MCP server
-In ChatGPT, go to **Settings → Developer → Custom MCP Servers** and add the Basic Memory endpoint URL: `https://cloud.basicmemory.com/mcp`
+### Open the plugin
 
-### Authenticate
-Complete the OAuth flow when prompted
+Open [Basic Memory Cloud in ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6a49590bf6348191a16c0b87ca6b01b4), or select **Plugins** in the ChatGPT sidebar and search for **Basic Memory Cloud**.
+
+### Connect
+
+Select **Connect** and complete the Basic Memory authorization flow.
+
+### Start a chat
+
+Select **Try in chat**. In an existing conversation, type `@` and choose **Basic Memory Cloud**, or select **+ → More → Basic Memory Cloud**.
 ::
 
-See the [ChatGPT integration guide](/integrations/chatgpt) for the full walkthrough, including the per-chat step for enabling the connector.
+See the [ChatGPT integration guide](/integrations/chatgpt) for the full walkthrough, managed-workspace notes, and manual custom MCP fallback.
 
-::tip
-Watch the [ChatGPT setup video](https://youtube.com/watch?v=NvU0Jo38P_k) for a complete walkthrough.
+::note
+If you need to configure a custom connector instead of using the stores, the remote MCP endpoint is `https://cloud.basicmemory.com/mcp`. The integration guides above have the current manual steps.
 ::
 
 ### For other assistants

content/03.cloud/01.cloud-guide.md

@@ -18,27 +18,29 @@ Basic Memory Cloud provides hosted MCP access with no local installation require
 
 ## Setup with Claude
 
-Basic Memory Cloud uses Remote MCP to connect to AI assistants. The connection URL is:
+Open the [Claude Directory](https://claude.ai/directory), search for **Basic Memory Cloud**, and select **Install**. Complete the Basic Memory authorization flow, then ask Claude to list your Basic Memory projects.
 
-```
-https://cloud.basicmemory.com/mcp
-```
-
-In Claude Web or Desktop, add a custom connector under **Settings → Claude → Connectors** with that URL, then click **Connect** and complete the OAuth flow. Your notes save to your cloud instance.
+The published remote connector works across Claude web, desktop, mobile, Cowork, and Claude Code.
 
 ::tip
-For detailed Claude setup instructions, see the [Claude Desktop Integration](/integrations/claude-desktop) guide.
+For the directory walkthrough and manual custom-connector fallback, see the [Claude Desktop Integration](/integrations/claude-desktop) guide.
 ::
 
 ---
 
 ## Setup with ChatGPT
 
+Open [Basic Memory Cloud in ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6a49590bf6348191a16c0b87ca6b01b4), select **Connect**, and complete the Basic Memory authorization flow. Select **Try in chat** to start a conversation with the app enabled.
+
+For the full Plugin-directory walkthrough, managed-workspace notes, and manual custom MCP fallback, see the [ChatGPT Integration](/integrations/chatgpt) guide.
+
 ::note
-ChatGPT requires a **Plus or Pro subscription** to use remote MCP servers.
-::
+For clients or advanced setups that require a server URL, the Basic Memory Cloud remote MCP endpoint remains:
 
-For detailed ChatGPT setup instructions, see the [ChatGPT Integration](/integrations/chatgpt) guide.
+```text
+https://cloud.basicmemory.com/mcp
+```
+::
 
 ---
 

content/08.integrations/0.index.md

@@ -6,11 +6,7 @@ description: Choose an AI client or extension and connect it to Basic Memory.
 Basic Memory is most useful when the AI tools you already use can read and write the same shared knowledge base. Start with the tool you use most, then connect others to the same workspace as needed.
 
 ::tip
-For Basic Memory Cloud, the fastest path is the **Connect Your AI Tool** walkthrough in the web app's Help Center (account menu → **Help**) — it has your MCP endpoint with a copy button, Claude and ChatGPT setup guides, and a quick test prompt:
-
-```text
-https://cloud.basicmemory.com/mcp
-```
+For Basic Memory Cloud, install the published **Basic Memory Cloud** plugin from ChatGPT's Plugin directory or the published **Basic Memory Cloud** connector from Claude's Connectors Directory. The web app's Help Center (account menu → **Help**) also has setup guidance, your MCP endpoint for manual connections, and a quick test prompt.
 
 For local/open-source Basic Memory, use the local MCP server from your computer. See [Local MCP tools](/local/mcp-tools-local).
 ::
@@ -28,7 +24,7 @@ title: Claude
 icon: i-simple-icons-anthropic
 to: /integrations/claude-desktop
 ---
-Connect Claude Desktop through a custom remote MCP connector — once added to your Claude account, it's also available on claude.ai and mobile.
+Install the published connector from Claude's Connectors Directory. One connection works across web, desktop, mobile, Cowork, and Claude Code.
 ::
 
 ::card
@@ -55,7 +51,7 @@ title: ChatGPT
 icon: i-simple-icons-openai
 to: /integrations/chatgpt
 ---
-Connect ChatGPT as a custom MCP app, with notes about the extra per-chat step.
+Install Basic Memory Cloud from ChatGPT's Plugin directory, then start from the listing or enable it in an existing chat.
 ::
 :::
 

content/08.integrations/01.claude-desktop.md

@@ -9,39 +9,80 @@ Basic Memory describes its tools to Claude through the Model Context Protocol, s
 
 ## Cloud Setup
 
+Basic Memory is published in Claude's **Connectors Directory**. This is the recommended way to connect Basic Memory Cloud.
+
 ::steps
 ### Sign Up
 Create your account at [basicmemory.com](https://basicmemory.com/?utm_source=docs&utm_medium=docs&utm_campaign=claude-desktop)
 
-### Open Settings
-In Claude Desktop or Claude.ai, go to **Settings → Claude → Connectors**
+### Open the Connectors Directory
+
+Open the [Claude Directory](https://claude.ai/directory). You can also go to **Settings → Customize → Connectors** and select **+**.
+
+From a chat, select **+ → Connectors → Manage connectors**, then select **+** next to Connectors.
+
+### Find Basic Memory Cloud
+
+Search for **Basic Memory Cloud** and open the published connector. Review its description and capabilities.
+
+![Basic Memory Cloud in Claude's Connectors Directory](/screenshots/claude/connectors-directory-basic-memory-cloud.jpg)
+
+### Connect
+
+Select **Install**, then complete the Basic Memory authorization flow. If it is already connected, the directory shows **Manage** instead.
+
+### Verify Setup
+
+Return to a chat and ask:
+
+```text
+List my Basic Memory projects.
+```
+::
+
+::tip
+Claude remote connectors work across Claude on the web, Claude Desktop, mobile, Cowork, and Claude Code. Once connected to your Claude account, no separate setup is needed on each surface.
+::
+
+## Manual Cloud Setup
+
+Use the custom-connector flow only if the directory listing is unavailable or you specifically need to add the MCP endpoint yourself.
+
+::steps
+### Open connector settings
+
+In Claude Desktop or Claude.ai, go to **Settings → Customize → Connectors**.
 
 ![Claude Settings - Connectors](/screenshots/claude/settings-connectors.png)
 
-### Add Custom Connector
-Click **Add custom connector** and enter:
+### Add a custom connector
+
+Select **Add custom connector** and enter:
+
 - **Name**: Basic Memory
 - **Remote MCP server URL**: `https://cloud.basicmemory.com/mcp`
 
 ![Claude - Add connector dialog](/screenshots/claude/add-connector.png)
 
 ### Authenticate
-Click **Connect** to start the OAuth flow. You'll be redirected to Basic Memory to authorize access.
+
+Select **Connect** to start the OAuth flow. You'll be redirected to Basic Memory to authorize access.
 
 ![OAuth authorization](/screenshots/claude/oauth-connect.png)
 
 ### Configure Tools (Optional)
-Click **Configure** to customize which tools are enabled.
+
+Select **Configure** to customize which tools are enabled.
 
 ![Claude - Configure tools](/screenshots/claude/configure-tools.png)
 
 ### Verify Setup
+
 Confirm Basic Memory appears in the tools menu in chat.
 
 ![Claude - Tools menu](/attachments/claude-tools-menu.png)
 
 Try prompting: `List my projects`
-
 ::
 
 ::tip
@@ -123,12 +164,14 @@ You can also reference specific notes with `memory://` URLs. Learn more in [Memo
 ## Troubleshooting
 
 ### Tools not appearing
-- **Cloud**: Re-open Claude Desktop after adding the connector. Check that the connector URL is exactly `https://cloud.basicmemory.com/mcp`.
+
+- **Directory connector**: Open **Settings → Customize → Connectors** and confirm Basic Memory is connected. In a managed workspace, an owner may need to enable the connector first.
+- **Custom cloud connector**: Re-open Claude Desktop after adding it. Check that the connector URL is exactly `https://cloud.basicmemory.com/mcp`.
 - **Local**: Verify `uv` is installed (`which uvx`), check config JSON syntax, and restart Claude Desktop.
-- **Advanced research is on**: research runs in a separate environment that can't reach MCP connectors — ask Basic Memory questions in a normal chat instead.
 
 ### Tools appear but return errors
-- **Cloud**: check the [Activity view](/cloud/web-app#activity) for failed operations, or remove and re-add the connector.
+
+- **Cloud**: check the [Activity view](/cloud/web-app#activity) for failed operations, or disconnect and reconnect the connector.
 - **Local**: check Basic Memory is installed (`basic-memory --version`), verify sync status (`basic-memory status`), and check file permissions in your `~/basic-memory` directory.
 
 ### Changes not showing up (local)
@@ -145,6 +188,8 @@ Projects are selected at the start of each conversation. For single-project setu
 }
 ```
 
+For Claude's current platform instructions, see [Use connectors to extend Claude's capabilities](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities).
+
 ---
 
 ## Next Steps

content/08.integrations/04.chatgpt.md

@@ -1,41 +1,65 @@
 ---
 title: ChatGPT
-description: Use ChatGPT with Basic Memory Cloud for MCP-powered knowledge access
+description: Install Basic Memory Cloud from ChatGPT's Plugin directory and use your knowledge base in chat.
 ---
 
-ChatGPT supports remote MCP servers, giving it access to your Basic Memory knowledge base. Since ChatGPT only connects to remote servers, **Basic Memory Cloud is required**.
+Basic Memory Cloud is available in ChatGPT's **Plugin directory**. Connecting the published plugin is the recommended setup; it does not require Developer mode or a server URL. Since ChatGPT connects to the hosted service, **Basic Memory Cloud is required**.
 
-## Cloud Setup
+## Install from the Plugin directory
 
 ::steps
-### Sign Up
+### Open Basic Memory Cloud
 
-Create your account at [basicmemory.com](https://basicmemory.com/?utm_source=docs&utm_medium=docs&utm_campaign=chatgpt).
+Open [Basic Memory Cloud in ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6a49590bf6348191a16c0b87ca6b01b4). You can also select **Plugins** in the ChatGPT sidebar and search for **Basic Memory Cloud**.
 
-### Get Your MCP Endpoint
+![Basic Memory Cloud in ChatGPT's Plugin directory](/screenshots/chatgpt/plugin-directory-basic-memory-cloud.jpg)
 
-Your remote MCP URL: `https://cloud.basicmemory.com/mcp`
+### Connect your account
 
-### Configure ChatGPT
+Select **Connect** and complete the Basic Memory authorization flow. If you do not have an account yet, you can create one during sign-in.
 
-In ChatGPT, go to **Settings → Apps & Connectors → Advanced settings** and enable **Developer mode**. Then click **Create** and enter:
+### Start a chat
 
-- **Name**: Basic Memory
-- **Server URL**: `https://cloud.basicmemory.com/mcp`
-
-### Authenticate
+Select **Try in chat** from the plugin page. In an existing conversation, type `@` and choose **Basic Memory Cloud**, or select **+ → More → Basic Memory Cloud**.
 
-Follow the OAuth flow to grant ChatGPT access to your Basic Memory account.
+### Verify the connection
 
-### Enable in Conversations
+Ask:
 
-When chatting, enable Basic Memory from the MCP server selector to start using your knowledge base.
+```text
+List my Basic Memory projects.
+```
 ::
 
 ::tip
 See the [Cloud Guide](/cloud/cloud-guide) for account setup, the web app, and sync options.
 ::
 
+## Manual setup with custom MCP
+
+Use this only when you need a custom MCP connection or cannot use the published plugin. Plugin-directory users can skip Developer mode entirely.
+
+::steps
+### Create a Basic Memory account
+
+Sign up at [basicmemory.com](https://basicmemory.com/?utm_source=docs&utm_medium=docs&utm_campaign=chatgpt).
+
+### Enable Developer mode
+
+In ChatGPT, go to **Settings → Apps & Connectors → Advanced settings** and enable **Developer mode**.
+
+### Add the MCP server
+
+Select **Create** and enter:
+
+- **Name**: Basic Memory
+- **Server URL**: `https://cloud.basicmemory.com/mcp`
+
+### Authenticate and enable
+
+Complete the OAuth flow, then select Basic Memory from the app or MCP selector in your conversation.
+::
+
 ## Try It
 
 Once connected, ask ChatGPT to work with your knowledge base:
@@ -49,25 +73,29 @@ ChatGPT will call the appropriate tools behind the scenes, searching and fetchin
 ## Important Notes
 
 ::warning
-**A paid ChatGPT plan is required** (Plus, Pro, Business/Team, Enterprise, or Edu). MCP integration is not available on the free tier.
+Plugin availability can depend on your ChatGPT plan, region, workspace settings, and role. If **Connect** is unavailable or marked **Disabled by admin**, ask your workspace admin to enable the plugin and its Basic Memory Cloud app.
 ::
 
 ::note
-**Default vs full MCP access**
-
-In ChatGPT's standard search and deep-research contexts, connectors only call two tools: `search` and `fetch`. Conversations with the Developer-mode connector enabled get the full tool set — `write_note`, `edit_note`, explicit search modes, and project management.
+**Plugin and app terminology**
 
-See the [MCP Tools Reference](/reference/mcp-tools-reference) for full tool documentation and the [Semantic Search](/concepts/semantic-search) guide for search mode details.
+ChatGPT calls the directory listing a **plugin**. The plugin contains the **Basic Memory Cloud app**, which connects ChatGPT to your knowledge base. You may see both terms in ChatGPT's settings.
 ::
 
 ## Troubleshooting
 
-**"MCP server not available"** — Confirm you're on a paid ChatGPT plan. MCP is not available on the free tier.
+**Plugin not found** — Open the [direct plugin page](https://chatgpt.com/plugins/plugin_asdk_app_6a49590bf6348191a16c0b87ca6b01b4) or search the Plugin directory for the exact name **Basic Memory Cloud**.
+
+**Connect is disabled** — Your plan, region, role, or workspace policy may restrict the app. In a managed workspace, ask an admin to review **Workspace settings → Plugins** and the underlying app in **Workspace settings → Apps**.
 
-**Authentication errors** — Re-add the MCP server in ChatGPT settings and complete the OAuth flow again.
+**Authentication errors** — Disconnect and reconnect the Basic Memory Cloud app, then complete the OAuth flow again. If you used the manual custom MCP flow, remove and re-add that server.
+
+**Basic Memory is not used in a chat** — Type `@Basic Memory Cloud` or select **+ → More → Basic Memory Cloud**. Starting from **Try in chat** on the plugin page also creates a conversation with it enabled.
 
 **No results returned** — Make sure your Basic Memory Cloud account has synced content. Check your project at [app.basicmemory.com](https://app.basicmemory.com).
 
+For ChatGPT's current platform instructions, see [Plugins in ChatGPT and Codex](https://help.openai.com/en/articles/20001256-plugins-in-chatgpt-and-codex).
+
 ## Next Steps
 
 :::card-group