# The Attune plugin

The Attune plugin gives your assistant everything it needs to run surveys and interviews with
Attune: the [Attune MCP server](/mcp/) preconfigured, plus Attune's research skills. The first
skill is **Attune Guide Builder**, which turns one sentence about what you want to learn into a
saved draft study.

You do not configure an endpoint. The plugin already points at `https://mcp.tryattune.ai/mcp`.

**What you need**

An active Attune workspace (sign up at [tryattune.ai](https://tryattune.ai)) and editor or
administrator permissions in your Attune organization.

## Install

### ChatGPT

1. Open [Attune in the ChatGPT plugin directory](https://chatgpt.com/plugins/plugin_asdk_app_6ac671519b908191b02b53ea4e9cbf88),
   or search for "Attune" in ChatGPT's plugin directory.

2. Click **Install plugin**.

3. Sign in to Attune and approve the requested scopes (see [Sign in](#sign-in)).

**ChatGPT Business, Enterprise, and Edu**

Your workspace admin may need to allow Attune in the workspace's plugin settings before you can
install it.

### Codex

ChatGPT and Codex share one plugin directory, so the same Attune plugin installs in Codex.

1. Open the plugin directory: run `codex` and enter `/plugins` in the Codex CLI, or open the
   **Plugins** tab in the ChatGPT desktop app.

2. Find **Attune** and install it.

3. Start a new session, then sign in to Attune on the first tool call (see [Sign in](#sign-in)).

The Codex IDE extension does not support plugins. To use Attune there,
[connect the MCP server](/mcp/#codex) directly.

### Claude Code

1. Add the Attune marketplace and install the plugin:

   ```
   /plugin marketplace add Clozd/attune
   /plugin install attune@attune
   ```

2. Claude opens Attune's secure login flow. Sign in and approve the requested scopes (see
   [Sign in](#sign-in)).

### The Claude apps

Install "Attune" from your organization's plugin directory if your administrator has made it
available, then complete the same login flow.

**Coming soon**

Attune's public plugin listing and a public plugin repository are on their way. Until they land,
install from the marketplace command above, or ask your administrator to make the plugin
available to your organization.

## Sign in

The first time the plugin calls Attune, your assistant opens Attune's sign-in page at
`login.tryattune.ai`. Sign in with your work email, then approve the requested scopes:

- `openid`: confirm who you are
- `email`: share your email address, so your organization can restrict access by domain
- `guides:read`: read your surveys, interview guides, and business context
- `guides:write`: create, edit, and publish them, and get participant links
- `responses:read`: read completed responses
- `offline_access`: stay connected without signing in again

Click **Authorize** and you return to your assistant with an active connection.

## Start building

Once connected, ask your assistant:

- *"Survey my customers about the changes to our brand messaging."*
- *"Help me interview users about why they stopped using our product."*
- *"Summarize what people said about pricing in my latest Attune study."*

Your assistant confirms your business context, gathers what you want to learn, asks clarifying
questions, and creates a draft study ready for refinement in the Attune studio. The full sequence is
described in [Attune skills for other agents](/mcp/skills/); the plugin ships the same skill.

## Troubleshooting

<details>
<summary>"Connection failed" or "401 Unauthorized"</summary>

- Check that your Attune credentials are valid.
- Ensure your Attune organization has MCP enabled (contact your administrator).
- Try reinstalling the plugin to pick up the latest configuration.

</details>

<details>
<summary>"OAuth window did not open"</summary>

- Check your browser's popup blocker and allow popups for your assistant and the Attune login page.
- Try disconnecting and reconnecting the plugin.

</details>

<details>
<summary>"I don't see the Attune plugin"</summary>

- In ChatGPT, a Business, Enterprise, or Edu workspace admin may have to allow Attune first.
- In Codex, use the CLI or the ChatGPT desktop app; the IDE extension has no plugin directory.
- In Claude Code, make sure the marketplace is added: `/plugin marketplace add Clozd/attune`.
- In the Claude apps, ask your administrator whether the plugin has been made available to your
  organization.
- Contact Attune support at [support@tryattune.ai](mailto:support@tryattune.ai).

</details>

## Security and privacy

- Your login credentials are handled by Attune's identity provider and are never shared with your
  assistant.
- The MCP connection is encrypted (HTTPS).
- All tool calls are scoped to your Attune organization.

## Support

For setup help, email [support@tryattune.ai](mailto:support@tryattune.ai). To connect an assistant
without the plugin, see [Connect Attune to your AI assistant](/mcp/).

---

ChatGPT and Codex are trademarks of OpenAI. Claude is a trademark of Anthropic, PBC. Attune is not
affiliated with OpenAI or Anthropic.