Discussion on "Building a Customer-Facing MCP Server: What Do You Actually Need?"

Mirna De Jesus Cambero · 2026-07-03T17:20:15.895Z

In the previous article, we looked at how MCP works behind the scenes and the role played by clients, servers, tools, resources, and prompts. This time, let's look at a specific use case: building a c

Totally agree with you. The AI client doesn't know your data model—that's exactly why good tool descriptions and the right context matter so much. AI is smart, but the quality of the outcome is often only as good as the clarity of the input and context you provide.

I couldn't agree more about the stdio part as well. I got my server working with stdio pretty quickly, and it was a great way to get my feet wet. But I soon realized it was really just a prototype, and that building a production-ready MCP server meant moving to HTTP to support multiple users and proper session handling.

Thanks for stopping by and taking the time to leave such a thoughtful comment!

The session isolation point is where most production issues surface — the typical trap is passing auth context at server init instead of per-request, so the first time two users hit the server concurrently, one session's context bleeds into the other. Worth calling out explicitly in a follow-up article if you cover the multi-tenant path in more depth.

The "capabilities over API mirror" framing is the right mental model, and it takes a few embarrassing false starts before it clicks. The moment it clicked for me was realizing the AI client doesn't know your data model — it only knows what the tool description says. A tool called get_documents with a vague description never gets called correctly; find_invoices_by_vendor_and_date_range with a two-line description that includes the expected output format hits on the first try, consistently.

The stdio→HTTP migration point is also underrated — most tutorials skip it because they don't model concurrent connections or session state. For multi-tenant setups, per-session context isolation is the piece most examples handle poorly or not at all.

Search Hashnode

Building a Customer-Facing MCP Server: What Do You Actually Need?

Responses(3)