Improve docs and MCP error logging

Author: ericdallo

docs/troubleshooting.md

@@ -1,8 +1,8 @@
 # Troubleshooting
 
-## Server logs (stderr)
+## Logs (stderr)
 
-ECA works with clients (editors) sending and receiving messages to server, a process, you can start server with `--log-level debug` or `--verbose` which should log helpful information to `stderr` buffer like what is being sent to LLMs or what ECA is responding to editors, all supported editors have options to set the __server args__ to help with that and options to check the server logs.
+All supported editors have options to set the __server args__ to help with that and options to check the server logs.
 
 To access the server logs:
 
@@ -22,6 +22,15 @@ To access the server logs:
 
     `EcaShowLogs` 
 
+### Server logs
+
+This controls what's logged by server on its actions, you can control to log more things via `--log-level debug` server arg.
+This should help log LLM outputs, and other useful stuff.
+
+### Client<->Server logs
+
+ECA works with clients (editors) sending and receiving messages to server, a process, you can start server `--verbose` which should log all jsonrpc communication between client and server to `stderr` buffer like what is being sent to LLMs or what ECA is responding to editors. 
+
 ## Doctor command
 
 `/doctor` command should log useful information to debug model used, server version, env vars and more.

src/eca/features/tools/mcp.clj

@@ -126,7 +126,7 @@
                :parameters (json/parse-string (.writeValueAsString obj-mapper (.inputSchema tool-client)) true)})
             (.tools (.listTools client))))
     (catch Exception e
-      (logger/debug logger-tag "Could not list tools:" (.getMessage e))
+      (logger/warn logger-tag "Could not list tools:" (.getMessage e))
       [])))
 
 (defn ^:private list-server-prompts [^McpSyncClient client]
@@ -142,7 +142,7 @@
                                 (.arguments prompt-client))})
             (.prompts (.listPrompts client))))
     (catch Exception e
-      (logger/debug logger-tag "Could not list prompts:" (.getMessage e))
+      (logger/warn logger-tag "Could not list prompts:" (.getMessage e))
       [])))
 
 (defn ^:private list-server-resources [^McpSyncClient client]
@@ -155,7 +155,7 @@
                :mime-type (.mimeType resource-client)})
             (.resources (.listResources client))))
     (catch Exception e
-      (logger/debug logger-tag "Could not list resources:" (.getMessage e))
+      (logger/warn logger-tag "Could not list resources:" (.getMessage e))
       [])))
 
 (defn ^:private initialize-server! [name db* config on-server-updated]