MCP

The MCP extension connects Nora to external tools and services that implement the Model Context Protocol.

Configure MCP Servers

Open Settings > Extensions > MCP and enter a JSON configuration. The configuration is validated when you save it.

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--isolated"]
    }
  }
}

Sliprail loads the tools exposed by each configured server. A configuration or startup error is shown in the extension status and can be retried.

Create Roles

A role becomes a launcher command that opens Nora with a specific MCP setup. Each role supports:

• Role name - The command shown in the launcher
• Message template - Replaces %s with the launcher parameter before sending it to Nora
• Read clipboard as input - Appends clipboard text to the role input
• Model - Overrides the global MCP model for this role, or uses the MCP default
• Dynamic tool search - Enabled by default. Nora searches configured tools on demand
• Available tools - Manual tool selection used when dynamic tool search is disabled

A role must have at least one available tool. With dynamic tool search enabled, all tools from the configured MCP servers are available for on-demand search.

Use a Role

1. Save a valid server configuration
2. Add a role and configure its tools
3. Enter the role name in the desktop launcher
4. Optionally press Space and provide a parameter
5. Press Enter to open Nora with the role

Global Settings

• Confirm tool calls - Enabled by default and recommended. Nora asks before executing a tool
• Model - Uses Nora's default model unless another MCP model is selected
• Use a shared MCP server instance - Enabled by default. Disable it only when the server supports multiple independent instances

If shared instances are disabled, each chat window starts its own MCP server. Some servers require an isolation option such as --isolated to work this way.

Security and Sync

MCP tools can read files, make network requests, or modify data. Keep tool-call confirmation enabled unless you fully trust the server and role configuration.

MCP cloud sync is disabled by default. Enable MCP in Cloud Sync only if you want its server and role settings synchronized.