Skip to main content
Model Context Protocol (MCP) is an open standard that lets AI models use outside tools and data. Each MCP server offers tools an agent can call, such as reading files, querying a database, or sending a message. Add a server to Enconvo, and agents use its tools on their own when a task needs them.

​
Add a server in Settings

1

Open MCP Servers

Open Settings from the Enconvo icon in the menu bar (Settings…), or press ⌘,. Then open Settings → MCP Servers.
2

Add the server

Click Add server and enter a Server name. Choose a transport: STDIO for a command that runs on your Mac, or HTTP or SSE for a server at a URL. Fill in its fields and click Save.
3

Check that it connects

The dot beside the server turns green, and its row shows how many tools it has. Click the tool count to see them.
4

Choose where its tools apply

Use the switch on the server’s row. On: Enconvo includes the server’s tools whenever the assistant prepares a reply, everywhere. Off: they aren’t loaded everywhere, but you can still add the server from SmartBar or turn it on for one app in App Sidebar.
Servers that use OAuth open a sign-in page the first time you connect. If a server shows Authenticate, click it and finish signing in. Grant access appears when a connected server asks for more access than your sign-in gave it. Servers that come with a plugin are listed under From plugins.
The Settings sidebar is long. Press ⌘F in Settings and type “MCP” to jump to the pane, or open it with the deeplink enconvo://preference?pane=mcp_management.

​
Add a server from the CLI

​
Import servers from another app

Bring in the MCP configs you already use in Claude Desktop, Cursor, or another tool.
  1. In Settings → MCP Servers, click Import.
  2. Under Config Format, choose Claude Desktop or Codex CLI.
  3. Paste the configuration into JSON Config.
  4. Click Import. Every server in it is added.

​
Install an MCP bundle

An MCP bundle is an .mcpb file that packs a server to run on your Mac. In Settings → MCP Servers, click Install bundle and choose the file. Opening an .mcpb file in Finder brings you to the same place. A bundle’s server runs on your Mac with your permissions, so install bundles only from people you trust. To update one, install a newer .mcpb file. An install link adds an MCP server to Enconvo in one click. It uses the same format as mcp.json: a name and the transport configuration.
The web page opens the enconvo:// deeplink, and shows the server configuration in case the app doesn’t open.
  1. Get the server’s name and JSON configuration.
  2. JSON.stringify the configuration, then base64 encode it.
  3. Replace $NAME and $BASE64_ENCODED_CONFIG with the name and the encoded config.
For example, this configuration:
Single MCP server config
gives these results:

​
Add a button to your README

​
What happens when someone opens it

  1. They click the link or paste it into a browser.
  2. Enconvo asks Add the MCP server “name”? and shows what the server runs or connects to. They click Add.
  3. Settings → MCP Servers opens, and the server is added and starts connecting.
  4. Once it’s connected, agents can use its tools.

​
Troubleshooting

For the full MCP specification, see modelcontextprotocol.io.

Creating Custom MCP Servers

Build your own server for Enconvo.

Plugins

Find plugins, Connectors, and skills.

App Sidebar

Turn on a server’s tools for one app.

CLI and Local APIs

Script Enconvo from the terminal.