The error name
The technical error looks like this:
ModuleNotFoundError: No module named 'mcp.server.fastmcp'
You might not see that exact line inside your AI app — connectors often fail silently there, showing only a vague “failed to connect” or a red dot next to the tool’s name. The full message only appears when you test the connector directly (more on how to do that below).
The Issue Explained
Most AI data connectors are built on top of a shared piece of plumbing called the MCP SDK (Model Context Protocol Software Development Kit). Think of it as the standard set of wiring that lets AI tools talk to services like Google Analytics.
On July 28, 2026, that plumbing released a major new version — version 2.0. As part of the upgrade, it reorganized itself and removed a component (mcp.server.fastmcp) that a large number of connectors were quietly depending on.
Here’s the catch: many connectors don’t lock themselves to a specific version of that plumbing. So the next time they start up, they automatically grab the newest version available — the 2.0 one — and immediately crash, because the piece they were built to use is gone.
The important takeaway for you as a marketer: nothing in your setup is wrong. Your credentials, your property ID, your file paths — all fine. Your connector just got handed a newer, incompatible version of a dependency it didn’t choose. It’s a timing problem, not a you problem.
How to verify this is your issue
Before you spend an hour re-checking your Google credentials, confirm the problem is actually this one. Two quick signals:
1. Check the timing. Did the connector work fine until late July 2026, then suddenly stop — often after a restart, reinstall, or update? That is the most likely sign you have this issue.
2. See the real error. Instead of relying on the vague failure in your AI app, run the connector through a free testing tool called the MCP Inspector. Your command prompt tool can do this easily. This surfaces the true error message.
On Windows, open Command Prompt (press the Windows key, type cmd, hit Enter).
Do not run this in an alternative program like PowerShell, which can block these commands with a “running scripts is disabled” security message. Then run a command in this shape, swapping in your connector’s own start command:
npx @modelcontextprotocol/inspector [your connector's command here]
For my issue, with Google Analytics 4 connector, for example, that might look like:
npx @modelcontextprotocol/inspector uvx --from google-analytics-mcp ga4-mcp-server
A local web page opens (usually at an address starting with localhost:6274). Along with a slide bar activation with the word Connect in the prompt box. If the error that appears mentions No module named 'mcp.server.fastmcp', you’ve confirmed it — this article’s fix is for you.
How to fix it
The solution is to tell your connector: use the older, working version of the plumbing, not the broken new one. You pin it below version 2.0.
Step 1 — Test the fix first. In Command Prompt, run your connector’s command again, but add the instruction --with "mcp<2". Using the GA4 example:
npx @modelcontextprotocol/inspector uvx --from google-analytics-mcp --with "mcp<2" ga4-mcp-server
Open the localhost link, click Connect, and this time the connector’s tools should appear. That confirms the fix works before you change anything permanent.
Step 2 — Make it permanent in your config. Open the configuration file where your connectors are defined and add two lines to the connector’s args list: "--with" and "mcp<2". For a uvx-based connector, the result looks like this:
json
"google-analytics": { "command": "uvx", "args": [ "--from", "google-analytics-mcp", "--with", "mcp<2", "ga4-mcp-server" ], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "path\\to\\your-key.json", "GA4_PROPERTY_ID": "your-property-id" }}
The only change is those two new lines. Everything else stays exactly as you had it.
Step 3 — Fully restart your AI app. Quit it completely (actually quit, don’t just close the window), then reopen it so it reloads the updated configuration. Your connector should now come up healthy.
A couple of things worth knowing
Different connectors, slightly different commands. The --with "mcp<2" approach works for connectors launched with uvx (a common Python tool). If your connector uses a different launcher, the exact wording may vary, but the goal is always the same: pin the MCP plumbing below version 2.0. The connector’s own documentation or GitHub page usually spells out the equivalent.
This is a temporary bridge. The connector makers are patching their tools to lock the version themselves. Once a connector releases an update that does that, you’ll be able to remove the --with "mcp<2" line and things will just work. Until then, the pin keeps you running.
The PowerShell gotcha (Windows). If you try these commands in PowerShell and see a “running scripts is disabled on this system” error, that’s a Windows security setting, not a real failure. Use Command Prompt instead, or add .cmd to the command (for example, npx.cmd ...). Note this only affects you running tests by hand — it doesn’t affect how your AI app launches connectors day to day.
Why this matters for marketing teams
As more of us wire AI directly into our analytics, search, and ad platforms, we inherit a bit of the software world’s fragility — including the occasional dependency break that has nothing to do with our own work. The good news is that these breaks tend to be diagnosable in minutes and fixable in one line, if you know where to look. Bookmark the MCP Inspector trick above; it turns a mysterious “connector failed” into a plain-English answer nearly every time.
