How to Let AI Agents Search Your Documentation With MCP

The search box on your docs site is for a person sitting on that site. An agent in Claude or Cursor is not sitting there. It will answer anyway, from whatever it already knows, unless you give it a tool that searches your pages.

That tool is an MCP server with documentation search selected. The agent calls it with the question and gets passages and links. You can watch the call. You can open the link.

What the search tool is

Documentation search is one of the tools on the server. The agent sends the question. The server returns passages from the pages you indexed, each one linked to its URL. The agent does not crawl your site itself.

Indexing the site, and the test that search landed on a page you named in advance, is Make your documentation searchable by AI agents. Connecting the agent is this post. What a docs server is for is What is a docs MCP server?.

Why give the agent search

A page title is a check you can do in one click. Ask which page explains how a customer rotates an API key. You want the title and a link. A paraphrase with no source is not a search result.

Question answering can sit beside search. Search returns passages. Question answering returns a direct reply drawn from those passages. API reference lookup belongs when the docs are an API. The tool guide says what each one returns.

You can see that search was called. The free dashboard shows volume, which tool ran, and which source answered. It does not show the question text. That view is Core analytics, described in What the questions people ask your docs can tell you.

Make the server in MCP Studio

MCP Studio is the no-code builder on Appa Tools. Open the wizard. You do not write any code.

1. Name it for the docs. Help center search is obvious in the client's tool list.
2. Add the documentation URL. Start at /docs if the rest of the site is marketing. A website source is indexed up to 5,000 pages.
3. Select documentation search. Add question answering when you want a direct reply as well as passages.
4. Deploy. Wait until the source shows complete before you judge a miss.

Copy the URL from the setup page:

https://appatools.com/mcp-studio/api/mcp/your-server-name

Connect the client you actually use. Locations for Claude, Cursor, and Windsurf are in Connect to AI tools. Claude's click path is Give Claude access to your documentation.

Check that it works

Ask: "Which page explains how a customer rotates an API key?"

The reply should name the page and link it. Confirm the tool call in the client. Most chats show MCP activity beside the reply. That is the difference between your docs and a confident guess.

Then ask something the docs do not answer.

You: What is the office wifi password?

Assistant: Nothing in this server's content covers an office wifi password. The closest material is the key rotation guide, which is a different subject. You would need to add that document as a source.

Those misses are useful later. How to read them as a backlog is Find documentation gaps with MCP analytics.

If the reply is not what you expected

Change one thing, then ask the same question again. If there is no tool call, the client is not using the server. If the wrong page wins, the heading may not use the reader's words. People ask about rotating a key. A page titled "Credential lifecycle" can lose to a nearby page that happens to say "key." The edit is Make your documentation AI-ready.

Search is not a login bypass. Pages behind a login are not in a public crawl. Export them or connect a source the indexer is allowed to read, and use a private server if the material is internal. Search is also not a substitute for the repository when the answer is code. Add the repo as a second source. See Give an AI agent access to your GitHub repository.

Let an agent search your docs today

Let an agent search your docs today. Open MCP Studio, add the documentation URL, turn on search, and deploy. Ask for the key rotation page. A link you can open is the sign to keep the server.

Where to go next

• Choosing tools
• Make your documentation searchable by AI agents
• Give AI agents access to your product documentation
• Connect to AI tools