内容
# ATRAY MCP
[](https://www.npmjs.com/package/@atray/mcp)
ATRAY 模型上下文协议（Model Context Protocol）服务器，用于 [ATRAY](https://atray.app) API。它允许 AI 助手（Claude, Claude Code, Cursor, 以及其他 MCP 客户端）以自然语言管理您的 ATRAY 活动、帖子和品牌资料。
> ATRAY 是一款 SaaS 平台，通过 AI 创建 Instagram 内容：您描述您的品牌，AI 生成帖子（图片、标题、标签），ATRAY 为您安排并发布这些帖子。
## 要求
- Node.js >= 18
- 一个 ATRAY 账户和 **API 密钥**。在 Studio 的 **设置 → API 密钥** (`https://studio.atray.app`) 下生成一个 API 密钥。密钥 (`atray_...`) 仅在创建时显示一次，因此请安全存储。
## 快速开始
### Claude Code (CLI)，一键操作
```bash
claude mcp add atray -e ATRAY_API_KEY=atray_您的密钥 -- npx -y @atray/mcp
```
### 手动配置（Claude Desktop，Cursor 等）
将以下内容添加到您的客户端的 MCP 配置中（在 Claude Desktop 中为 `claude_desktop_config.json`）：
```json
{
"mcpServers": {
"atray": {
"command": "npx",
"args": ["-y", "@atray/mcp"],
"env": { "ATRAY_API_KEY": "atray_您的密钥" }
}
}
}
```
重启客户端，ATRAY 工具即可使用。
## 环境变量
| 变量 | 是否必需 | 默认值 | 描述 |
|---|---|---|---|
| `ATRAY_API_KEY` | 是 | - | 您的 ATRAY API 密钥 (`atray_...`)。 |
| `ATRAY_API_URL` | 否 | `https://api.atray.app` | 覆盖 API 基本 URL（用于自托管 / 测试环境）。 |
## 工具
| 工具 | 功能 |
|---|---|
| `getBrandProfile` / `updateBrandProfile` | 查看和更新品牌资料。 |
| `listCampaigns` / `createCampaign` / `getCampaign` / `updateCampaign` | 管理活动。`createCampaign` 使用 AI 生成帖子（每个帖子消耗 1 个内容积分）。 |
| `listCampaignPosts` | 列出活动帖子。 |
| `listPosts` / `createPost` / `getPost` / `updatePost` | 管理帖子（文本和轮播）。 |
| `regeneratePostText` / `regeneratePostImage` | 使用 AI 重新生成标题或图片。 |
| `uploadPostVideo` | 上传视频（mp4/mov/webm，最高 120 MB）作为帖子媒体；发布到 Instagram 为 Reel。 |
| `listSocialConnections` | 列出已连接的社交账户（只读）以选择发布目标。 |
| `schedulePost` | 安排/发布帖子（省略 `scheduled_at` 以尽快发布）。 |
每个 AI 生成的帖子消耗您计划中的 1 个内容积分。创建活动需要完整的品牌资料。
> API 密钥在 Studio 中创建和管理（**设置 → API 密钥**），而非通过 API/MCP。
## API 参考
完整的交互式 REST 参考（Swagger）：<https://api.atray.app/docs/>
## 本地开发
```bash
git clone https://github.com/atray-app/mcp.git
cd mcp
npm install
ATRAY_API_KEY=atray_您的密钥 npm start
```
服务器通过 stdio 与 MCP 通信。
## 链接
- 网站：<https://atray.app>
- 文档：<https://atray.app/docs.html>
- 问题：<https://github.com/atray-app/mcp/issues>
## 许可证
MIT
