# API 密钥与 AI 助手 (MCP)

Postbird 的构建旨在让 AI 助手或您自己的工具能够进行发布。Claude、ChatGPT、Claude Code、Cursor、n8n、Make 或您自己的脚本都可以为您的品牌规划并发布帖子。所有内容都在 **API 和 MCP** 选项卡中。

::: master-only
<figure><img src="../.gitbook/assets/v2-postbird-api.png" alt="API 和 MCP 页面：通过 MCP 地址连接 AI 助手，为 Claude、ChatGPT、Claude Code、Cursor、n8n、Make 和脚本设置选项卡（带有编号步骤），下方是 API 密钥部分"><figcaption><p>API 和 MCP：AI 助手的地址、每个助手的分步设置以及您的 API 密钥。</p></figcaption></figure>
:::

## 连接 AI 助手

MCP 是 AI 助手接入工具的方式。地址为：

```
https://mcp.postbird.ai/mcp
```

- **Claude**（网页版或桌面版）：设置 (Settings)，连接器 (Connectors)，**添加自定义连接器 (Add custom connector)**，将其命名为 Postbird 并粘贴地址。点击 **添加 (Add)**，然后点击 **连接 (Connect)**，并批准登录。
- **ChatGPT**：设置 (Settings)，连接器 (Connectors)（或应用 Apps），**创建 (Create)**，将其命名为 Postbird，粘贴地址并选择 OAuth 作为登录方式。保存、连接并批准。
- **Claude Code** 和 **Cursor**：粘贴带有 API 密钥（见下方）的地址。每个选项卡都会显示具体步骤。

连接后，助手可以列出您的品牌和渠道、起草、安排和发布帖子、从链接添加图片、读取日历和发布日志，并一次性导入多个帖子（您可以先检查它们，导入它们，并在需要时撤销导入）。只需向它提问，例如“为 Sunrise Dental 的每个渠道安排一篇关于我们春季菜单的帖子，时间定在周五 10:00”。它还可以针对每个网络建议标签、保存您的标签组、利用 AI 将图片制作成品牌的媒体资源，以及在 [收件箱](inbox.md) 中阅读并回复您的帖子评论：在网络允许的情况下进行回复、点赞、隐藏或删除，将对话标记为已完成并建议回复。通过助手请求的 AI 草稿、标签建议、AI 图片和建议回复的费用与应用内相同（[使用 AI 写作和标签](ai-drafts.md)）。

## API 密钥

密钥允许工具在无需您密码的情况下以您的身份在您的品牌上进行操作。

1. 在 **API 密钥 (API keys)** 下，为密钥命名（例如“我笔记本电脑上的 Claude Code”）。
2. 如果该工具仅应查看品牌、频道、帖子和日历，而无需创建、更改或发布任何内容，请勾选 **只读 (Read only)**。
3. 点击 **创建密钥 (Create key)** 并立即复制。密钥以 `pb_live_` 开头。出于安全考虑，它仅显示一次；如果您丢失了它，请撤销并创建一个新的。

为每个工具创建一个密钥，这样您以后可以通过 **撤销 (Revoke)** 关闭单个工具。任何持有密钥的人都可以代表您的品牌发布内容，因此请像对待密码一样对待它。

由团队成员创建的密钥将使用该成员的角色和品牌权限，如果其角色发生变更或离开团队，密钥也会随之调整。只有您和管理员可以创建密钥。请参阅 [团队角色](team-roles.md)。

## 普通 Web 请求 (n8n, Make, 脚本)

每个助手操作也是一个普通的 Web 请求。在 `X-API-Key` 标头中发送您的密钥。n8n、Make、脚本选项卡上的 **API 描述 (API description)** 链接是每个请求的标准描述，n8n 和 Make 可以直接导入。