mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-08-03 05:14:10 +00:00
89 lines
No EOL
2 KiB
Text
89 lines
No EOL
2 KiB
Text
---
|
|
title: 'Setup and Usage'
|
|
description: 'How to set up and use Supermemory MCP Server 4.0'
|
|
icon: 'settings'
|
|
---
|
|
|
|
## Server URL
|
|
|
|
```text
|
|
https://mcp.supermemory.ai/mcp
|
|
```
|
|
|
|
Add this to your MCP client config (Claude, Cursor, Windsurf, VS Code, etc.):
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"supermemory": {
|
|
"url": "https://mcp.supermemory.ai/mcp"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
The server uses **OAuth authentication** by default. Your MCP client will automatically discover the authorization server via `/.well-known/oauth-protected-resource` and prompt you to authenticate.
|
|
|
|
## API Key Authentication (Alternative)
|
|
|
|
If you prefer to use an API key instead of OAuth, get one from [app.supermemory.ai](https://app.supermemory.ai) and pass it in the `Authorization` header:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"supermemory": {
|
|
"url": "https://mcp.supermemory.ai/mcp",
|
|
"headers": {
|
|
"Authorization": "Bearer sm_your_api_key_here"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
API keys start with `sm_` and are automatically detected. When an API key is provided, OAuth authentication is skipped.
|
|
|
|
## Project Scoping (Optional)
|
|
|
|
To scope all operations to a specific project, add the `x-sm-project` header:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"supermemory": {
|
|
"url": "https://mcp.supermemory.ai/mcp",
|
|
"headers": {
|
|
"x-sm-project": "your-project-id"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
This keeps memories organized by project, useful when working on multiple codebases or contexts.
|
|
|
|
## Client-Specific Setup
|
|
|
|
### Claude Desktop
|
|
|
|
For a screenshot-backed walkthrough (Settings → Connectors → Add custom connector with the URL above), see **[Claude Desktop](/supermemory-mcp/claude-desktop)**.
|
|
|
|
### Cursor
|
|
|
|
Add to `~/.cursor/mcp.json`:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"supermemory": {
|
|
"url": "https://mcp.supermemory.ai/mcp"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Or use the one-click install button at [app.supermemory.ai](https://app.supermemory.ai).
|
|
|
|
### Windsurf / VS Code
|
|
|
|
Configuration varies by extension. Generally, add the server URL (`https://mcp.supermemory.ai/mcp`) to your MCP settings. |