Scroll Sites

Connect AI Tools With MCP

Early Access: MCP access is available for a small group of sites first and for public sites only. To enable it for your site → Sign up for early access.

MCP access lets visitors connect your Scroll Sites help center to the AI tools they already work in, like Claude, ChatGPT, Cursor or VS Code. Their AI tool can then search your site and read your articles directly, so answers come from what you published, not from the model's training data.

Each site gets its own MCP endpoint. Access is read-only: AI tools can search, list and read published pages. They can't change anything.

What it's good for

  • Developers get answers from your docs inside Cursor, VS Code or Claude Code, without leaving their task.

  • Customers ask the AI tool they already use and get answers for their product version, instead of opening a support ticket.

  • Teams building their own assistant or agent use your published content as its source, with the model and behavior they choose.

Turn on MCP access for a site

  1. In Scroll Sites, open the site and go to Site settings › Search and AI.

  2. Under MCP access, turn on Let AI tools access your site.

  3. Save your changes. Scroll Sites updates the site. When the update is finished, the MCP endpoint is live.

  4. Copy the MCP endpoint URL with the copy button. Share it, or let visitors find it on any article (see below).

MCP access is off by default and is set per site. It's independent of the search experience you choose (Keyword search, AI search or AI assistant), and it doesn't use your OpenAI API key: the visitor's own AI tool does the reasoning.

Why is the toggle greyed out or marked inactive?

  • Greyed out: the site is protected or unpublished. Make it public to turn MCP access on.

  • On, but marked inactive: you turned on access protection after enabling MCP, or LLM-optimized content is off for this site. The setting is kept, so MCP starts working again once the site is public. If LLM-optimized content is off, contact K15t support.

Your MCP endpoint URL

The endpoint is your site URL plus /mcp: https://docs.example.com/mcp

  • Use the URL exactly as shown, with no trailing slash.

  • Opening the URL in a browser doesn't show anything useful. It's meant for AI tools.

How visitors find the endpoint

When MCP access is on, every article gets a Connect with MCP option in the Use with AI menu. With the AI assistant experience on, you'll find Use with AI next to the Ask AI button.

Clicking Connect with MCP copies the site's MCP endpoint URL, so visitors can paste it straight into their AI tool. When you turn MCP access off, the option disappears.

Internal alpha: the Use with AI button has been removed manually from the site UI for alpha testing, so visitors don't see Connect with MCP yet. To test, copy the endpoint from Site settings › Search and AI › MCP access and share it directly.

Connect your AI tool

Your AI tool needs the site's MCP endpoint URL. No sign-in or API key is needed. Pick your tool:

Works in Claude on the web, the Claude desktop app, and Cowork, on all plans. Free plans can add one custom connector.

Pro and Max

  1. Go to Customize > Connectors.

  2. Click + Add, then Add custom connector.

  3. Enter a name, for example the name of your help center, and paste the MCP endpoint URL. Click Continue.

  4. Review the detected settings and click Continue.

  5. Under Authentication, choose No sign in, then click Add.

Team and Enterprise

An owner adds the connector once for everyone: Organization settings > Connectors > Add > Custom > Web. Enter the name and URL, click Continue, review the detected settings, and click Continue again. Choose No sign in and click Add. Members then go to Customize > Connectors, find the connector (marked Custom), and click Connect.

ChatGPT connects to custom MCP servers in developer mode, on the web.

  1. Go to Settings › Apps › Advanced settings and turn on Developer mode.

  2. Click Create app.

  3. Enter a name and paste the MCP endpoint URL.

  4. Set Authentication to No authentication, confirm that you trust the app, and click Create.

  5. In a chat, add the app from the + menu.

On Business and Enterprise workspaces, an admin may need to allow developer mode first.

Run this in your terminal, using your own name and endpoint URL:

Bash
claude mcp add --transport http example-docs https://docs.example.com/mcp

Add --scope project to share the server with your team through the project's .mcp.json, or --scope user to use it in all your projects. Check the connection with /mcp inside Claude Code.

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

JSON
{
  "mcpServers": {
    "example-docs": {
      "url": "https://docs.example.com/mcp"
    }
  }
}

Then check that the server shows as enabled in Cursor's MCP settings.

Add the server to .vscode/mcp.json in your workspace, or run MCP: Add Server from the Command Palette:

JSON
{
  "servers": {
    "example-docs": {
      "type": "http",
      "url": "https://docs.example.com/mcp"
    }
  }
}

Then start the server from the MCP view.

Any MCP client that supports remote servers over Streamable HTTP can connect. Point it at the MCP endpoint URL and leave authentication empty.

The server answers with JSON and doesn't open an SSE stream. Clients that only support local (stdio) servers can connect through a bridge such as mcp-remote:

Bash
npx -y mcp-remote https://docs.example.com/mcp

What AI tools can do with your site

Capability

What it does

Search

Searches the site with the same index as your site search. The AI tool can narrow the search by content source, version, variant and language. If it doesn't, it searches the latest version and variant. Results include longer excerpts than the search on your site, so the AI tool can pick the right page.

List pages

Lists the site's pages, in batches.

Read a page

Returns a page's content as Markdown.

AI tools only get what visitors already see on your public site. Scroll Sites checks your site's visibility settings on every request, using the same configuration as the website itself. AI tools can't write, change or delete content, and nothing is stored between requests.

Try prompts like these once you're connected:

  • Using the Example Docs connector, how do I set up single sign-on? Link the pages you used.

  • Search the docs for version 3.0 and summarize what changed for admins.

  • I'm writing a config file in this project. Check the docs for the supported options before you suggest anything.

Usage limits

To keep your site fast and stop the endpoint from being used for bulk downloads, Scroll Sites limits how many MCP requests it accepts:

Limit

Applies to

1,000 requests per hour

Each IP address, per site

5,000 requests per hour

Each IP address, across all Scroll Sites sites

  • A request is rejected as soon as either limit is reached. The AI tool gets a "too many requests" error (HTTP 429) with standard rate-limit headers, so it knows when to try again.

  • Normal use stays well below these limits. Answering a question usually takes a search and a few page reads.

  • People who connect through the same company network or VPN can share one IP address, and with it the same limit.

Known limitations

  • Public sites only. Support for protected sites (token access and single sign-on) is planned.

  • Reading full pages depends on your AI tool. Some tools only use search results and don't open full pages yet.

  • Help Center theme only for the Connect with MCP option on articles. The endpoint itself works regardless of theme.


FAQ and troubleshooting

My AI tool can't connect, or says the server wasn't found
  • Check that the URL is exactly the one shown in Site settings › Search and AI, with no trailing slash.

  • Check that the site update has finished.

An inactive or disabled site answers with the same "not found" error as a URL that doesn't exist.

My AI tool says there were too many requests

The tool reached a usage limit. Wait a while and try again. If people on the same company network regularly hit the limit, contact K15t support.

I added the server, but nothing happens

Many AI tools only save the configuration when you add a server. They connect when you start a new chat, open the MCP panel or list the tools. Start a new conversation and ask a question about your docs.

Our site runs behind our own CDN or proxy

Your CDN or proxy must pass POST and OPTIONS requests to the MCP endpoint through to Scroll Sites and must not cache them.

Does MCP access work with "Hide site from search engines"?

Yes. The two settings are independent. Hiding a site from search engines only tells crawlers not to index it. It doesn't restrict access, and an AI tool connecting through MCP isn't a crawler.

Does MCP access cost anything or use our OpenAI API key?

No. With MCP, the visitor's own AI tool does the work.

How is MCP access different from LLM-optimized content (llms.txt)?

LLM-optimized content makes your site easy for AI tools to find and read on their own, for example when they crawl the web. MCP access gives a visitor's AI tool a live connection it queries on demand: it searches your site, lists pages and reads them, for the right version, variant and language. MCP access builds on LLM-optimized content, so both need to be on.

Do visitors need an account or API key?

No. MCP access works for public sites and needs no sign-in or API key. Protected sites aren't supported yet.

How do I turn MCP access off?

Turn off Let AI tools access your site and save. After the site update, the endpoint stops answering and Connect with MCP disappears from articles.


Last updated: