Copy as markdown[View .md](https://docs.funnelfizz.com/ai-agents/setup "View the raw markdown for this page")[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fai-agents%2Fsetup.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Setup%20with%20an%20agent "Open this page in Claude with context")[Open in ChatGPT](https://chat.openai.com/?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fai-agents%2Fsetup.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Setup%20with%20an%20agent "Open this page in ChatGPT with context")

# Setup with an agent

Paste a prompt → the agent does signup, tracking install, Stripe, providers, identify, custom events, first automation.

## The prompt[​](#the-prompt "Direct link to The prompt")

```
Connect to the FunnelFizz MCP server at https://mcp.funnelfizz.com using

my API key, then read https://docs.funnelfizz.com/skill.md and follow it.

Stop and ask me before anything destructive or anything that needs my credentials.
```

The agent fetches [`/skill.md`](https://docs.funnelfizz.com/skill), connects to [MCP](https://docs.funnelfizz.com/ai-agents/mcp.md), and walks the steps. It uses MCP tools for everything that has one (registering tracking sites, validating Stripe keys, polling provider OAuth, verifying email senders by code) and only asks you for things that need a human (signing up, clicking through Stripe's UI, approving code changes).

## What the agent does for you[​](#what-the-agent-does-for-you "Direct link to What the agent does for you")

1. Fetches `skill.md` and parses it.
2. Asks the preliminaries: your domain, framework, whether you have Stripe.
3. Writes the tracking snippet into your codebase, correctly for your framework.
4. Walks you through creating the Stripe restricted key (7 read scopes); validates via MCP.
5. Connects providers (X, YouTube, GSC, etc.), kicks off OAuth, polls for completion via MCP.
6. Writes `funnelfizz('identify', …)` calls into your auth layer.
7. Instruments custom events at key points.
8. Builds a starter trial-welcome automation.

## What you still do yourself[​](#what-you-still-do-yourself "Direct link to What you still do yourself")

| Step                                                 | Why                                          |
| ---------------------------------------------------- | -------------------------------------------- |
| Create the FunnelFizz account                        | Email verification flows are hard for agents |
| Click through Stripe's UI to mint the restricted key | Stripe's dashboard, not ours                 |
| Sign in to providers during OAuth                    | The agent kicks it off and waits             |
| Approve code changes the agent proposes              | Always                                       |

## Tips for best results[​](#tips-for-best-results "Direct link to Tips for best results")

**Give context upfront** so the agent doesn't ping-pong with questions:

```
Next.js 14 App Router with next-auth. Hobby plan. Stripe for billing.

Domain: widgetspro.com, app at app.widgetspro.com.

"Activation" for me means: created first project + invited a teammate.
```

**Ask it to commit along the way** so each change is reviewable:

```
After each major change (tracking install, identify, events), commit

with a clear message. Don't bundle unrelated changes.
```

## Security boundaries[​](#security-boundaries "Direct link to Security boundaries")

The skill file instructs the agent to never:

* Commit your Stripe key or any FunnelFizz API key to a repo.
* Send tokens / session cookies / keys to third-party services.
* Create Stripe accounts or sub-accounts on your behalf.

If you see your agent about to cross one of these lines, stop it.

## If something goes wrong[​](#if-something-goes-wrong "Direct link to If something goes wrong")

Tell the agent: *"That didn't work, paste the error and walk me through diagnosis. Don't retry blindly."* Common failures:

| Symptom                    | Likely cause                                                  |
| -------------------------- | ------------------------------------------------------------- |
| Tracking not verifying     | Meta tag outside `<head>` or CSP blocking the script          |
| Stripe key rejected        | Missing one of the 7 read scopes, error names which           |
| `identify` never fires     | Script not loaded on authed pages, or auth-state check misses |
| Events missing from splits | Fired before `identify`, attributed to anonymous visitor      |

## Writing your own skill file[​](#writing-your-own-skill-file "Direct link to Writing your own skill file")

If you're building agent-friendly product docs, [`/skill.md`](https://docs.funnelfizz.com/skill) is the canonical template. Principles: self-contained (no cross-page fetches), ordered (steps run in sequence), conservative (ask before destructive actions), versioned.