跳到内容
Influence
Esc
↑↓导航↵打开⌘J预览
本页内容

MCP

将 AI 客户端连接到 Influence,管理账号、素材、审核、排期及可用的数据洞察。

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

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

连接并发现工具

使用客户端的 Influence OAuth 流程;如果客户端支持 Bearer 身份验证,也可使用限定权限的 API 密钥。应用与自动化提供各客户端的设置方法。请将 API 密钥存放在客户端的机密环境中。

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

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

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

准备已完成创作的内容

  1. 读取 accountList,再为每个选定账号读取 integrationSchema,了解必需设置与素材限制。使用指定的平台查询工具,查找图板、频道及类似目标位置。
  2. 使用 mediaImport,传入 url 和可选的 name,导入可访问的 HTTPS 文件。真实的宿主文件使用独立的 file 对象,不得虚构文件 ID。本地文件请使用分片上传工具,或现有的 SDK/CLI 辅助工具。素材限制与就绪要求同样适用。
  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 同意属于某次精确审核;草稿中保存的同意不能完成这一步。保存审核选择会创建新的草稿版本,使之前的审核过时,即使设置没有变化也如此。

确认与恢复

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

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

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

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

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