Mallary MCP Server

什么是 Mallary MCP Server？

Mallary MCP Server 是社交媒体发布 API Mallary.ai 的官方远程 MCP 服务器，让 AI 智能体在一次对话中就能在 10 个社交网络上发布、定时发布、回复评论和查看数据分析。

Mallary 支持 YouTube、Facebook、Instagram、TikTok、LinkedIn、X、Pinterest、Threads、Reddit 和 Bluesky。你只需在 Mallary 控制台中连接一次社交账号，Mallary MCP 服务器就会为 Claude、ChatGPT、Cursor 或任何 MCP 客户端提供一套操作这些账号的结构化工具，规则和套餐限制与 Mallary REST API 相同。

如何使用 Mallary MCP Server？

连接之前：

1. 在 mallary.ai 注册（付费套餐均有 14 天免费试用）。
2. 在 Mallary 控制台中连接你的社交媒体账号。社交账号只能在控制台中连接，无法通过 MCP 完成。
3. 把远程端点添加到客户端。它使用 Streamable HTTP 和 OAuth 2.1 登录；连接时会打开浏览器窗口，让你登录 Mallary 并批准访问。

https://mallary.ai/mcp

Claude Code

claude mcp add --transport http mallary https://mallary.ai/mcp

然后运行 /mcp，为 Mallary 选择 Authenticate 完成 OAuth 流程。Mallary 还提供官方 Claude Code 插件，把该服务器和工作流说明打包在一起；如果使用插件，只连接一次 Mallary，以免工具重复出现。

Claude Desktop / claude.ai

Mallary 已收录在 Claude 连接器目录中，可以直接从目录添加。也可以进入 Settings → Connectors → Add custom connector，粘贴 https://mallary.ai/mcp。如果要发布在 Claude 中上传的图片或视频，Mallary 文档要求把 *.r2.cloudflarestorage.com 加入 Claude 的额外允许域名，然后开启新对话。

Cursor

打开 Cursor Settings → Tools & MCP → Add new MCP server，粘贴：

{
  "mcpServers": {
    "mallary": {
      "url": "https://mallary.ai/mcp"
    }
  }
}

Cursor 提示时点击 Connect，并在浏览器中完成登录。

VS Code

在命令面板中运行 MCP: Add Server 并输入 URL，或将其添加到 mcp.json：

{
  "servers": {
    "mallary": {
      "url": "https://mallary.ai/mcp"
    }
  }
}

Codex

codex mcp add mallary --url https://mallary.ai/mcp

对于无法使用 OAuth 的脚本和客户端，Mallary 也接受以 Authorization: Bearer <mallary_api_key> 方式发送的 API 密钥。

Mallary MCP Server 的主要功能

• 一次发布，多个网络：一次调用即可把文字、图片、视频或轮播发布到多个已连接平台，还可以为每个平台写不同的文案。
• 支持时区的定时发布：按绝对 UTC 时间，或按本地时间加 IANA 时区定时；在任何平台开始发布之前都可以编辑定时帖子。
• 草稿保存：保存没有发布日期的未完成帖子，之后再发布或定时。
• 评论回复：读取通过 Mallary 发布的帖子下的评论，并在 Facebook、Instagram、Threads、LinkedIn、X、YouTube 和 Bluesky 上回复。
• 数据分析与粉丝数：读取点赞、浏览、分享，以及每个已连接账号的粉丝或订阅者数量。
• 按品牌划分的配置文件：把账号分组到连接配置文件中（每个业务或客户一个），并按 ID 指定配置文件。
• Webhook 与设置：管理帖子和自动回复事件的 webhook，以及品牌和 AI 自动回复设置。
• 分范围的 OAuth 授权：read、publish、engage 和 manage 范围；可在 mallary.ai/oauth-connections 查看和撤销授权。

Mallary 文档列出了该服务器提供的工具，包括 mallary_create_post、mallary_create_upload_url、mallary_get_job、mallary_list_comments、mallary_reply_to_comment、mallary_get_analytics 和 mallary_list_platforms。登录后客户端会收到完整列表。

Mallary MCP Server 的使用场景

• 发布公告：“明天纽约时间 9:00 把这条发布说明连同附图发到 LinkedIn、X 和 Bluesky。”
• 内容再利用：把一篇博客文章改写成适合各平台的文案，然后在 Instagram、Threads 和 Facebook 上定时发布。
• 社区运营：“列出昨天 Instagram 帖子下的新评论，并回复关于发货的问题。”
• 效果复盘：“这个月我哪些帖子的浏览量最高？”——使用按浏览量排序的帖子分析。
• 代理商工作流：把每个客户放在独立的连接配置文件中，按名称发布到正确的配置文件。

Mallary MCP Server 常见问题排查

• 找不到某个平台：必须先在 Mallary 控制台中连接社交账号。可以让智能体列出配置文件和已连接平台，查看已关联的内容。
• 在 Claude 中上传的媒体无法发布：把 *.r2.cloudflarestorage.com 加入 Claude 的额外允许域名，然后开启新对话。
• 定时帖子无法编辑：只有在任何目标平台开始发布之前才能编辑。如果编辑返回冲突，请先重新读取帖子再重试。
• 连接反复要求登录：invalid_grant 错误表示授权已被撤销或过期；请在客户端中重新连接服务器。