Connectors
A connector lets any AI app you already use — ChatGPT, Claude, Cursor, Windsurf, VS Code, and anything else that speaks the Model Context Protocol — talk to your SharedMemory directly. You sign in once, click "Allow", and from that point on the app can remember things for you and recall them across sessions.
Under the hood, this is a remote MCP server with OAuth 2.1. No API keys to copy around, no JSON files to edit. Each app gets its own scoped token bound to your SharedMemory account, and you can revoke any of them with one click from the dashboard.
The connection URL​
There is exactly one URL you need:
https://api.sharedmemory.ai/mcp
Paste this into the connector picker of any MCP-aware app. The first time you use it, your browser will open a SharedMemory sign-in page. After you click Allow, the app is connected.
What the AI app can do​
Once connected, the app can use these tools on your behalf:
| Tool | Purpose |
|---|---|
remember | Save a new fact, preference, or instruction |
query | Recall relevant memories before answering |
search_entities | Find people, projects, or concepts you've mentioned |
get_entity | Pull everything you know about one entity |
get_graph | Get a map of your knowledge graph |
get_profile | Get a comprehensive profile for context injection |
get_context | Assemble a smart system-prompt context block |
set_instruction | Save a persistent rule (e.g. "Always use Tailwind") |
decide | Ask SharedMemory to make a decision from stored knowledge |
feedback | Mark a memory as helpful or irrelevant |
delete_memory | Remove a memory by ID |
update_memory | Edit the content of an existing memory |
list_volumes | List the projects this connection can access |
list_documents | List uploaded documents in a project |
batch_remember | Save many memories at once |
Each tool runs through the same memory pipeline as your direct API calls — classification, conflict resolution, graph extraction, decay tuning — so the AI app benefits from everything you've already configured.
Identity and attribution​
Every memory created through a connector is tagged with the originating app. Open the Activity feed and you'll see badges like ChatGPT, Claude, Cursor, or VS Code next to each event — not a generic "api". You can filter the feed by source to see exactly what each AI app has been doing.
Scopes​
Connectors request a subset of these scopes:
| Scope | What it allows |
|---|---|
memory:read | Query, search, get_entity, get_graph, get_profile, get_context, list_volumes |
memory:write | remember, batch_remember, update_memory, set_instruction |
memory:delete | delete_memory and batch delete |
feedback | submit_feedback |
documents:read | list_documents |
offline_access | issue a refresh token so the connection survives reboots |
The consent screen shows you exactly which scopes the app is asking for before you allow it.
Revoking a connection​
Open Dashboard → Connectors. Each connected app appears in the "Connected apps" list with its last-used timestamp. Click Revoke to invalidate every token issued to that app immediately — the next request it makes will get a 401 with a WWW-Authenticate header pointing it back to OAuth.
How it works​
When you paste https://api.sharedmemory.ai/mcp into an AI app, the app:
- Hits the URL with no auth, gets a
401with aWWW-Authenticate: Bearer resource_metadata=...header - Fetches
https://api.sharedmemory.ai/.well-known/oauth-protected-resourceto discover the auth server - Fetches
https://api.sharedmemory.ai/.well-known/oauth-authorization-serverfor OAuth metadata - Calls
POST /oauth/registerwith Dynamic Client Registration (RFC 7591) to mint aclient_id - Redirects your browser to
GET /oauth/authorize?...with a PKCE code challenge - SharedMemory shows the consent screen, you click Allow, your browser is bounced back to the AI app with
?code=... - The AI app exchanges the code via
POST /oauth/tokenwith the PKCE verifier to receive an access token + refresh token - From now on, every MCP call carries
Authorization: Bearer sm_oauth_...and resolves to your user, your default project, and your granted scopes
This is the standard MCP Authorization flow — exactly the same as connecting any other remote MCP server to ChatGPT or Claude. No proprietary handshake.
See the per-app setup pages for screenshots: