> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gooseworks.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Connect GooseWorks to Cursor with one click, the CLI, or a manual MCP config

Connect GooseWorks to **Cursor** so its agent can use your GooseWorks tools — files, chat history, automations, and the full [Ad Remixer](/ad-remixer/mcp) — right inside the editor, in your own account and billed to your own credits.

<Note>
  This is the **same** `gooseworks` MCP server documented in [MCP Servers](/concepts/mcp-servers) and [Ad Remixer MCP](/ad-remixer/mcp). Cursor supports both **OAuth** (sign in with GooseWorks — used by the one-click install) and a **`Bearer` token** (used by the CLI install). Either way it's the same server and the same account.
</Note>

## One-click install (recommended)

Click the button below on a machine with Cursor installed:

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=gooseworks&config=eyJ1cmwiOiJodHRwczovL21jcC5nb29zZXdvcmtzLmFpL21jcCJ9">
  <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add gooseworks MCP server to Cursor" height="32" />
</a>

<Steps>
  <Step title="Confirm the install">
    Cursor opens with an **Install MCP server** dialog pre-filled with the `gooseworks` server. Click **Install**.
  </Step>

  <Step title="Sign in with GooseWorks">
    In **Cursor Settings → MCP**, the `gooseworks` server shows **Needs authentication**. Click it to start the OAuth flow — sign in with the **same account** you use for GooseWorks and click **Allow**.
  </Step>

  <Step title="Confirm it's connected">
    Back in **Cursor Settings → MCP**, the server shows a green dot with its tool list. Ask the agent something like *"list my GooseWorks brands"* to test it.
  </Step>
</Steps>

## Install with the CLI

If you already use the [GooseWorks CLI](/concepts/cli), one command writes the MCP config (with a `Bearer` token) into Cursor for you:

```bash theme={null}
npx gooseworks install --cursor --mcp
```

Then fully quit and reopen Cursor so it re-reads the config.

## Manual configuration

Add the server to `~/.cursor/mcp.json` (global) or `<project>/.cursor/mcp.json` (per-project):

```json ~/.cursor/mcp.json theme={null}
{
  "mcpServers": {
    "gooseworks": {
      "url": "https://mcp.gooseworks.ai/mcp"
    }
  }
}
```

With no `headers`, Cursor prompts you to sign in over OAuth. To use a token instead, add your API key from [Settings](/settings/api-keys):

```json With a Bearer token theme={null}
{
  "mcpServers": {
    "gooseworks": {
      "url": "https://mcp.gooseworks.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

## What you can do

Once connected, Cursor's agent can, on your behalf and in your account:

* **Make, edit & analyze ads** — research a brand, remix templates into branded creatives, re-roll and edit them, and diagnose campaign performance. Generation runs through the same cloud workflow as the [web app](/ad-remixer/overview) — billed to your credits.
* **Work with your files, chat history & automations** — the standard [MCP Servers](/concepts/mcp-servers) tools.
* **Discover & load skills** — ask the agent to find and use any GooseWorks skill.

## Managing the connection

* **Tool approval** — by default Cursor asks before each MCP tool call and shows the arguments; you can allowlist tools you trust.
* **Disable / remove** — toggle or delete the server in **Cursor Settings → MCP** at any time.
* **Refresh tools** — after we ship new tools, use the refresh icon next to the server in **Cursor Settings → MCP**.

## Troubleshooting

* **Button does nothing** — your browser may be blocking the `cursor://` link; copy the manual config above instead.
* **Server shows red / no tools** — fully quit and reopen Cursor; then check the URL is exactly `https://mcp.gooseworks.ai/mcp`.
* **Sign-in loops** — make sure you're signing in with the account tied to your GooseWorks workspace, and that pop-ups aren't blocked.

## Other clients

* **Claude** (claude.ai and Cowork) — sign-in (OAuth); see [Claude](/connections/claude).
* **ChatGPT** — see [ChatGPT (web)](/connections/chatgpt-web) and [ChatGPT work](/connections/chatgpt-work).
* **Claude Code / Codex** — see [MCP Servers](/concepts/mcp-servers).