mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-08-13 10:34:00 +00:00
4d86b728dd
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)
78 lines
2.2 KiB
Text
78 lines
2.2 KiB
Text
---
|
|
title: "Setup and Usage"
|
|
description: "Connect Supermemory to an MCP client with OAuth and choose how requests use spaces"
|
|
icon: "settings"
|
|
---
|
|
|
|
## Server URL
|
|
|
|
```text
|
|
https://mcp.supermemory.ai/mcp
|
|
```
|
|
|
|
Add the remote server to your MCP client:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"supermemory": {
|
|
"url": "https://mcp.supermemory.ai/mcp"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
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.
|
|
|
|
## 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:
|
|
|
|
- Name a space for a one-off action without changing your active space.
|
|
- Ask to switch your active space for future actions.
|
|
|
|
See [How spaces work](/supermemory-mcp/mcp#how-spaces-work) for examples and routing rules.
|
|
|
|
## Client-specific setup
|
|
|
|
### ChatGPT Web
|
|
|
|
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 the server to `~/.cursor/mcp.json`:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"supermemory": {
|
|
"url": "https://mcp.supermemory.ai/mcp"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
You can also use the install option in [app.supermemory.ai](https://app.supermemory.ai).
|
|
|
|
### 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.
|
|
|
|
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.
|