supermemory/apps/docs/supermemory-mcp/setup.mdx
2025-09-28 16:42:06 -07:00

67 lines
1.5 KiB
Text

---
title: 'Setup and usage'
description: 'How to set up and use supermemory MCP'
---
### Hosted setup (recommended)
1. **Visit** https://mcp.supermemory.ai
2. **Receive** automatically generated unique URL (e.g., `https://mcp.supermemory.ai/TN-IKxAcDdHWTJkMhtGLF/sse`)
3. **Select** your MCP client from the dropdown menu
4. **Copy** the generated installation command
5. **Run** the command: `npx install-mcp [YOUR_URL] --client [CLIENT_NAME]`
Or follow the client configuration example below.
### Self-hosted configuration
For users requiring complete data control:
1. **Obtain API key** from https://console.supermemory.ai
2. **Create `.env` file** with `SUPERMEMORY_API_KEY=your_key`
3. **Clone repository**: `git clone https://github.com/supermemoryai/supermemory-mcp.git`
4. **Configure MCP client** to connect to local server instance
### Client configuration example
1. For Clients that support `url` configuration:
```json
{
"mcpServers": {
"supermemory": {
"transport": "sse",
"url": "https://mcp.supermemory.ai/[USER_ID]/sse"
}
}
}
```
2. Using `supergateway` with `npx`:
```json
{
"command": "npx",
"args": ["-y", "supergateway", "--sse", "YOUR_URL"]
}
```
3. Using `supergateway` with `docker`:
The equivalent MCP command would be:
```json
{
"mcpServers": {
"supermachineExampleDocker": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"supercorp/supergateway",
"--sse",
"YOUR_SUPERMEMORY_URL"
]
}
}
}
```