---
title: "Quickstart | Gazebo Docs"
description: "Connect your first service, create an agent, and retrieve a credential in five minutes."
url: "https://gazebohq.com/docs/quickstart"
---

This guide takes you from zero to retrieving a credential from Gazebo in about five minutes. We'll use Stripe as the example service.

## Prerequisites

- A Gazebo account ([sign up free](https://app.gazebohq.com/signup))
- A Stripe API key (from your [Stripe dashboard](https://dashboard.stripe.com/apikeys))
- An MCP-compatible AI tool (Cursor, Claude Code, or Windsurf) — or any HTTP client

---

## Step 1: Connect Stripe

1. Go to **Settings → Services** in the Gazebo dashboard
2. Click **Connect** next to Stripe
3. Paste your Stripe API key and click **Save**

Gazebo encrypts the key and stores it in the vault.

---

## Step 2: Create an agent

1. Go to **Agents** and click **New agent**
2. Give it a name — e.g. `cursor-dev`
3. Under **Access**, add Stripe with the methods your agent needs (e.g. `GET` for read-only)
4. Click **Create**

---

## Step 3: Copy the bearer token

After creation, Gazebo shows your agent's bearer token. Copy it — you won't be able to see it again. If you lose it, regenerate it from the agent settings page.

---

## Step 4: Configure your MCP client

Add Gazebo to your MCP config. For Cursor, add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "gazebo": {
      "url": "https://app.gazebohq.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}
```

Replace `<your-token>` with the token from Step 3.

---

## Step 5: Verify and retrieve

In Cursor (or your tool), call:

```
get_identity()
```

You should see your agent's name and the Stripe service in its access list.

Then retrieve the credential:

```
get_credential({ service: "stripe", method: "GET" })
```

Gazebo returns the plaintext Stripe API key. The agent can now use it to make Stripe API calls.

---

## What just happened

- Your agent identified itself with the bearer token
- Gazebo checked its access profile — Stripe `GET` is permitted
- Gazebo logged the access and returned the credential
- The entire interaction is visible in your audit log

---

## Next steps

- [Access profiles](/docs/access-profiles) — understand and refine what your agent can access
- [Get credential reference](/docs/mcp/get-credential) — full tool reference including error handling
- [Audit logs](/docs/audit-logs) — see your access history