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

# AI Platforms

# How do I connect Marrow to AI platforms?

AI Platforms lets your AI tools use the store and ad data Marrow has already synced. Connect once, then ask questions or run Skills from Codex, Claude, ChatGPT, Cursor, and other supported clients.

* **Access**: AI Hub → AI Platforms
* **Purpose**: Choose a connection method and keep sessions or keys healthy

Before you connect an AI platform, make sure at least one data source is authorized in [Integrations](./Integrations.md) and syncing in [Data Explorer](./Data%20Explorer.md).

## Which connection method should I use?

| Method                                    | Best for                                                                      | How it works                                                             |
| ----------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Quick connection: OAuth** (recommended) | Codex, Claude, and other OAuth-supported clients                              | Click Connect, authorize in the AI platform, done                        |
| **Standard connection: MCP**              | ChatGPT, Cursor, Gemini CLI, Hermes Agent, Claude Code, and other MCP clients | Paste the Marrow MCP server URL (and key when required) into your client |

If you already connected a platform via OAuth, you do **not** need to connect the same platform again via MCP.

## Quick connection: OAuth

1. Open **AI Platforms**.
2. Under **Quick connection: OAuth**, select the platform (for example Codex or Claude).
3. Click **Connect** and complete the authorization steps in the AI platform.
4. When finished, an entry appears under **OAuth sessions**.

OAuth sessions list the platform, user, and created time. You can revoke a session at any time.

Marrow only requests **read-only** access and never posts on your behalf.

## Standard connection: MCP

MCP (Model Context Protocol) uses one server URL for every MCP-compatible client.

1. Copy the **MCP server URL** from the AI Platforms page.
2. Paste it where your AI client asks for a custom MCP endpoint.
3. For headless clients (CLI agents or scripts), create an **MCP key**:
   * Click **New key**, name it, and create.
   * Copy the full key immediately — it is shown only once.
   * Rotate or revoke keys anytime from the keys table.

Platform-specific setup steps (Codex, Claude, Claude Code, ChatGPT, Cursor, Hermes Agent, Gemini CLI) are covered in the **MCP** section of the docs. Use those guides after you have the URL (and key, if needed).

## Security

* Marrow exposes **read-only** access to your synced data.
* Marrow does not change campaigns, listings, budgets, or settings in your commerce or ad platforms.
* Treat MCP keys like passwords. Store them securely and rotate if a client is compromised or retired.

## Related

* Install ready-made analyses: [Skills](./Skills.md)
* Confirm data is ready: [Data Explorer](./Data%20Explorer.md)
* Connect data sources: [Integrations](./Integrations.md)
* Feature overview: [Features](./Features.md)