From 22c79f0cf5ec73dafc07e6fa28616e0ab65cb293 Mon Sep 17 00:00:00 2001
From: sosidudku1 <273119990+sosidudku1@users.noreply.github.com>
Date: Thu, 22 Oct 2026 17:34:49 +0300
Subject: [PATCH] docs(mcp): document API key auth for clients without OAuth

---
 apps/docs/supermemory-mcp/setup.mdx | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/apps/docs/supermemory-mcp/setup.mdx b/apps/docs/supermemory-mcp/setup.mdx
index 5c48cc17..74101686 100644
--- a/apps/docs/supermemory-mcp/setup.mdx
+++ b/apps/docs/supermemory-mcp/setup.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Setup and usage"
-description: "Connect Supermemory to an MCP client with OAuth and choose how requests use spaces"
+description: "Connect Supermemory to an MCP client with OAuth or an API key and choose how requests use spaces"
 icon: "/icons/hugeicons/settings-01.svg"
 ---
 
@@ -24,6 +24,25 @@ Add the remote server to your MCP client:
 
 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.
 
+### Clients without OAuth
+
+Some MCP clients can't run an OAuth flow. They can authenticate with a Supermemory API key instead. Create a key in the [console](https://console.supermemory.ai/keys) and send it as a bearer token:
+
+```json
+{
+  "mcpServers": {
+    "supermemory": {
+      "url": "https://mcp.supermemory.ai/mcp",
+      "headers": {
+        "Authorization": "Bearer sm_your_api_key"
+      }
+    }
+  }
+}
+```
+
+The server recognizes keys that start with `sm_` and skips OAuth for them. The key has the same access as in the API, so keep it out of shared or committed config files.
+
 ## Choose a space
 
 After connecting, space-aware tools use your active Supermemory space or account default. You can work in another space in two ways:
@@ -59,7 +78,7 @@ Add the server to `~/.cursor/mcp.json`:
 
 ### Other MCP clients
 
-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.
+Add `https://mcp.supermemory.ai/mcp` as a remote HTTP MCP server and complete the OAuth flow opened by your client. If the client has no OAuth support, pass an API key as shown in [Clients without OAuth](#clients-without-oauth). 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.