连接器指南阅读约 4 分钟23 个 MCP 工具7 种语言

Threads MCP 接入 Microsoft Copilot

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Threads

Threads

Run a Threads profile from your AI: read posts, replies, whole conversations and mentions, post and account insights, keyword search and public profiles, publish text, image, video and carousel posts and replies, and hide or approve replies. One long-lived Threads user token.

个工具

23

区域

INTL

类别

社交媒体

身份验证

Bearer Token

所需环境变量

THREADS_ACCESS_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

引导式设置

2 分钟将 Threads 连接到 Microsoft Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Threads,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Threads 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Threads · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Threads,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Threads + Microsoft Copilot

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

THREADS_ACCESS_TOKEN

第一步 — 获取凭据

设置大约需要 15 分钟。你需要一个具有 访问 Threads API 用例的 Meta 应用,以及一个用于连接器应作为其操作的个人资料的长期有效的 Threads 用户令牌。它适用于任何授权了你的应用的 Threads 个人资料,包括个人账户。

  1. 在 developers.facebook.com/apps/creation 创建一个 Meta 应用,使用案例为 访问 Threads API。在用例的 自定义 页面上添加所需的权限:threads_basic(始终)、threads_content_publish、threads_read_replies、threads_manage_replies 和 threads_manage_insights,如果你使用这些工具,还需添加 threads_manage_mentions、threads_keyword_search、threads_profile_discovery、threads_location_tagging 和 threads_delete。
  2. 当应用处于开发状态时,只有其自身人员可以授权。将个人资料添加到 应用角色 → 角色 → 添加人员 → Threads 测试者,然后在 Threads 中接受邀请(设置 → 账户 → 网站权限 → 邀请)。
  3. 获取用户令牌:在 Graph API Explorer 中选择你的应用,将主机切换到 threads.net,选择权限并点击 生成 Threads 访问令牌。此令牌有效期为一个小时。
  4. 通过打开 https://graph.threads.net/access_token?grant_type=th_exchange_token&client_secret=<Threads app secret>&access_token=<short-lived token> 交换为长期有效的令牌(60 天)。Threads 应用密钥在 应用设置 → 基本 下。复制答案中的 access_token。
  5. 将其粘贴到 THREADS_ACCESS_TOKEN 中,不要带上 Bearer(它以 TH 开头)。安装连接器并运行 threads_get_profile 检查连接:它返回个人资料的用户 ID 和用户名。

令牌有效期为 60 天:Threads 不为此类连接器提供刷新令牌,因此你粘贴的令牌是唯一的凭据。在 60 天到期之前(并且至少在发出后 24 小时)刷新它,方法是打开 https://graph.threads.net/refresh_access_token?grant_type=th_refresh_token&access_token=<current token>,然后将新令牌粘贴到连接器中。未及时刷新令牌无法续期:重复步骤 3 和 4。访问令牌调试器 显示令牌何时过期。

云和自托管的工作方式相同:你在 Meta 创建令牌并粘贴进去。无需在 AnythingMCP 中设置重定向 URL。

从哪里开始:threads_get_profile,然后 threads_list_posts 获取个人资料的帖子。对连接的个人资料执行操作的工具使用 me,因此你无需传递用户 ID。对于回复,threads_list_replies 返回对帖子的顶级回复,threads_get_conversation 返回其下的所有内容,使用 replied_to 重建树。threads_list_mentions 和 threads_list_my_replies 覆盖个人资料的其余活动。

洞察:threads_get_post_insights 返回一个帖子的浏览量、点赞数、回复数、转发数、引用和分享;threads_get_account_insights 返回个人资料在一段时间内的总览、每日浏览量以及从 100 个关注者中获取的关注者人口统计信息。洞察仅存在于连接的个人资料的帖子中。

发现:threads_search_posts 按关键词或主题标签搜索(没有获得批准的 threads_keyword_search 权限时,它仅搜索个人资料自己的帖子;每 24 小时 2,200 次搜索)。threads_lookup_profile 和 threads_list_profile_posts 通过精确用户名读取公共资料,threads_search_locations 查找要标记的位置 ID。

发布是公开的:AI 显示确切的文本和媒体,并在发布之前等待确认。文本帖子或回复是一个调用,threads_post_text(最多 500 个字符;reply_to_id 使其成为回复)。图像或视频帖子需要 threads_create_container 和公共媒体 URL,对于视频,使用 threads_get_container_status 直到其状态为 FINISHED(平均约 30 秒),然后 threads_publish。轮播是 2 到 20 个项目容器,一个 CAROUSEL 容器包含它们的 ID 和文本,然后 threads_publish。threads_repost 重新发布帖子。threads_get_publishing_limit 显示配额:每 24 小时 250 个帖子、1,000 个回复和 100 个删除。

审核:threads_hide_reply 隐藏或取消隐藏个人资料帖子上的顶级回复。对于使用回复批准创建的帖子,threads_list_pending_replies 和 threads_manage_pending_reply 批准或忽略被保留的回复。

安装时关闭:threads_delete_post(永久删除帖子、回复或转发)。删除无法撤销,并且需要 threads_delete 权限。仅当 AI 应该删除时,在连接器页面上打开它;它会要求你确认每个调用。发布、转发、隐藏回复和批准回复是开启的(threads_post_text、threads_create_container、threads_publish、threads_repost、threads_hide_reply、threads_manage_pending_reply)。

分页和 ID:列表返回 data 和 paging.cursors;AI 将 paging.cursors.after 作为 after 传递,直到它缺失,每页最多 100 项。ID 是数字字符串,保持不变。since 和 until 采用 Unix 秒或日期。

常见错误:190 表示令牌过期或被撤销(用户移除了应用或更改了密码),或者它是 Facebook 或 Instagram 令牌而不是 Threads 令牌:创建一个新令牌(步骤 3 和 4)。10 或 200 表示缺少权限:在用例中添加并重新生成令牌。4、17、32 或 613 是速率限制:等待几分钟。ERROR 状态的容器通常意味着 Meta 无法下载媒体 URL(必须是公共的且不能重定向)或格式不受支持。

未涵盖:除了拥有令牌的个人资料之外的其他 Threads 个人资料(为第二个个人资料添加第二个连接器),以及 Facebook 和 Instagram API。

第二步 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

第三步 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 Threads 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具

工具功能
threads_get_profile连接的 Threads 个人资料:id、用户名、显示名称、个人简介、个人资料图片 URL 和 is_verified
threads_get_publishing_limit个人资料已使用的滚动 24 小时配额:帖子(配额使用 250,轮播计一次)、回复(reply_quota_usage…
threads_list_posts列出连接的个人资料发布的帖子,最新的在前:id、文本、媒体类型和 URL、永久链接、时间戳、引用和转发链接…
threads_get_post通过媒体 ID 获取一个 Threads 帖子或回复:文本、媒体类型和 URL、永久链接、所有者、时间戳、轮播的子项、引用或转发…
threads_list_my_replies列出连接的个人资料在任何帖子上写的回复,最新的在前,并附上每个回复所回答的帖子(replied_to、root_post)
threads_list_mentions列出其他个人资料提及连接的个人资料的公共帖子(@username),最新的在前
threads_list_replies列出对帖子的顶级回复(不是对回复的回复),默认最新的在前,包含用户名、文本、时间戳、hide_status 和…
threads_get_conversation帖子下的整个对话作为一个扁平列表:顶级和嵌套回复,每个回复都有 replied_to 和 root_post,以便重建树。
threads_list_pending_replies列出在启用了回复批准的帖子上等待批准的回复(enable_reply_approvals)。…
threads_hide_reply隐藏或取消隐藏连接的个人资料帖子上的顶级回复
threads_manage_pending_reply批准或忽略待处理回复(来自 threads_list_pending_replies)
threads_get_post_insights连接的个人资料某个帖子的生命周期参与度:浏览量、点赞数、回复数、转发数、引用和分享
threads_get_account_insights连接账户在一段时间内的个人资料级洞察:浏览量(每日)、点赞数、回复数、转发数、引用、链接点击和…
threads_search_posts按关键词或主题标签搜索公共 Threads 帖子,最受欢迎(TOP)或最新(RECENT),可选择仅文本、图像或视频帖子…
threads_lookup_profile通过精确用户名获取另一个 Threads 用户的公共资料:姓名、个人简介、个人资料图片、is_verified、关注者数量和点赞数…
threads_list_profile_posts通过精确用户名列出另一个 Threads 个人资料的最近公共帖子,最新的在前
threads_search_locations按名称或坐标查找要在帖子中标记的地点;返回带有名称、地址、城市、国家和坐标的位置 ID
threads_post_text发布文本帖子或文本回复,一步完成(auto_publish_text):它立即在连接的个人资料上生效
threads_create_container发布图像、视频或轮播帖子(或回复)的第一步:从公共 URL 创建媒体容器
threads_get_container_status发布前媒体容器的状态:IN_PROGRESS(仍在处理,请在几秒钟后再检查)、FINISHED(准备好…
threads_publish发布的第二步:在连接的个人资料上发布 FINISHED 媒体容器
threads_repost在连接的个人资料上重新发布已发布的 Threads 帖子(类似于转发按钮)
threads_delete_post永久删除连接的个人资料的帖子、回复或转发

示例提示

  • "我过去 30 天内的哪些 Threads 帖子获得了最多的浏览量,每个帖子获得了多少回复?"
  • "展示我最新帖子的整个对话,并总结人们在问什么。"
  • "草拟一个对该帖子下方顶级问题的回复,并在发布之前展示给我。"
  • "我个人资料的浏览量和关注者在这个月如何变化?"
  • "查找最近关于我们产品名称的 Threads 帖子,并列出撰写它们的账户。"

常见问题

令牌过期后会发生什么? 调用失败,错误为 190。在 60 天到期之前使用 grant_type=th_refresh_token 刷新令牌,并将新令牌粘贴到连接器中;过期后,生成新令牌并再次交换。

它可以删除帖子吗? 只有在你在连接器页面上开启 threads_delete_post 并且令牌具有 threads_delete 权限时才能删除。安装时默认关闭。

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

2 分钟将 Threads 连接到 Microsoft Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Threads,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。

相关指南

连接器

Threads MCP 接入 ChatGPT:帖子与数据

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

连接器

Threads MCP 接入 Claude:帖子与回复

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

连接器

Threads MCP 接入 Cursor:搜索与发帖

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

连接器

Threads MCP 接入 Gemini CLI

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

连接器

Threads MCP 接入 Meta Muse

从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。

连接器

Threads MCP 服务器:帖子与互动数据

通过你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。