# Quickstart

The shortest path from a new agent session to the first ads: connect, sign in, verify, set up the brand, then ask.

## Connect

Follow the section for your host in Installation (https://makedovey.com/docs/installation). A person can start it from their own agent with this prompt:

Prompt: `Read https://makedovey.com/docs/installation and help me set up Dovey.`

## Sign in

The first Dovey tool call opens Dovey's sign-in in the person's browser. A new email makes a new account on the Free plan: limited usage each week, no card. Work email or Google; a free mailbox (Gmail, Outlook) signs in with Google. They approve the connection on the page that follows.

Never ask for a password, a key or a token in the chat.

## Verify

1. Call `get_me`. It is read-only. A result with a `user` and an `org` proves the sign-in worked. A config entry, a server listed, a sign-in page that opened or a tool list alone does not.
2. In a host with MCP Apps, cards appear on the first research or make. If they do not, say the tools work and the cards do not show in this app.
3. Do not make anything, run anything that uses the plan's usage, or change the brand to test the connection.
4. If the tools are missing, the person may need to switch Dovey on in the chat or reload the client. For a sign-in error, sign in again. If a new session is still needed, say what is connected and what is not verified yet. Do not report success before step 1 passes.

Once it passes, say Dovey is connected, with the plan and this month's usage from `get_me`.

## Set up the brand

If `get_me` says any part of `setup` is false, follow Set up the brand (https://makedovey.com/docs/set-up-the-brand) before the first ad.

## First things to ask

Once Dovey is connected and the brand is set up, make nothing yet. Ask the person which they'd like, with these two options:

1. "Tell me what ads you want to make (a goal, a season, a product, an idea)."
2. "See the ad templates you can use (a few kits with their links)."

1. They tell you what they want. Start from Dovey's templates. Call `find_templates` with their ask in their words. Copy the best 3 to 6 onto the canvas in the brand: `make_frames` with those `template_ids` and a `group_title` (with no canvas open, `create_canvas_from_templates` with the ids, the product photo and `run` true), then `get_job` with `wait` true for the ads' `design_ids`. Tailor each to the ask by its `tailor` line with `batch_edit` and `set_text`: the headline and copy for their request, their own words and numbers as they gave them. Look at each with `screenshot_frame` and fix it. Design from scratch only when `find_templates` says weak or they gave their own specific creative direction.
2. They want to see the templates. Call `list_workflow_templates` and show four to six kits, each with a line on what it makes and its page, `https://makedovey.com/ad-templates/{slug}`. When they pick one, make it (see "Make a Dovey template").

Any number, price, offer or claim the person gives goes on the ads as they said it. Free has limited usage each week, so start with a few ads. Every ad lands on a Dovey canvas the person can open and edit; Dovey returns its link.