← All articles

Stop Reading Docs. Talk to Your Agent Instead.

Joscha Meyer
Joscha Meyer

Picture this: you have a colleague who has read every page of the AWS documentation, every Kubernetes runbook, every internal knowledge base your tooling vendor ever published. He’s always at his desk, never in a meeting, and answers within seconds. He’s patient, thorough, and can cross-reference three different docs pages while simultaneously looking at your actual AWS account, your Wiz project findings, or whatever environment you’re working in. He does all of this without a single sigh.

The catch? Occasionally he confidently tells you about a configuration parameter that doesn’t exist. And sometimes, when you’ve spent ten minutes implementing his workaround, he goes: “Oh — wait, there’s actually a built-in feature for this. You can just use that.”

That colleague is your coding agent with a well-built provider MCP attached to it.

The Problem With Reading Docs

Let’s be honest about how documentation browsing actually goes. You open a browser tab, type something into the search bar, get twelve results that are either three years old or written for a completely different use case, and eventually find what you need buried in an FAQ section that nobody has touched since 2021. Twenty minutes later you have your answer and a slight sense of defeat.

Some services make this even worse by keeping documentation behind a login wall. Take Wiz, a cloud security platform with its own rich vocabulary of concepts and resource types — the docs never surface in Google search results, and without an account you simply can’t access them at all.

Enter the MCP

The Model Context Protocol (MCP) is an open standard that lets your coding agent connect to external tools and data sources — think of it as a plugin system for your AI assistant. An MCP server can expose anything: a database, an API, a file system, or yes, a documentation library. Your agent can then query these sources mid-conversation, in context, without you having to copy-paste anything.

A well-built provider MCP does more than just surface documentation — it also connects to your actual account or project. Your agent can look something up in the docs and immediately cross-reference it against what’s really in your environment. Without an MCP, it’s working from memory. With one, it’s working from memory, has the docs open, and can see your infrastructure.

The AWS Case: That One Config Parameter

AWS documentation is thorough. It is also enormous, and the answer you need might be in the main docs, the developer guide, the API reference, or — inevitably — some FAQ that exists independently of all the above.

With the AWS MCP Server, Claude finds the answer in a heartbeat — and because it also has access to your actual AWS account, it can verify the solution applies to your specific setup. What used to be fifteen minutes of tab archaeology followed by trial-and-error is now one conversation.

The Wiz Case: Docs Behind a Login Wall

Wiz keeps its documentation behind an account login, so Google is useless — the pages exist but don’t surface in search results. On top of that, Wiz has its own vocabulary, and if you’re new you don’t even know what to search for. You’re lost before you’ve started.

Charlie from It’s Always Sunny in Philadelphia pointing at a conspiracy board covered in notes and string

The Wiz MCP cuts through this entirely. It gives Claude access to both the Wiz documentation and your actual Wiz project — findings, resources, policies, the lot. Claude explained the concepts, looked at what was actually in the project, and guided me to a solution — no login, no knowledge base navigation, no vocabulary lookup required. I just asked.

The Honest Part

Here’s where the expert colleague analogy becomes uncomfortably accurate.

Sometimes Claude is a little ahead of the roadmap. A few times I found myself implementing a solution around a configuration parameter that, when I asked Claude to double-check, turned out not to exist yet. To its credit, it checks when asked and course-corrects immediately — and it won’t make the same mistake twice in that session. But you do have to remember to ask “does this parameter actually exist?” before you go too far down that path.

The other pattern: Claude sometimes suggests a manual solution and you have to be the one to ask “is there not already a feature for this?” At which point it goes — yes, actually, good point, here’s the built-in way. It’s a little like that colleague who occasionally over-engineers things and needs someone to remind him that the platform already solved this problem in version 2.3.

Neither of these is a dealbreaker. They’re the normal texture of working with a very capable but not infallible collaborator. The trick is to treat it like a conversation, not an oracle.

How to Set This Up

MCPs are configured in your Claude Code settings. The practical distinction worth knowing:

Global MCPs work well for read-only documentation servers that don’t require credentials. The AWS Documentation MCP Server is a good candidate here — it fetches public docs and you’ll want it available across all your projects.

Per-project MCPs make more sense for servers that require credentials or are specific to a particular client environment. The AWS MCP Server (which can query your actual AWS account) and the Wiz MCP fall into this category — you configure them in the project’s .claude/ directory alongside the relevant credentials.

The setup overhead is a one-time cost. Once it’s in place, you just ask questions.

The Bottom Line

A coding agent paired with good provider MCPs is genuinely the fastest way to work with complex platforms — whether the problem is hard-to-find documentation, login-walled knowledge bases, or simply understanding how something behaves in your account. It’s not perfect — no colleague is — but it’s patient, fast, and available at 4pm on a Friday when you’re stuck on one config parameter and really don’t want to open another browser tab.

Start with one MCP for the tool you reach for most. Notice how the workflow changes. Then add another.

And maybe, just maybe, keep a browser tab open for the cases where your expert colleague confidently describes a feature that hasn’t shipped yet.

About the author

Joscha Meyer
Joscha Meyer

Joscha is a Cloud Consultant at superluminar. After working as a software engineer at various start-ups, he continues to enjoy learning and sharing his knowledge and passion for Clojure, TypeScript, automation, and distributed systems. He left Twitter during lockdown and now prefers to talk to his neighbours.