# Install FindIP Shield with your AI assistant

Let the AI coding assistant you already use add Shield to your site: Claude Code, Cursor, GitHub Copilot, Codex, Windsurf or ChatGPT. You copy one prompt, the assistant makes one small change and tests it, and you review and deploy.

## How it works

1. Open your site's **Install** page in the Shield dashboard (https://www.findip.net/shield) and choose **Let your AI assistant do it**.
2. Copy the prompt, or use **Open in Cursor**, or the one-line `claude '…'` command for Claude Code. Open the assistant in your site's project and give it the prompt.
3. The assistant follows the install recipe: it detects the framework, picks one route (npm package or script tag), adds the public site key to your config, and stops.
4. It runs the site on your computer and loads a page. Before your site's 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.
5. Review the change, deploy it, and open your site once. The first real visit completes the install.

## What the assistant gets

The prompt holds your site's domain and its **public** site key (`pub_...`), which is in your page source anyway. It never holds the secret key (`sec_...`). The recipe tells the assistant never 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. You can open it too:

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

| State | Meaning |
|---|---|
| `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. |

It shows only the install state, never visitor data.

## Other ways to give the assistant the steps

- **The recipe:** https://www.findip.net/docs/shield/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. See https://github.com/findip-net/findip-mcp.
- **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: https://github.com/findip-net/findip-shield-examples.

Prefer to do it yourself? See the [Quickstart](https://www.findip.net/docs/shield/quickstart.md).

---

Canonical page: https://www.findip.net/docs/shield/ai-assistant · Markdown: https://www.findip.net/docs/shield/ai-assistant.md · All Shield docs in one file: https://www.findip.net/llms-full.txt