> ## 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 平台

> 通过 OAuth 或 MCP 将 Marrow 数据连接到 AI 客户端。

# 如何将 Marrow 连接到 AI 平台？

**AI 平台**让您的 AI 工具使用 Marrow 已同步的店铺和广告数据。完成一次连接后，即可从 Codex、Claude、ChatGPT、Cursor 等受支持客户端提问或运行 Skills。

* **入口**：AI Hub → AI Platforms
* **用途**：选择连接方式，并维护会话或密钥状态

连接前，请确认至少一个数据源已在[集成](./integrations)中授权，并且正在[数据浏览器](./data-explorer)中同步。

## 应选择哪种连接方式？

| 方式                 | 最适合                                                          | 使用方法                                |
| ------------------ | ------------------------------------------------------------ | ----------------------------------- |
| **快速连接：OAuth**（推荐） | Codex、Claude 及其他支持 OAuth 的客户端                                | 点击 Connect，在 AI 平台完成授权即可            |
| **标准连接：MCP**       | ChatGPT、Cursor、Gemini CLI、Hermes Agent、Claude Code 等 MCP 客户端 | 在客户端中粘贴 Marrow MCP 服务器 URL（必要时附加密钥） |

已通过 OAuth 连接的平台，无需再以 MCP 方式重复连接。

## 快速连接：OAuth

1. 打开 **AI Platforms**；
2. 在 **Quick connection: OAuth** 下选择平台，例如 Codex 或 Claude；
3. 点击 **Connect**，并在 AI 平台完成授权；
4. 完成后，系统会在 **OAuth sessions** 中显示会话记录。

OAuth 会话会列出平台、用户和创建时间，您可随时撤销会话。Marrow 只请求**只读**权限，绝不会代表您发布内容。

## 标准连接：MCP

MCP（Model Context Protocol，模型上下文协议）使用同一个服务器 URL 为所有兼容客户端提供连接。

1. 在 AI Platforms 页面复制 **MCP server URL**；
2. 将其粘贴到 AI 客户端要求填写自定义 MCP 端点的位置；
3. 对于命令行 Agent 或脚本等无界面客户端，创建 **MCP key**：点击 **New key**，命名并创建后立即复制完整密钥。完整密钥仅显示一次；您可在密钥表中随时轮换或撤销。

各平台的具体设置请参阅[ MCP ](../mcp/mcp)部分的使用指南。

## 安全性

* Marrow 仅以**只读**方式暴露已同步数据；
* 不会修改广告活动、Listing、预算或电商/广告平台设置；
* 请像保管密码一样保管 MCP 密钥；如客户端被弃用或疑似泄露，请立即轮换密钥。