AI Retrievability by Norg hosting

Choose where your AI Retrievability by Norg is hosted

Let NORG host the mirror for you, or run it on your own Cloudflare account so AI agents get it at your own web address. Same plan, same trial, and you can change your mind either way.

The two options

Your AI Retrievability by Norg can live in one of two places. Both publish the same AI-readable copy of your homepage; the difference is whose Cloudflare account serves it, and therefore which web address AI agents see it at.

NORG-hosted

Sitemap Mirrordefault
What it means
By default, Norg hosts an AI-optimised mirror of your site — nothing else to set up. It is served at {your-slug}.agentic.norg.ai from NORG's own Cloudflare account. Nothing is installed on your website, you do not need a Cloudflare account, and your DNS is not changed.
Who it suits
A business that wants the result without involving anyone technical. Most customers stay here.
How to choose it
Do nothing — it is the default. If you would rather be explicit, tell Claude “NORG-hosted” when it asks for your business details.

Self-hosted

Own CDN
What it means
A small Cloudflare Worker installed on your own Cloudflare zone, so AI agents get the mirror at your own web address — the same URLs your customers use. Humans and search engines keep getting your origin site, unchanged.
Who it suits
A business that wants AI assistants to cite its own domain, and has (or can get) Cloudflare in front of its site.
How to choose it
Tell Claude “self-hosted” when it asks for your business details, or switch later with switch_hosting. Then pick one of the three install routes below.

Two rules the self-hosted worker always follows

  • It must never break your site. Every failure path — NORG unreachable, a bug in the worker, a bad key — falls back to your origin, so the worst case is that a visitor sees your normal site.
  • Search engines always see exactly what humans see. Only AI agents are served the mirror. Googlebot, Bingbot and every other web-index crawler get your origin, byte for byte.

Neither rule has an off switch.

Trial and pricing

Both options are the same $99 per month plan with the same 30-day free trial. There is no extra NORG charge for either, and choosing one does not lock you out of the other — you can switch at any time during the trial.

The one cost that is not NORG's: if you self-host and move your Cloudflare account to the Workers Paid plan (see why you might), Cloudflare bills you for that directly.

What you need

For NORG-hosted
Nothing beyond the setup you have already done in Claude. No Cloudflare account, no DNS change, nothing installed on your site.
For self-hosted
A Cloudflare account with your website on it, proxied (the orange cloud) so Cloudflare actually sits in front of your traffic. Then one of the three routes below — the first needs only your Cloudflare login; the other two need a scoped API token.
A live mirror
Self-hosting is offered once your mirror has been published. If you ask before then, Claude will tell you to check the setup status and try again.

Route 1: the Deploy-to-Cloudflare button

The no-credential route. You never give NORG a Cloudflare token; Cloudflare does the deploy from a public repository (https://github.com/norgai/norg-edge-mirror-cloudflare-deploy) straight into your own account. Six steps, one of them manual.

1

Ask Claude for the link

Call switch_hosting with self_hosted. The reply gives you the Deploy button link, a SITE_ID, and a one-time NORG_SITE_KEY. Copy the key somewhere safe now — it is not shown again. Nothing changes on your site or your mirror until the worker is actually running.

2

Click the button

The link is https://deploy.workers.cloudflare.com/?url=https://github.com/norgai/norg-edge-mirror-cloudflare-deploy. Cloudflare forks the public repo into your own GitHub or GitLab and deploys the worker into your Cloudflare account. NORG never receives any Cloudflare credential — the button does not give NORG access to anything.

3

Set SITE_ID

When Cloudflare prompts for variables, set SITE_ID to the value Claude gave you. It is not secret — it only tells NORG which mirror is asking.

4

Set NORG_SITE_KEY as an encrypted variable

Set NORG_SITE_KEY to the key from step 1, and mark it encrypted (a secret) — never a plain-text variable. This is the one credential in the whole install, and it only lets the worker talk to NORG about your mirror.

5

Add the route — the one step the button does not do

The button deploys the worker but does not attach it to your traffic. In Cloudflare go to Workers & Pages → norg-edge-router → Settings → Domains & Routes and add the route your-domain.com/*. Use the exact host your site lives on — if visitors use www.example.com, the route is www.example.com/*, because routes are host-exact.

6

Verify

curl -s -H "x-norg-edge-check: <your site key>" https://your-domain.com/

Use the NORG_SITE_KEY from step 1. A JSON reply means the worker is on the route; your normal HTML page means the route is not attached yet. Do not test with a spoofed AI-agent User-Agent from your own machine — the worker verifies agents by their source IP, so that request is passed through to your site by design and is not a valid check.

NORG learns about the install from the worker itself. The worker checks in with NORG every 30 minutes, so NORG hears about it within about half an hour of the first deploy. Until then NORG keeps serving the mirror at your NORG address; after that, AI agents are served at your own domain.

NORG cannot push updates to a button install. The worker in your account is a fork NORG has no access to. Each check-in reports its version, and NORG will tell you when a newer one is available — but only you can redeploy it, by clicking the button again.

On the free Workers plan?

Cloudflare caps free Workers at 100,000 requests a day across your whole account. Past that, Cloudflare returns an error for every request on the route — humans included — until the day resets. Move to Workers Paid (see the plan guide) before routing a busy site.

Need to stop the worker in a hurry? Set the variable EDGE_DISABLED=true in Cloudflare. It stops instantly without removing anything.

Route 2: a Cloudflare API token, through Claude

Create a scoped Cloudflare API token and give it to Claude by calling install_with_cloudflare_token. NORG deploys the worker into your account, creates the route, verifies the install, and keeps pushing worker updates to you from then on. The permissions the token needs are listed on the Cloudflare Worker install guide; the token is stored encrypted and is never shown again.

If your account is on the free Workers plan, or your zone blocks AI bots, Claude will read you a warning first and ask you to confirm before anything is installed.

Be aware: the token is visible in the chat.

Anything you paste into a Claude conversation stays in that conversation. Once Claude confirms the install is live, rotate or revoke the token in Cloudflare.

The honest consequence: revoking it means NORG's stored copy stops working, so automatic worker updates stop and your install behaves like a Deploy-button one. To keep updates, issue a replacement token through the dashboard route below instead of through the chat.

Route 3: the dashboard, with nothing in the chat

Sign in to the NORG app, open Publishing → CDN & Edge (/publishing/cdn-edge) and paste the same scoped token into the browser form. Nothing enters the Claude conversation. You get the same result as Route 2 — NORG deploys, verifies and keeps the worker updated — without the token ever appearing in a chat transcript.

Switching between the two

You can switch at any time during the trial, in either direction, by asking Claude — it uses switch_hosting. Neither direction touches your own website; the only thing that moves is where AI agents are served the mirror from.

NORG-hosted to self-hosted
Ask Claude to call switch_hosting with self_hosted. You get the Deploy button details straight away, or you can use the token or dashboard routes instead. NORG keeps serving the mirror at your NORG address until your worker reports in, so there is no gap.
Self-hosted (token install) back to NORG-hosted
Ask Claude to call switch_hosting with norg_hosted. Because NORG holds a working token, it removes the worker and the route from your zone itself, then serves the mirror at your NORG address again. Your site is unaffected throughout.
Self-hosted (button install) back to NORG-hosted
The same call. NORG has no access to your account, so it invalidates the site key instead — from that moment the worker safely serves your origin only. You then remove the route in Cloudflare yourself, or set EDGE_DISABLED=true. Either way your site is unaffected.
You lost the site key
Call switch_hosting with self_hosted again. That issues a fresh key and retires the old one; if the worker is already deployed, update its NORG_SITE_KEY secret to the new value or it will serve origin only.
You asked to self-host but never deployed
Nothing changes. Your mirror stays NORG-hosted and keeps refreshing. After 7 days the unused key is retired; if you come back to it later, ask for a fresh one the same way.

What leaves your Cloudflare account

When you self-host, the worker runs in your account and sends NORG exactly three things per request, so NORG knows what to render next and can report visit analytics to you:

  • your SITE_ID, so NORG knows which mirror is asking;
  • the classified visitor type — the AI bot's name, or “human”;
  • the path that was requested.

The full page content of your own site is never sent by the worker, and the worker's request logs stay in your Cloudflare account. NORG never receives a Cloudflare credential from a Deploy-button install; a token you provide through Route 2 or 3 is stored encrypted and used only to deploy, update or remove the worker.

Questions and answers

Choosing

Which option should I pick?

If you are not sure, stay NORG-hosted. It is the default, it needs nothing from you, and you can switch to self-hosted at any point in the trial once you have seen the mirror. Self-hosting is worth it when you specifically want AI assistants to cite your own domain.

Does self-hosting cost more?

Not from NORG — the plan and the trial are identical. Cloudflare may bill you if you move to Workers Paid, which is only necessary for busy sites that would exceed the free plan's daily request cap.

Can I switch after the trial ends?

Yes. Switching works the same way on a paid plan as it does during the trial — ask Claude to switch hosting at any time. If you get stuck, email solutions@norg.ai and we will sort it out with you.

The self-hosted install

Will the worker break my website?

It is built not to. Every failure path — NORG down, a wrong key, a bug — ends at your origin, so visitors see your normal site. And search engines are always served exactly what humans get; that rule has no off switch.

I clicked the button but the curl check returns my normal page.

Almost always the route. The button deploys the worker but does not attach it to traffic — add your-host/* under Domains & Routes, using the exact host your visitors use (with or without www). Also check the record is proxied (orange cloud); a DNS-only record never reaches the worker. And make sure the check sends the x-norg-edge-check header with your site key — a spoofed AI-agent User-Agent is passed through on purpose.

Why can NORG update a token install but not a button install?

A token gives NORG permission to upload a new worker version into your account; the button gives NORG nothing. With a button install NORG can see from the worker's check-in that it is behind and will tell you, but only you can redeploy it.

Should I really revoke the token after a chat install?

If you care about the token having been visible in the conversation, yes — and know that revoking it stops automatic worker updates. The clean alternative is to issue the token through the dashboard route in the first place, so it never enters a chat.

Data

What does NORG see from my Cloudflare account when I self-host?

Per request: your site id, the classified visitor type (which AI bot, or “human”), and the requested path. Never the page content of your own site, and never your worker logs — those stay in your account.

Where is the token stored if I give NORG one?

Encrypted, in NORG's database, and used only to deploy, update or remove the worker on your zone. It is never shown again, not even to you, and you can revoke it in Cloudflare at any time.

Support

A self-hosted install that will not verify, a switch that did not go through, or just unsure which option suits you? Write to solutions@norg.ai and include:

  • your business name and homepage address
  • which hosting option you are on, or trying to reach
  • for an install problem, the output of the verification command above