What is MCP?

MCP allows you to connect to a "server" that can run locally on your Mac or PC, or on a remote server. Such a server may provide a list of tools that the assistant can use automatically during the chat.

Below is an example where four servers are connected to the given assistant, and one of them allows interaction with Spotify. When I simply asked to switch the music, the agent just did it.

MCP Support

Currently (May 2025), Alice supports MCP tools, and this support is available for any model capable of generating JSON. JSON mode, Structured Output, and Function Calling are not required but it's recommended to use SOTA (State of the Art) models.

What's more, you can connect MCP Servers not only globally, but you can also choose which assistant connects to which server and which tools. These settings are available in the Assistant's Edit view.

MCP Configuration

You can connect two types of MCP servers—SSE and STDIO. It is important to note that you need to specify absolute paths for the executable and server script, as otherwise Alice will not be able to connect to your MCP Server.

So for example, if we have Firecrawl MCP, we need to first:

1. Install it with npm install -g firecrawl-mcp command

2. And obtain the absolute paths for Node and NPX by running the commands "which node" and "which npx" in a terminal. So instead of npx you will get something like /Users/overment/.nvm/versions/node/v22.11.0/bin/npx

3. Finally, you need your Firecrawl API key

Having all this information, go to Settings -> MCP and add a new server with the type "STDIO" Then add the Runtime Executable, Server Script path, Arguments, and your API key as an Environment Variable. After that, you may change the server to "Enabled," and if everything is okay, your server may be connected with the given assistant(s).

Another example might be an HTTP SSE server, but in this case, the workflow is much simpler because you only need to ensure that the server is up and running and that you provide the correct URL along with the appropriate HTTP headers.

How to Use MCP

When you successfully connect the MCP, make sure to assign it to the assistant. Then, when you activate the given assistant, you'll see an indicator in the footer that will inform you about the MCPs that are currently active.

To call any tool or tools, simply tell the assistant what you want to achieve.

Important Note: Try to be as precise as possible. This way, you reduce the risk of the LLM using the tools in unintended ways. A good idea is to limit the available tools to the minimum and keep the tasks short and simple.

Below is an example of using two MCP Servers—Firecrawl (for accessing web pages) and FileSystem (for accessing local files). I requested access to a certain website and asked to save the pricing information to a Markdown file. As you can see, the assistant correctly identified which tools to use and in what order.

How it works under the hood?

The logic behind deciding whether to use the tool or not is straightforward. When any MCP Server is active for the given assistant, sending a message triggers an additional prompt to the model. This prompt asks if any tool needs to be used. If so, the assistant enters a loop (with a maximum of 15 steps) in which it continues performing actions until the task is completed or fails.

The important point here is that the currently active assistant's prompt is being included in the "Tool Description" prompt so it will affect the way the tool is being used.

Note:

• MCP Servers can be temporarily disabled or enabled with Command + Shift + P (you can change this shortcut in General Settings)

• MCP servers are unavailable if Online Mode, Image Generation Mode, or Remote Skill are active