HumanPost

HumanPost MCP 和 Agent 插件

HumanPost 的官方集成包：通过 AI 助手管理社交账号、准备视频和图片草稿、将已批准的内容加入队列，并查看人工发布状态和分析数据。

HumanPost 运行托管式 MCP 服务。此仓库包含客户端配置和发布技能，不包含托管服务器实现。使用需要 HumanPost 账号和公司访问权限。支持 OAuth 的客户端使用 HumanPost 登录；公司范围的 API 密钥仍可用于手动配置。根据你的 HumanPost 方案，使用服务和执行某些操作可能会产生费用。

连接

• 传输方式：Streamable HTTP
• 端点：https://humanpost.com/mcp
• 身份验证：使用 S256 PKCE 和动态客户端注册的 OAuth 2.1 授权码流程。也支持公司范围的 API 密钥。
• 设置和工具 · API 参考 · 完整的 Agent 文档

在 Dashboard → Settings → API & MCP 下创建密钥。先使用 accounts:read，然后仅添加工作流所需的权限范围。每个密钥属于一个公司。将其存储在客户端的机密配置中；切勿提交密钥或将其粘贴到对话中。OAuth 用户在授权屏幕中选择一个公司和最低权限。默认禁用写入操作。访问令牌 15 分钟后过期；刷新令牌会轮换，并在 7 天后过期。前往 Settings → API Keys 撤销连接。此软件包不包含任何凭据。

Cursor

Cursor 插件使用规范的 OAuth 端点。安装插件，然后使用 Cursor 的 Connect 操作登录 HumanPost。手动设置：

{
  "mcpServers": {
    "humanpost": { "url": "https://humanpost.com/mcp" }
  }
}

如果改用公司 API 密钥，请在私有 Cursor 设置中配置 Authorization 标头，值为 Bearer ${env:HUMANPOST_API_KEY}。

Cline

将 config-cline.json 合并到 Cline 的 MCP 设置中。在本地设置中，将 YOUR_HUMANPOST_API_KEY 替换为你的受限密钥。请妥善保管该设置文件。传输值为 streamableHttp；请将 autoApprove 留空，并审核工具调用。Cline CLI 默认使用 ~/.cline/data/settings/cline_mcp_settings.json，并支持通过 CLINE_MCP_SETTINGS_PATH 使用隔离配置。

Claude Code

将此仓库添加为插件市场，然后安装插件：

/plugin marketplace add HumanPost-co/humanpost-mcp
/plugin install humanpost@humanpost

启动 Claude Code 前，在进程环境中设置 HUMANPOST_API_KEY。也可以使用项目中的 .mcp.json 条目。兼容性 .mcp.json 使用通过环境变量提供的 API 密钥。若要改用原生 OAuth，请运行 claude mcp add --transport http humanpost https://humanpost.com/mcp，然后使用 Claude Code 的 MCP 身份验证流程。Claude 网页目录审核与安装此插件是两回事。

Grok Build

Grok Build 支持兼容 Claude 的插件。使用其插件市场命令添加此仓库：

grok plugin marketplace add HumanPost-co/humanpost-mcp

从 Marketplace 标签页安装 humanpost，并在客户端环境中提供 HUMANPOST_API_KEY。此软件包包含 .grok-plugin/plugin.json 和 .claude-plugin/plugin.json。启用前请检查已配置的 MCP。被官方市场收录与添加此发布者的市场是两回事。

Grok Bot

Grok Bot 使用单独的应用目录提交表单，该表单也适用于 Cursor。上文的 Grok Build CLI 说明仅适用于 Build；这些操作不会安装 Bot 应用插件。此仓库包含 Cursor 市场清单，以及用于应用目录审核的规范 OAuth MCP 条目。

目前尚未确认 Grok Bot 专属的上架信息。其提交表单要求进行实际的应用内测试。后端 SDK 测试和浏览器 OAuth 授权检查均有单独记录，不能替代该项认证。

Muse Code

将 config-muse.json 中的 mcp_servers.humanpost 条目合并到 Muse Code 设置中。它使用 Muse 记录的 streamable_http 传输方式，并支持通过 ${HUMANPOST_API_KEY} 插入环境变量。使用以下命令安装发布技能：

muse skills install ./skills/humanpost-publishing --scope user

Muse Code 配置与在面向用户的 Muse 目录中列出连接器是两回事。此处并未声称已获面向用户的目录批准。

Agent Skills / skills.sh / OpenClaw

npx skills add HumanPost-co/humanpost-mcp --skill humanpost-publishing

该技能会使用已连接的 MCP，或在能够发出 HTTP 请求的主机上使用文档所述的 REST API。它无法提供主机本身不具备的网络或 shell 功能。安装技能不会配置凭据，也不会授予公司访问权限。

ChatGPT 和 Codex

根目录下的 plugin.json 和 mcp.json 使用可移植的 Agent Plugins 格式。可移植的 MCP 条目使用 OAuth 端点，并会发现其授权服务器。

要上传到 OpenAI 门户，请使用 发布版本中的 humanpost-openai-plugin-1.0.2.zip。其中的根目录 mcp.json 使用 openai/mcp.json 中记录的 OpenAI 身份验证扩展：使用 DCR 的 OAuth，以及默认只读范围。这个独立的软件包可确保与其他主机的严格可移植架构兼容。软件包中不包含客户端密钥、访问令牌或 API 密钥。

该端点已部署，并通过独立测试公司进行了实时测试，验证了浏览器授权、范围强制执行、令牌刷新和撤销。仍需完成 OpenAI 开发者身份验证、发布者设置和市场审核。已准备好的软件包并不代表已获批准上架。

要复现已发布的版本，请先检出对应的 Git 标签，然后使用 python3 scripts/build_release.py --output-dir /tmp/humanpost-release 构建两个归档文件。后续的文档提交不会更改先前发布的归档文件。

典型工作流

1. 调用 get_context 检查公司和范围，然后调用 list_accounts 选择正确的账户。
2. 使用发现的工具检查账户、发布队列、草稿或分析数据。
3. 上传媒体并准备草稿以供审核。需要时，请求实际预览。
4. 仅在用户授权范围内将内容加入队列。重试时保留幂等键和返回的操作 ID。
5. 检查生成的帖子／任务状态。已排队和待审批状态不代表已确认发布。

服务会公布其工具目录，并在每次调用工具时强制执行密钥范围。仅发现工具并不会授予调用工具的权限。账户配置、任务创建、渲染、发布、日程变更和取消都可能产生外部影响或消耗额度。不要自动批准所有工具。工具的可用性和架构以实时工具发现结果为准；详情和限制请参阅公开文档。

安全与网络访问

OAuth 客户端连接到 humanpost.com/mcp，并从同一 HumanPost 来源发现授权端点。兼容性 API 密钥配置只会将密钥发送到 us-central1-clickbaitcarousel.cloudfunctions.net/mcp，即由 Firebase 托管的 HumanPost 服务。REST 回退方案使用同一主机上的 /publishingApi。文档链接指向 humanpost.com。上传可能会使用服务签发的签名存储 URL；切勿将 API 密钥发送到这些 URL。该软件包不包含生命周期钩子、后台进程、遥测、依赖项安装程序或远程代码执行功能。

如需在不使用密钥的情况下进行只读运行状况检查，可运行 python3 scripts/check_endpoint.py，验证公开端点是否会拒绝未经身份验证的初始化。也可以在 HumanPost 控制面板中进行经过身份验证的连接测试。未通过身份验证的检查成功，并不能验证每项工具或公司工作流。

隐私与支持

托管服务会处理由你的连接或 API 密钥授权的公司相关账户、内容、任务和分析数据。请参阅 HumanPost 隐私政策和服务条款。请联系 [email protected]，或提交集成问题。请勿在公开问题中包含凭据或客户私人内容。

集成包采用 MIT 许可证。该许可不涵盖托管的 HumanPost 服务和 HumanPost 品牌。平台兼容性配置和提交并不代表获得市场认可或批准。