Installation

Prerequisites

Before you connect, make sure you have:

An Attentive account.
An AI application that supports the Attentive connector/MCP, such as ChatGPT or Claude.
Access to the Attentive companies and features you want to work with. Available tools and actions depend on your connection, account access, and the features enabled for the selected company.

Claude

Connect Attentive through Claude on the web or in the desktop app:

Open Customize → Connectors.
Select Discover, search for Attentive, and open its connector page.

Select the “+” or select the listing and Connect to Claude.
Choose “Read Only” or “Read + Write” depending on your desired access.
Sign in to Attentive and review the requested access, then approve the connection.

Open a chat, select + → Connectors, and enable Attentive for the conversation.

Verify the connection by asking:

“Use the Attentive MCP to connect to [company name] and list all available tools.”

If you use Claude Team or Enterprise, an organization owner may need to enable the Attentive connector before you can connect your account.

ChatGPT/Codex

Connect Attentive through ChatGPT on the web or in the desktop app:

Open Plugins, search for Attentive, and open its listing.

Select the + button to install it.
When prompted to connect, sign in to Attentive, review the requested access, and approve the connection. You may see this prompt during installation or when you first use Attentive.
Start a new chat. Type @ and select Attentive. Verify the connection by asking to connect to your Attentive account and list all tools.

If you use a managed ChatGPT workspace, your administrator may need to enable Attentive before you can connect.

Claude Code CLI

Choose one of the following commands, depending on whether you need read-only or write access.

Read-only (recommended to start):

claude mcp add --transport http attentive-mcp --scope user "https://attentive-ui-mcp.attentivemobile.com/mcp"

With write actions enabled:

claude mcp add --transport http attentive-mcp --scope user "https://attentive-ui-mcp.attentivemobile.com/mcp?readOnly=false"

Codex CLI

Choose one of the following commands, depending on whether you need read-only or write access.

Read-only (recommended to start):

codex mcp add attentive-mcp --url "https://attentive-ui-mcp.attentivemobile.com/mcp"

With write actions enabled:

codex mcp add attentive-mcp --url "https://attentive-ui-mcp.attentivemobile.com/mcp?readOnly=false"

After adding the server, authenticate:

codex mcp login attentive-mcp

Microsoft Copilot Studio

To connect through Microsoft Copilot Studio:

Open or create an agent.
Open Tools, select Add, then select Model Context Protocol (MCP).
Enter a name and description, then paste the Attentive MCP URL as the server URL: https://attentive-ui-mcp.attentivemobile.com/mcp. Append ?readOnly=false for a write-enabled connection.
Select OAuth 2.0 with Dynamic discovery.
Create the connection and complete the Attentive login and authorization flow.

Once the Attentive tools appear, confirm the selected company and verify the connection with a read request.

Refer to Microsoft’s Copilot Studio documentation for additional setup and administration guidance.

Other MCP clients

Other clients may be compatible if they support remote MCP servers over Streamable HTTP with OAuth. Configure a new MCP server with:

URL: https://attentive-ui-mcp.attentivemobile.com/mcp. Append ?readOnly=false to enable writes.
Transport: Streamable HTTP
Authentication: OAuth. Complete the Attentive login and authorization flow when prompted.

Refer to your client’s documentation for where to add a custom or remote MCP server and its authentication requirements.

Authenticate and verify custom connections

Complete the Attentive login and authorization flow when prompted. Then verify the connection in your client:

Claude Code: Run /mcp and confirm a server named attentive-mcp appears.
Codex CLI: Run codex mcp list and confirm attentive-mcp appears.

Ask your AI application to confirm the selected company and list the available tools.

Configuration options

For custom MCP connections, you can configure access mode using the readOnly query parameter in the server URL.

Parameter	Values	Default	What it does
`readOnly`	`true`, `false`	`true`	When `true`, business-data write tools are unavailable. Set to `false` to allow write tools, subject to your account’s access and the features enabled for the selected company.

switch_company remains available in read-only sessions because it changes the selected company rather than marketing data.

Read-only mode can still return sensitive information, including subscriber contact information through available tools. It does not mean that all returned data is non-sensitive.

These settings are established when a session is created. After changing the URL, reconnect to start a new session with the updated settings.

Native Claude and ChatGPT connectors manage their connection configuration; these URL instructions apply only to custom MCP connections.