The Attune plugin

The Attune plugin gives your assistant everything it needs to run surveys and interviews with Attune: the Attune MCP server 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) and editor or administrator permissions in your Attune organization.

Install

ChatGPT

1. Open Attune in the ChatGPT plugin directory, 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).

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).

The Codex IDE extension does not support plugins. To use Attune there, connect the MCP server 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).

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; the plugin ships the same skill.

Troubleshooting

“Connection failed” or “401 Unauthorized”

• 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.

“OAuth window did not open”

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

“I don’t see the Attune plugin”

• 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.

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. To connect an assistant without the plugin, see Connect Attune to your AI assistant.

---

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