mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-08-28 05:25:33 +00:00
fc18f8dc4a
Keep the revamped modular MCP (drop legacy apps/mcp/src/server.ts) while porting ChatGPT tool safety annotations from #1330. Resolve docs conflicts by accepting main's MCP overview rewrite with OAuth-only auth from this branch, and delete the removed introduction page. Co-authored-by: Dhravya Shah <dhravya@supermemory.com>
70 lines
1.5 KiB
Text
70 lines
1.5 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 requires **OAuth authentication**. Your MCP client will automatically discover the authorization server via `/.well-known/oauth-protected-resource` and prompt you to authenticate.
|
|
|
|
## 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.
|