---
title: "Connect your agent"
description: "Connect Claude, ChatGPT, Cursor, VS Code, Codex, or scripts to your Grid82 suite using OAuth setup prompts or personal API keys."
canonical: "https://grid82.com/docs/use/connect-your-agent"
updated: "2026-11-20"
---

# Connect your agent

You can connect external AI clients and terminal tools directly to your Grid82 suite so they read and update data on your behalf, limited strictly to your own permissions.

Open the app menu in the top-left corner and choose **Connect your agent** (also reachable via **Settings** -> **Connections**).

![Runtime Connect your agent dialog highlighting Copy setup prompt button in red](/docs/images/app/runtime-settings-connections.webp)

_The Connect your agent dialog with Copy setup prompt highlighted in red and developer key options below_

## One-prompt OAuth setup (recommended)

1. Click **Copy setup prompt** (highlighted in red).
2. Paste the copied prompt into Claude, Claude Code, ChatGPT, Cursor, VS Code, or Codex.
3. Your agent reads your suite's public setup instructions (`https://{suite}.grid82.app/agent-setup.md`), installs the `@grid82/cli` or adds your suite's MCP server (`https://{suite}.grid82.app/mcp`), and asks you to sign in.
4. On the browser consent page, **tick only the apps of the suite you want this agent to reach** and approve.
5. The agent verifies access with a read-only check (`apps_list`, `me_get`) without altering any records.

> **Info: No secrets pasted into chat**
>
> MCP clients authenticate using OAuth 2.1 with PKCE in your browser. Never paste an API key or password into a hosted AI chat window.

## Managing personal API keys and active connections

- **For developers (API keys).** Expand the **For developers** section (or open **Settings** -> **Connections**) to mint a personal `g82_` API key scoped to a single app (`records:read`, `records:write`, `schema:read`, `pages:read`, `pages:write`, `members:read`). Copy it immediately, as keys are shown once and expire after 90 days.
- **Revoking access.** Active OAuth grants and personal keys appear in **Connections**. Revoke any entry at any time to terminate its access immediately.

Read [Set up your agent](/docs/developers/agents/setup) for step-by-step manual setup instructions per client.
