Recommended setup
Use the desktop MCP setup assistant when adding a server.npx or a local binary{
"mcpServers": {
"example": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@example/mcp-server"],
"env": { "EXAMPLE_API_KEY": "..." }
}
}
}
Transport fields
| Transport | Required fields | Optional fields |
|---|---|---|
stdio | command | args, env, cwd |
http | url | headers, auth-related fields supported by the server |
Deferred tools
MCP tools are deferred by server group. For example, a server namedobsidian is loaded by the agent with:
Troubleshooting
- Command not found — use an absolute command path or install the package/binary first.
- Missing env var — add required
KEY=valueentries in the server config. - HTTP auth failure — check headers/tokens and whether the server expects OAuth.
- No tools appear — verify the server starts successfully and then reload MCP/settings.