mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-26 06:04:08 +00:00
95 lines
2.8 KiB
Text
95 lines
2.8 KiB
Text
---
|
|
title: "Setup and usage"
|
|
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"
|
|
---
|
|
|
|
## 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.
|
|
|
|
### 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:
|
|
|
|
- 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. 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.
|
|
|
|
## 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.
|