---
sidebar:
  order: 4
title: MCP
description: 将 AI 客户端连接到 Influence，管理账号、素材、审核、排期及可用的数据洞察。
---

根据任务选择端点。产品工具需要已获授权的 Influence 工作区；文档服务器只读取公开指南。

| 端点 | 用途 |
| --- | --- |
| `https://influence.so/api/mcp` | 通用产品连接，包括已启用的规划、图片和研究工具。 |
| `https://influence.so/api/mcp/claude` | Claude 连接。包括素材上传、草稿、审核、定时发布、规划和数据洞察；不含图片生成工具及 `search`/`fetch`。 |
| `https://docs.influence.so/mcp` | 搜索和阅读公开文档。无需产品账户；无法访问工作区数据或发布。 |

## 连接并发现工具 [#connect-and-discover]

使用客户端的 Influence OAuth 流程；如果客户端支持 Bearer 身份验证，也可使用限定权限的 API 密钥。[应用与自动化](https://influence.so/sign-in?next=%2Fapp%2Fsettings%2Faccount%23settings-developer)提供各客户端的设置方法。请将 API 密钥存放在客户端的机密环境中。

读取 `profileGet`，核对 Influence 邮箱和工作区（`nickname`），再读取 `connectionStatusGet`，查看权限范围及 AI 定时发布额度。AI 客户端自身的登录邮箱可能不同。授权时，请选择预期使用的 Influence 身份。

OAuth 续期需要明确同意授予 `offline_access`。新建 ChatGPT 自定义连接时，设置说明还会指定该基础权限范围（Base scope）。刷新工具不会增加权限，也不会升级旧连接的基础权限范围（Base scopes）。

使用 `tools/list` 和 [MCP 工具参考](/zh-Hans/developers/mcp-tools)。发现结果可能列出尚未获授权的工具；每次调用仍会检查权限。已启用功能和客户端支持情况会影响可用性。通用端点与 Claude 端点有所不同；下载了技能或插件，并不能证明已安装的客户端加载了其中的工具。

## 准备已完成创作的内容 [#prepare-finished-content]

1. 读取 `accountList`，再为每个选定账号读取 `integrationSchema`，了解必需设置与素材限制。使用指定的平台查询工具，查找图板、频道及类似目标位置。
2. 使用 `mediaImport`，传入 `url` 和可选的 `name`，导入可访问的 HTTPS 文件。真实的宿主文件使用独立的 `file` 对象，不得虚构文件 ID。本地文件请使用分片上传工具，或现有的 SDK/CLI 辅助工具。[素材限制与就绪要求](/zh-Hans/help/media)同样适用。
3. 对于1–10条已完成创作、准备定时发布的帖子，请使用 `campaignScheduleBatchReview`，为每项提供稳定的 `itemKey`、`draft` 和 `scheduledFor`。它会一起保存草稿与待审核内容，支持各目标分别设置文案和素材，最多50次投递。仅保存草稿或编辑时，使用 `campaignDraftSave`；`campaignReview` 为已保存的营销活动准备预期操作。
4. 展示完整的已保存审核内容。已展示且加载完成的卡片可以承担这一步；没有卡片时，请展示精确的账号、文案、素材预览或链接、设置、定时发布时间及时区。如果审核内容缺失、过时或不确定，请读取 `campaignReviewGet`。
5. 执行前，取得新的明确人工批准。受支持的卡片带有自己的批准按钮。对于符合条件的社交帖子，可通过 `campaignReviewExecute` 或 `campaignScheduleBatchExecute` 提交聊天中的批准。模型不得调用私有的 `campaignReviewApprove` 界面操作。

TikTok Direct 支持纯聊天流程。先读取 `tiktokCreatorInfoGet`，再用1组问题合并询问尚未确定的可见范围、互动、推广，以及适用的 AI/音乐选项。展示适用的同意文案与链接，不得推断同意，也不得启用受限制的互动。使用 `campaignReview` 保存用户的完整选择，提供 `reviewId`，以及含 `connectionId` 和 `settings` 的 `tiktokSettings` 条目。返回的是新的待审核内容，不是批准。请展示该次精确的审核内容，并等待新的明确批准后再执行。受支持的审核卡片仍为可选。TikTok 收件箱发帖需要在 TikTok 中完成。

TikTok 同意属于某次精确审核；草稿中保存的同意不能完成这一步。保存审核选择会创建新的草稿版本，使之前的审核过时，即使设置没有变化也如此。

## 确认与恢复 [#confirmation-and-recovery]

对于标记为需要确认的工具，先在不提供 `_confirmationCapability` 或 `_idempotencyKey` 的情况下准备。确认时，使用相同的业务输入、返回的确认凭据，以及调用方生成的稳定幂等键。这一交互会保存或执行该工具声明的操作，与人工批准发布是不同步骤。请遵守宿主的权限提示。

`mediaUploadPart`、`mediaUploadComplete` 和 `mediaUploadAbort` 直接继续已获授权的上传。请将文件字节传至返回的存储 URL，不要放入工具 JSON。中断后，读取上传状态，并使用同一文件和 `clientKey` 继续。

上传的 `expiresAt` 是当前传输或处理的截止时间：最初为24小时，完成上传并开始处理后变为15分钟。就绪素材不会随此截止时间过期；可继续从素材库复用其 `assetId`。

结果不确定时，请保留确认值与重试值。重试发布操作前，读取已保存的审核或营销活动；切勿因超时就认定什么都没发生。审核已更改或过期时，需要重新审核并批准。

[AI 定时发布限制](/zh-Hans/help/ai-assistants#scheduling-allowance)在 MCP 客户端与 Influence IQ 之间共用。普通 HTTP/CLI 自动化及网页手动定时发布不计入其中。数据洞察的覆盖范围与刷新方式见[数据洞察](/zh-Hans/help/insights)。可选的事件订阅需要宿主单独启用并支持，并不保证每个客户端都能接收后台通知。