mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-06 02:47:54 +00:00
640eeaa8e8
Co-authored-by: Dhravya Shah <dhravya@supermemory.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
76 lines
2.2 KiB
Text
76 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: "/icons/hugeicons/settings-01.svg"
|
|
---
|
|
|
|
## 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"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### 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.
|