WebMCP

How to Connect BusinessCalcs to Claude Desktop or Another AI Assistant

A plain-language setup guide for connecting BusinessCalcs to Claude Desktop or another WebMCP-compatible MCP client.

Updated March 24, 2026Open the homepage and use the WebMCP widget

BusinessCalcs can expose its calculators, guides, and page context to compatible AI assistants through WebMCP. That is powerful, but it is also unfamiliar. Most users do not naturally know what a connection token is, where it comes from, or why an assistant may deny the request the first time.

The important thing to understand is that BusinessCalcs does not generate the token for you. The token comes from a compatible MCP client such as Claude Desktop running with a WebMCP server. The website simply provides the on-page widget and the tools that become available after the connection succeeds.

If the widget says paste connection token and that sounds opaque, you are not missing something obvious. This guide is the missing translation layer between the technical WebMCP flow and what a normal user actually needs to do.

What WebMCP is in plain language

WebMCP lets an AI assistant interact with a website in a structured way instead of just reading visible text like a screenshot. On BusinessCalcs, that means a compatible assistant can search the site catalog, open calculators, read page context, and inspect current calculator state on allowlisted pages.

That does not mean every chat interface can use it automatically. The assistant needs to be running through an MCP client that understands WebMCP and can generate a connection token for the page.

So the mental model is simple: BusinessCalcs provides the tools on the site, your MCP client provides the token, and the widget is the handshake point between them.

What you need before the widget will work

You need an MCP client that supports WebMCP or can run the WebMCP MCP server. Claude Desktop is the easiest example because the upstream WebMCP docs already document that flow, but the core requirement is compatibility, not a single brand name.

You also need that MCP client to generate a WebMCP token. The BusinessCalcs widget is expecting that token, not an API key, not your OpenAI login, not WEBMCP_SERVER_TOKEN from a .env file, and not a random pasted paragraph from a chatbot.

If you are using plain ChatGPT in a normal browser chat or plain Claude chat without the MCP client flow, the site may still be live and correct while the assistant denies the request. That usually means the client environment does not support the token flow in that session.

The three-step setup that usually works

Step one: open your MCP client and make sure the WebMCP MCP server is configured. The upstream docs show a Claude Desktop example using npx and @jason.today/webmcp with the --mcp flag.

Step two: ask that MCP client to generate a WebMCP token. The exact wording can vary by client, but the result needs to be the token string intended for a WebMCP website connection, not the internal server secret used by the MCP server itself.

Step three: open BusinessCalcs, click the WebMCP square in the bottom-right corner, paste that token, and connect. If the token is valid and the client is still running, the widget should switch to a connected state and the site tools should register.

Why ChatGPT or Claude may deny it at first

Many users assume that if a chat model can browse the web, it should also be able to use WebMCP automatically. Those are different capabilities. Browsing reads pages. WebMCP requires an MCP-capable client and a token handshake.

That is why an assistant may initially say the site is not MCP-enabled or claim the system is closed. In many cases the model is describing the limits of its current environment rather than the true state of the website.

A better question is not can this chatbot do it right now, but does my current client support WebMCP token generation and MCP tool connections. If the answer is no, the site can still be correctly configured while the assistant still refuses.

How to tell the connection actually succeeded

The widget should stop showing the disconnected or error state and switch to a connected message. On the client side, your MCP client should start listing BusinessCalcs tools, prompts, or resources after the connection is established.

A good first test is to ask the client to list available tools or to open a specific page such as the home loan calculator. If the assistant can open the page or read current page context, the handshake is working.

If the widget stays disconnected, the most common causes are no token pasted, a malformed token, a stale token, or an MCP client that is no longer running in the background.

The common errors and what they actually mean

No token provided means the widget has nothing to connect with. Paste a token from your MCP client first.

Unable to parse token usually means the pasted text is not a valid WebMCP token or it has been copied incompletely. One common mistake is pasting WEBMCP_SERVER_TOKEN from a .env file, but that value is for the MCP server itself and will not work in the website widget.

Connection failed or registration connection error usually means the token points to an MCP client or server that is not reachable right now. Check that the client is still running and then generate a fresh token.

Frequently asked questions

Does BusinessCalcs generate the token for me?

No. The token comes from your MCP client, such as Claude Desktop or another compatible setup. BusinessCalcs provides the widget and the site tools.

Can I use the widget from plain ChatGPT web chat?

Usually not by itself. A normal browser chat session is different from an MCP-capable client session that can generate and use WebMCP tokens.

What is the fastest proof that the setup works?

Connect the widget, then ask your MCP client to list the BusinessCalcs tools or open a specific calculator page. If those tools appear, the connection is live.