Shield · AI assistant

Install Shield with your AI assistant

Copy one prompt into Claude Code, Cursor, GitHub Copilot, Codex, Windsurf or ChatGPT. The assistant makes one small change and tests it; you review and deploy.

How it works

Open your site's Install page in the Shield dashboard and choose Let your AI assistant do it.
Copy the prompt, or use Open in Cursor, or the one-line claude '…' command for Claude Code. Give it to the assistant in your site's project.
The assistant detects the framework, picks one route (npm package or script tag), adds the public site key to your config, and stops.
It loads a page on your computer. Before the first real visit, a visit from localhost counts as a test visit: the Install page shows "Test visit received from your computer". Test visits are never stored.
Review the change, deploy it, and open your site once. The first real visit completes the install.

What the assistant gets

Your site's domain and its public site key (pub_...), which is in your page source anyway. Never the secret key (sec_...): the recipe tells the assistant not to add one and to ask you to put it in server configuration yourself if you want server verification.

Checking the install

The assistant checks its own work with the public install status. It shows only the install state, never visitor data.

https://shield.findip.net/v1/shield/install-status?site_key=pub_...

`waiting`	Nothing has arrived yet.
`test_visit`	A visit from your computer arrived: the SDK works. Deploy next.
`receiving`	Real visits arrive. Done.
`refused`	An event was refused; `message` says why and what to change.

Other ways to give the assistant the steps

The recipe: agent-install.md. Point any assistant at it: "Follow this to add FindIP Shield. Site key: pub_...".
FindIP MCP server: @findip/mcp has shield_install_recipe and shield_install_status, which need no API key. findip-mcp on GitHub.
Rules in your repository: a Claude Code skill and a Cursor rule, plus working examples for Next.js, React, Vue, Astro, SvelteKit and plain HTML: findip-shield-examples.

Prefer to do it yourself? See the Quickstart.