How connecting works
What “connecting” an assistant means, how to do it in a click on your Mac, and how to check that it worked.
How connecting works
Connecting an assistant is what lets it read and write your memory. Until you connect it, an assistant knows nothing about what Esment has stored. Once it is connected, it can look things up before it answers and save new facts worth keeping.
There are two kinds of assistants, and they connect differently. Desktop apps that run on your Mac (Claude Desktop, Cursor, Claude Code and similar) connect in one click from the Esment app. Web assistants (ChatGPT, claude.ai, Perplexity, Grok) run on the company’s own servers, so you give them a web address for your memory instead.
What is MCP?
You will see the term MCP in Esment and in assistants’ settings. It stands for Model Context Protocol, and all you need to know is that it is the shared standard that lets an AI app talk to other tools, in this case your memory.
When an assistant says “connector”, “custom connector” or “MCP server”, it means the same thing: a place where Esment plugs in. Every assistant in this guide uses it.
Connect in one click
Open Esment from the menu bar and go to Assistants. The apps found on your Mac appear first, each as a card with a status such as Not set up or Connected.


- 1Click the card of the app you want, for example Claude Desktop or Cursor. A panel opens on the right.
- 2Click Configure. Esment adds itself to that app’s settings for you.
- 3A message tells you to quit and reopen the app. The card’s status changes to Connected.
One-click setup is available for the apps below, when they are installed on this Mac:
- Claude Desktop and Claude Code
- Cursor and Windsurf
- Codex, Raycast, OpenCode and Hermes
The one step everyone misses
Apps only load their connections when they start. After you connect one, you must quit it completely and open it again. Closing the window is not enough, and this is the most common reason a connection seems not to work.
- 1With the app in front, press ⌘Q (or choose Quit from its menu).
- 2Open the app again.
- 3Start a new conversation. Your memory is available in it.
Check it’s working
Open the assistant, start a new chat and ask:
What memory tools do you have available?
If it is connected, it mentions Esment tools such as searching your memory or saving one. You can also tell it a fact, start another new chat and ask about it.
Which path for web assistants
Web assistants cannot see your Mac, so they need a public address. There are two ways to give them one.
- Esment Cloud (web dashboard). Your memory is already online. You copy your memory endpoint from Assistants and paste it into the assistant. Nothing has to stay open.
- The Mac app’s tunnel. Your memory stays on your Mac and Esment opens a temporary address. The app must stay running. See Web assistants & your Mac.
Other apps & managing connections
Apps that are not in the list
Any app that supports MCP can connect. On the Assistants page, open the Any MCP client card for a small snippet to copy into the app’s settings. See Perplexity, Poke & others.
Removing a connection
Open the app’s card and click Remove, then quit and reopen the app.
Having trouble?
See When a connection fails. To make assistants use memory more often, see Teach your assistants.