Prerequisites
- The MCP server binary or script must be installed and executable on your PATH.
- Verify it works by running
npx -y @modelcontextprotocol/inspector <your-command>in a terminal.
Add the server in MIRA
Enter the command
Type the shell command that launches your MCP server.Examples:
| Server | Command |
|---|---|
| Filesystem tools | npx -y @modelcontextprotocol/server-filesystem /path/to/dir |
| GitHub tools | npx -y @modelcontextprotocol/server-github |
| Custom Python script | python /path/to/my_mcp_server.py |
Set environment variables (optional)
Click Add Env Var to inject environment variables such as API keys into the subprocess.
Give the server a name
Enter a short name (e.g.
filesystem). This name becomes the tool namespace prefix.Set scope
Choose Session (active only in the current chat) or Global (always available).
See Session vs Global for details.
Verifying the connection
After saving, the server card shows:- 🟢 Connected — tools discovered successfully
- 🔴 Error — command failed; hover for the error message
Troubleshooting
| Symptom | Fix |
|---|---|
| Server shows Error immediately | Run the command in a terminal to see the raw error output |
| Tools not appearing | Ensure the server outputs valid MCP JSON-RPC on stdout (no extra debug logging) |
| Environment variable not passed | Verify the variable name exactly matches what the server expects |
| Server disconnects mid-session | Check if the subprocess crashes; add --verbose to the command if available |
Edit this page — Open a pull request