clean: Improve doc and fix typos etc. found by Gemini Code Assist review

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: vorburger

docs/concepts/mcp.md

@@ -22,10 +22,14 @@ The 🔱 [Model Context Protocol](https://modelcontextprotocol.io) (MCP) is a st
 
 ## Configuration
 
-See [`mcp.yaml`](https://github.com/enola-dev/enola/blob/main/models/enola.dev/ai/mcp.yaml).
+The `--mcp` CLI argument specifies which MCP servers are available to Agents.
+
+If not specified it uses the built-in [`mcp.yaml`](https://github.com/enola-dev/enola/blob/main/models/enola.dev/ai/mcp.yaml) by default.
 
 Use the names under the `servers:` key of a `mcp.yaml` in the `tools:` of [Agents](agent.md).
 
+MCP servers are only started (or connected to), and queried for their 🧰 Tools, if any of the loaded `--agents` use them.
+
 <!--
     ## Recommended
 
@@ -54,7 +58,7 @@ enola ai --agents=test/agents/everything.agent.yaml --in "Print environment vari
 
 ### Fetch
 
-The [`fetch` MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/everything) can fetch a webpage, and extract its contents as Markdown:
+The [`fetch` MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch) can fetch a webpage, and extract its contents as Markdown:
 
 ```shell
 enola ai -a test/agents/fetch.agent.yaml --in="What is on https://docs.enola.dev/tutorial/agents/ ?"

java/dev/enola/ai/mcp/cli/McpOptions.java

@@ -40,18 +40,18 @@ public class McpOptions {
             description =
                     "URL/s of MCP Configurations; see"
                             + " https://docs.enola.dev/concepts/mcp/#configuration")
-    @Nullable List<URI> agentURIs;
+    @Nullable List<URI> mcpConfigURIs;
 
     public static McpOptions handleDefault(@Nullable McpOptions mcpOptions) {
         if (mcpOptions == null) {
             mcpOptions = new McpOptions();
-            mcpOptions.agentURIs = List.of(URI.create(McpOptions.DEFAULT_MCP_YAML));
+            mcpOptions.mcpConfigURIs = List.of(URI.create(McpOptions.DEFAULT_MCP_YAML));
         }
         return mcpOptions;
     }
 
     public void load(McpLoader loader, ResourceProvider rp) throws IOException {
-        if (agentURIs == null) return;
-        for (var uri : agentURIs) loader.load(rp.getNonNull(uri));
+        if (mcpConfigURIs == null) return;
+        for (var uri : mcpConfigURIs) loader.load(rp.getNonNull(uri));
     }
 }

models/enola.dev/ai/mcp.yaml

@@ -28,6 +28,6 @@ servers:
     # Exercise caution when using this MCP server to ensure this does not expose any sensitive data!
     command: uvx
     args: [mcp-server-fetch]
-    origin: https://github.com//servers/tree/main/src/fetch
+    origin: https://github.com/modelcontextprotocol/servers/tree/main/src/fetch
 
 inputs: