For Claude and Claude Code developers, this post is a nice reminder that the hardest part of shipping AI tooling is often not the model or the protocol, but the human onboarding path around it. Luke Lanchester’s workaround is tiny, slightly hacky, and honestly pretty elegant: it turns a confusing browser error into a clear landing page that tells users what to do next.
401 Unauthorized JSON response, and assume the service was broken.GET /mcp and the Accept header includes text/html but not application/json or text/event-stream, the server returns an HTML page explaining that this is an MCP server and that it needs to be added to a client.What strikes me is that this is less about protocol design and more about expectation management. I think that’s a really useful lesson for anyone building Claude integrations: if your users can reach the endpoint in a browser, they will, and if the response looks like an error, they’ll treat it as one.
I like this solution because it’s pragmatic. It doesn’t try to “fix” MCP, and it doesn’t pretend users will read docs carefully before opening a support ticket. It just detects browser intent and swaps in a human-readable explanation. That’s the kind of small UX patch that can save a lot of operational pain.
At the same time, the post is a quiet indictment of the current ecosystem. If you have to ship connectors for every client and then still support org-specific embedded clients, that’s a maintenance treadmill. I think that’s where the hype around interoperability runs into reality: the spec may exist, but the onboarding burden still lands on the server operator.
Would I do this as a Claude Code user? Absolutely, if I were exposing an MCP endpoint to humans who might click it directly. I’d be curious whether this kind of “MCP hello page” becomes a common pattern, because it feels like one of those obvious fixes that only appears after enough support tickets pile up.
The takeaway is simple: in LLM tooling, a tiny bit of HTTP UX can matter just as much as the protocol itself. Sometimes the best “AI integration” is just making the first mistake impossible to misread.
Reference: MCP Hello Page | Blog | HybridLogic · Personal homepage of Luke Lanchester