From 88fa18b1d1a3510b276db2ea04b9174cbf178839 Mon Sep 17 00:00:00 2001
From: Brendan Irvine-Broque <brendanib@gmail.com>
Date: Mon, 31 Mar 2025 07:58:18 -0700
Subject: [PATCH] Document ~/.mcp-auth (#11)

To help people who get stuck with `mcp-remote`

Co-authored-by: Jeremy Morrell (Cloudflare) <jmorrell@cloudflare.com>
---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 4d373c2..bcb15bd 100644
--- a/README.md
+++ b/README.md
@@ -169,6 +169,17 @@ this might look like:
 * For bash on WSL:<br/>`tail -n 20 -f "C:\Users\YourUsername\AppData\Local\Claude\Logs\mcp.log"`
 * Powershell: <br/>`Get-Content "C:\Users\YourUsername\AppData\Local\Claude\Logs\mcp.log" -Wait -Tail 20`
 
+## Debugging
+
+If you encounter the following error, returned by the `/callback` URL:
+
+```
+Authentication Error
+Token exchange failed: HTTP 400
+```
+
+You can run `rm -rf ~/.mcp-auth` to clear any locally stored state and tokens.
+
 ### "Client" mode
 
 Run the following on the command line (not from an MCP server):