X (Twitter) by 1Social

1Social MCP

用于向社交网络发布内容的 Model Context Protocol 服务，由 OAuth 保护。

1Social MCP 可让 AI 助手代你发布内容。将 Claude、ChatGPT、Cursor、VS Code 或命令行客户端连接到 1Social，即可用自然语言在 Instagram、TikTok、X、LinkedIn、Bluesky、Threads、Facebook 和 YouTube Shorts 上发布、安排、检查和修正帖子。

• 服务 URL： https://mcp.1social.dev/mcp
• 传输方式： Streamable HTTP
• 身份验证： OAuth 2.1，采用 PKCE 和动态客户端注册
• 介绍与设置： 1social.dev/mcp

安装

1Social MCP 是远程且受 OAuth 保护的服务。无需安装软件包，也无需粘贴 API 密钥。将以下内容添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "1social": {
      "url": "https://mcp.1social.dev/mcp"
    }
  }
}

一键安装： Cursor · VS Code · Claude connectors · ChatGPT connectors

命令行客户端（Claude Code、Gemini CLI、Codex CLI）和手动配置片段：请参阅支持的客户端。

快速入门

1. 在 1social.dev 创建 1Social 账户。
2. 在浏览器中连接你的社交账户。 此步骤需要使用浏览器，无法在聊天中完成——你必须在每个社交网络的 OAuth 授权页面上签署授权。
3. 使用一键链接、命令行命令或上方的 JSON/TOML 配置片段，将服务添加到客户端。
4. 客户端打开授权页面后，使用 OAuth 完成授权。
5. 让助手帮你发布内容。

在聊天中可以做什么

• 📤 发布和安排发布——一条消息即可发布到你选择的所有社交网络，可立即发布，也可安排在未来 30 天内发布。
• 🔍 发布前检查——查看各网络的字符数、是否需要图片、多部分帖子会以原生串帖形式发布还是合并发布，以及对配额的消耗。
• 🧾 查看回执——了解哪些内容已发布到各网络、哪些发布失败及原因，以及哪些情况确实无法确定。
• ♻️ 修复发布问题——重试发布到某个网络，不影响已成功发布的网络。
• 🖼 附加媒体——在聊天中发布图片或视频。Instagram 和 TikTok 不接受没有图片或视频的帖子。
• ✏️ 编辑、取消、删除——更改已安排的帖子、取消安排，或从支持删除的网络中删除帖子。

工具范围

仅提供十个工具，刻意保持精简。立即发布和定时发布使用同一个工具（scheduledAt: null 表示立即发布）；读取单篇帖子则通过带有 postId 的 list_posts 完成，而不是再单独提供一个工具——工具集越小，模型就越能准确地选用工具。

工具	功能
list_accounts	已连接的账号、各网络接受的内容、当前套餐和剩余配额。请先调用它——频道 ID 由此获取。
preview_post	免费试运行：查看各网络的限制、媒体要求、线程行为和配额成本。不会发布任何内容。
publish_post	立即发布，或安排在未来 30 天内发布。返回各网络的回执。需要提供 idempotencyKey。
list_posts	查看帖子及其在各网络上的投递结果——已送达、失败并附原因、已取消或 unknown——以及已存储的互动指标。
update_post	编辑尚未发送的帖子。各网络没有编辑接口，因此此操作会撤回并替换帖子。
cancel_post	取消帖子的定时发布，并释放为其预留的配额。
delete_post	从 1Social 删除帖子，并尝试从各网络删除。请参阅删除能做什么和不能做什么。
retry_delivery	重试一个投递失败的网络，其他已成功的网络不受影响。永久性失败不允许重试。
upload_media	生成预签名上传目标，供无法在工具调用中附加文件的客户端使用。
confirm_delivery	记录你对投递结果未知的投递所作的判断：帖子是否已在该网络上线？

实际提供的工具以服务端为准——请对 https://mcp.1social.dev/mcp 运行 tools/list，获取准确且最新的工具定义。

不确定时会明确告知

一篇帖子发布到四个网络，可能只在三个网络上线。每个工具结果都按网络分别列出：失败原因会以可采取行动的文字说明；对于确实无法确定结果的投递，会返回 unknown，而不是报告成功。

unknown 并非无从处理。你查看网络上的情况，告诉助手你的所见，再由 confirm_delivery 确认结果——确认帖子已上线会扣除相应配额；确认帖子未上线则会将投递标记为失败，以便 retry_delivery 重试。助手不得代你猜测结果。

删除能做什么和不能做什么

delete_post 始终会从 1Social 删除帖子。能否从网络删除，取决于相应网络：

网络	远程删除
X、LinkedIn、Bluesky、Facebook	✅ 可以
Instagram、TikTok、Threads	❌ 没有可用的删除 API——帖子仍会显示，只有你可以将其删除

对于包含多个部分的线程，只会删除第一条帖子；其余帖子仍会显示，成为孤立帖子。工具会按网络报告实际删除的内容，并要求助手告知你实际情况，而不是声称已彻底删除。

套餐与访问权限

每次投递都会产生费用，因此配额按投递次数而非帖子数计量——一篇帖子发布到四个网络，就算作四次投递。投递到 X 消耗的单位比其他网络多，因为 X 按帖子收费（定价页面提供当前价格）。

	无订阅	Solo	Pro
价格	$0	$19/月	$39/月
每月投递次数	30 个单位	600 个单位	1,600 个单位
全部八个网络	✅	✅	✅
投递回执与重试	✅	✅	✅

新账号每月有少量免费额度——足以发布内容、查看返回的回执、重试投递失败的内容，并安排帖子发布——因此无需先付费即可使用这些工具。如果失败是由我们或网络造成的，则该次投递不会计入配额。

你无需离开聊天即可付款。 如果工具调用耗尽配额，系统会返回一个适用于你账号的结账链接。

支持的客户端

• Claude（网页端和桌面端）— Settings → Connectors → Add custom connector
• ChatGPT — Settings → Apps & Connectors → Advanced → Developer mode → Add custom connector
• Cursor — 一键深度链接，或 ~/.cursor/mcp.json
• VS Code — 一键深度链接，或 .vscode/mcp.json
• Claude Code（CLI） — claude mcp add --transport http 1social https://mcp.1social.dev/mcp
• Gemini CLI — gemini mcp add --transport http 1social https://mcp.1social.dev/mcp
• Codex CLI — codex mcp add 1social --url https://mcp.1social.dev/mcp
• 通用 HTTP MCP 客户端 — 将其指向该 URL，并让它完成 OAuth 发现

各客户端的完整说明：docs/setup.md。

Cursor 插件

此仓库也是一个 Cursor 插件。它提供一个 MCP 服务（1social），不包含规则、技能、Agent 或钩子。

.cursor-plugin/plugin.json   ← plugin manifest
mcp.json                     ← the MCP server it contributes
assets/logo.svg              ← plugin logo

无需进行任何配置。该服务会公布 OAuth 2.1 元数据，Cursor 会动态注册，并在首次使用时打开授权界面。

提示词示例

先检查，再跨平台发布

“为我们的新定价页面起草一篇帖子，发布到 LinkedIn、X 和 Bluesky，检查内容是否合适，然后发布。”

→ preview_post 会报告各平台的字数和费用；publish_post 会返回各平台的回执。

配图并安排发布时间

“周五上午 9 点把这张截图发到 Instagram 和 Threads。”

→ 附件会放入 media；如果没有图片，Instagram 会拒绝发布。

查明实际发生了什么

“昨天的帖子是不是已经在所有平台发布了？”

→ list_posts 会返回回执，包括任何仍标记为 unknown 的投递。

修复，而非重新发布

“LinkedIn 发布失败了。只重试 LinkedIn。”

→ retry_delivery 只处理一条投递，其他成功的平台不受影响。

更多内容：docs/examples.md。

授权

根据 MCP 授权规范，使用带 PKCE 的 OAuth 2.1。授权服务器为 https://1social.dev；它支持动态客户端注册，因此兼容的客户端可以自行完成设置，你只会看到授权界面。授予的作用域为 openid、profile、email 和 offline_access。

助手永远不会看到你的社交平台凭据。 你的平台令牌保留在 1Social 中；助手只持有用于访问你 1Social 账户的令牌，你可以随时通过 Web 应用撤销该令牌。

流程详情：docs/oauth.md。

故障排除

常见的连接、OAuth 和工具调用错误：docs/troubleshooting.md。

市场列表

此仓库是以下两个列表的源代码：

Registry	Record	Manifest
MCP Registry	dev.1social/1social	server.json — 由 CI 在 v* 标签上发布，并通过 1social.dev 上的 DNS TXT 记录进行验证
LobeHub	sultanlive-1social-mcp	lhm.plugin.json — 使用 npx -y @lobehub/market-cli plugin publish --dir . 发布

lhm.plugin.json 中的 tools 数组是根据服务自身契约中的 TOOLS 表生成的（私有仓库中的 packages/contract/src/mcp/tools.ts），该表也用于响应 tools/list。这是一个快照：工具范围发生变化时，应重新生成，而不是手动编辑，否则列表描述的将不再是现存的服务。

请注意，这两个注册表故意使用不同的版本号——server.json 的版本为 0.1.0，而 LobeHub 在导入时分配了 1.0.0，且版本号无法重命名。

项目链接

• 产品：1social.dev
• MCP 页面：1social.dev/mcp
• MCP 服务：https://mcp.1social.dev/mcp
• OAuth 颁发方：https://1social.dev
• 问题反馈：github.com/sultanlive/1social-mcp/issues

许可证

MIT — 详见 LICENSE。

---

由 @sultanlive 构建。1Social 是一项托管发布服务；此仓库是其公开 MCP 服务的文档。服务端源代码不开源。