Mac & WebOpen Connect

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.

The Assistants page in the Mac app, with a card and status for each assistant
  1. 1Click the card of the app you want, for example Claude Desktop or Cursor. A panel opens on the right.
  2. 2Click Configure. Esment adds itself to that app’s settings for you.
  3. 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
Good to know
Apps that are not installed show Not installed. If you install one later, open Assistants again and it will be ready to configure.
Using a web assistant?Web assistants & your Mac
ChatGPT, claude.ai, Perplexity and Grok have no Configure button. If your memory lives on your Mac, use the tunnel described there. If you use the web dashboard (Esment Cloud), copy your memory endpoint from the Assistants page instead; the page for each assistant explains it.

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.

  1. 1With the app in front, press ⌘Q (or choose Quit from its menu).
  2. 2Open the app again.
  3. 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.

Good to know
On the Mac, the Active sessions and Recent activity tables at the bottom of Assistants show which assistants have called your memory and when.

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.