凭据、批准与发布状态
用限定权限范围的凭据控制访问
批准具体的发布操作
查看发布状态
通过 MCP 读取已连接的账号
此 Node.js 示例连接 Influence,并列出工作区中的社交账号。它只读取账号详情,不会创建草稿或发布帖子。
1. 创建具有读取权限的密钥
在“设置”中打开 应用与自动化 → 开发者工具。选择 读取已连接的渠道(integrations:read),取消选择其他所有权限,然后创建 API 密钥。将密钥保存到本地秘密信息存储或环境中,命名为 INFLUENCE_API_TOKEN。密钥只显示1 次;不要将它写进源文件或聊天。
打开 API 密钥设置2. 运行示例
安装 Node.js 和 npm 后,在项目中安装 MCP SDK。将下方代码保存为 accounts.mjs,然后在已设置 INFLUENCE_API_TOKEN 的环境中运行 node accounts.mjs。SDK 会处理 MCP 的连接和初始化。
npm install @modelcontextprotocol/client@2.3.1accounts.mjs
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");
const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
new URL("https://influence.so/api/mcp"),
{ requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);
try {
await client.connect(transport);
const result = await client.callTool({
name: "accountList",
arguments: { limit: 20 }
});
console.log(JSON.stringify(result.structuredContent, null, 2));
if (result.isError) process.exitCode = 1;
} finally {
await client.close();
}3. 读取响应
此响应示例中的账号名称和 ID 均为虚构。你的响应会标明工作区及其中已连接的社交账号。
{
"ok": true,
"output": {
"cursor": null,
"done": true,
"items": [
{
"connectionId": "account_example_01",
"eligible": true,
"name": "Example studio",
"platform": "bluesky",
"supportsImage": true,
"supportsText": true,
"supportsVideo": true
}
],
"workspaceId": "workspace_example_01",
"workspaceName": "Example workspace"
},
"toolName": "accountList"
}结果说明
已返回账号
用 connectionId 识别各账号。eligible、supportsText、supportsImage 和 supportsVideo 表示当前的发帖能力;准备帖子前,请重新检查这些字段。
未返回账号
ok: true、items: [] 且 done: true 表示读取成功。请在 workspaceName 所示的工作区中连接社交账号,然后重新运行示例。
结果分为多页
done 为 false 时,使用返回的 cursor 和相同的 limit,再次调用 accountList。继续读取,直到 done 为 true;第一页返回的账号可能少于20个。
访问被拒绝
收到401响应时,请检查密钥是否仍有效,以及是否具有 integrations:read 权限。使用 API 密钥时,缺少权限范围也可能返回401。OAuth 连接可能返回403 insufficient_scope;请重新连接并批准读取账号的权限。
ChatGPT 和 Claude 可以通过浏览器授权连接,无需使用密钥。按相应助手的设置指南完成配置后,请它列出已连接账号。上面的示例使用完整 MCP 端点 https://influence.so/api/mcp;Claude 核心连接器有自己的设置方式。
查看可用工具及所需权限
GET /api/v1/tools 会列出你的密钥可用的工具。此请求筛选出 accountList 的权限和确认要求。创建草稿还需要额外的写入权限。
HTTP API
GET /api/v1/tools你的应用读取工具目录,并调用可用工具。
MCP
tools/list受支持的助手发现可用工具,并遵循相同的审核流程。
1. 准备草稿
调用 campaignDraftSave,并使用工作区中的账号和媒体。保留版本及请求标识,以便在响应中断时恢复。写入草稿需要服务器确认。
2. 准备审核信息
针对已保存的版本及操作调用 campaignReview。请求批准前,先展示账号、内容、媒体、设置、时间和到期时间。
3. 执行已批准的操作
campaignReviewExecute 要求对该份确切的审核信息作出批准。文字帖子需要在完整审核信息展示后收到新的回复;带媒体的内容须先查看媒体,再批准。服务器会将操作交给持久化调度器,而不直接调用平台。
4. 重试前先读取结果
读取各账号的状态,以及可用时返回的已发布链接。发送结果不确定时,会保持“需审核”状态,直到结果查明。创建另一条帖子前,先恢复现有请求,否则可能重复发送。
为你的工具选择连接方式
| 连接方式 | 用途 | 访问方式 |
|---|---|---|
| HTTP API | 你的应用读取工具目录,并调用可用工具。 | 从环境变量读取带权限范围限制的 bearer 凭据。 |
| MCP | 受支持的助手发现可用工具,并遵循相同的审核流程。 | 按 Influence“设置”中对应助手的步骤完成配置。可用性取决于宿主和已授予的权限。 |
工具目录请求
curl --fail-with-body 'https://influence.so/api/v1/tools' \
--header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
| jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'工具目录字段示例
{
"tools": [
{
"confirmation": "none",
"mutability": "read",
"name": "accountList",
"scopes": [
"integrations:read"
]
}
]
}这些示例字段来自工具定义。实际可执行的操作由实时工具目录、凭据权限范围和已连接账号决定。

可构建的发布工作流
从自有内容流程准备帖子
在自己的工具中,根据文章、更新日志或社区通知准备草稿。请求 Influence 安排发布前,先展示具体的社交账号、内容和时间供审核。
响应丢失后恢复原请求
保留原请求和幂等键,再查询其结果。结果不确定的发送会保持“需审核”状态,直至能确认发生了什么。新建替代请求可能导致同一帖子发布两次。
用 Influence IQ 起草初稿
向 Influence IQ 提供文章、项目笔记或社区动态,以及已保存的品牌指南,获取可编辑草稿。获授权且可用的 AI 工具会消耗 IQ 点数,各自的确认要求仍然适用。
向 Influence IQ 提供笔记和已保存的品牌指南,即可获得可编辑的帖子及建议日期。起草和图片生成会消耗 IQ 点数。开始生成图片前先审核报价,发布前再审核完成的内容。
了解 Influence IQ从 AI 助手开始
通过受支持的 Influence 连接,你可以在 ChatGPT 或 Claude 中规划营销活动、修改草稿。让助手上传它能访问的图片和视频,或复用 Influence 中已就绪的媒体素材;若助手无法访问文件,先在 Influence 中上传。审核具体的社交账号、文字、素材、设置和时间。看过完整审核信息后,再通过受支持的对话内卡片批准,或新回复一条“批准”。使用 TikTok Direct 时,先在对话中给出发布选项并表示同意,再批准更新后的审核信息。审核卡片可选。设置方法和连接状态可在“设置”中查看。
为已连接的社交账号发布内容
选择工作区可用的社交账号。为每个发布目标编辑文字和受支持的素材,发布前再审核帖子。
常见问题
- API 和 MCP 工作流能做什么?
- 视已启用工具及你的权限而定,API 或 MCP 客户端可以处理已连接社交账号、已保存草稿、受支持的素材、帖子审核、发布排期和发布状态。
- API 或 MCP 调用会绕过批准吗?
- 不会。服务端会强制执行各工具的确认要求。发布前,必须批准当前审核内容。执行时会先检查工作区、权限、社交账号和内容,再安排发布。
- 助手工作流接受哪些素材?
- 请助手上传它能访问的图片和视频,或复用 Influence 中已就绪的素材。如果助手无法访问文件,请先在 Influence 中上传。审核具体的社交账号、文案、素材、设置和时间。看过完整审核内容后,在受支持的聊天内卡片中批准,或重新回复“批准”。使用 TikTok Direct 时,先在聊天中说明发布选项并表示同意,再批准更新后的审核内容。审核卡片为可选形式。
- 响应丢失或发送结果不确定时,该怎么办?
- 找回原请求的结果,并检查记录的状态。不要重复发送结果不明的请求。“需审核”会一直保持未解决状态,直到核对确认实际结果。
- 支持 MCP 是否就保证所有助手宿主都能使用?
- 不保证。登录后,打开“设置 → 应用与自动化 → 连接你的助手”,查看设置说明和当前连接状态。
- 集成能编辑已排期或已发布的帖子吗?
- 如果发布尚未开始,且没有结果未明的发送,已安排发布的帖子可以退回草稿,供编辑并再次审核。助手无法编辑或删除已经在平台上发布的内容。