HandlePilot

HandlePilot MCP

为你的 AI Agent 打造的 Instagram 内容中心。 将 Claude、ChatGPT、Claude Code、Codex、Cursor 或 VS Code 连接到 HandlePilot。你的 Agent 使用你自己的 AI 订阅进行调研、规划和写作。HandlePilot 会保存你的工作区、竞品调研、内容计划、看板、素材、轮播图和 Reels，还会替 Agent 观看视频，并保留编辑器供你审核每一句内容。

• 服务： https://app.handlepilot.com/mcp（远程，Streamable HTTP）
• 登录： 在浏览器中通过 OAuth 登录（通过电子邮件接收登录链接，然后选择 Allow），或使用个人令牌
• 文档： https://handlepilot.com/mcp

此代码库包含公开文档、MCP Registry 条目（server.json），以及一个 Claude Code 插件，其中包含以技能形式提供的 HandlePilot 操作指南。服务本身由 HandlePilot 运行，不包含在此代码库中。

你的 Agent 可以做什么

• 调研： 查找任何公开的 Instagram 账号或帖子、搜索个人主页和 Reels、分析哪些内容在竞品中表现出色，还能观看 Reels 并获取完整解析：转录文本、场景、开场钩子、结构、音乐以及内容奏效的原因。
• 规划： 根据你的赛道和自身数据撰写内容策略，将其保存为内容计划，并把创意添加到日历中。
• 创作： 将表现出色的帖子改编成符合你个人风格的脚本，把轮播图写入 HandlePilot 的设计中（也可以自行设计风格），并上传在电脑上剪辑的 Reels。
• 记忆： 你的风格指南、计划、看板、素材和内容集都保存在 HandlePilot 中，因此每次 Agent 会话都从同一处开始。

免费版和付费版

所有登录用户都能获得免费账号。无需在电脑上运行任何内容，也无需复制密钥：首次连接时会在浏览器中打开 HandlePilot 登录页面。

	免费版	付费版，$50/月，随时取消
操作指南、提示词、轮播图样式及其他知识工具	不限量	不限量
新视频观看次数（再次观看视频免费）	每月 3 次	更高额度
Instagram 查询（账号、帖子、搜索）	每月 30 次	更高额度
工作区（你管理的 Instagram 账号）	1 个	更多
灵感账号	每个工作区最多 5 个，手动添加	另含批量调研扫描
轮播图	每月 5 个，使用内置样式	已包含，另含自定义样式
内容制作看板和日历		已包含
素材库和上传		已包含
Reels（Reel Maker、成片上传）		已包含

• 免费额度在每个日历月初重置（UTC）。
• 每个账号都能看到所有工具。需要付费计划的工具，或免费额度用完时，会返回 upgrade_required 和一个链接，Agent 会提示你一次。你已保存的所有内容仍可使用。
• 在应用中升级：https://app.handlepilot.com/subscribe。现有连接会继续使用，无需重新安装。

安装

所有客户端都连接到同一个 URL：https://app.handlepilot.com/mcp。

Claude（claude.ai、Claude Desktop、移动端）

1. 打开上面的链接，或前往 Customize → Connectors，选择 + Add，然后选择 Add custom connector。将其命名为 HandlePilot 并粘贴 URL。
2. 选择 Add，登录 HandlePilot 并按下 Allow。
3. 在聊天中，前往 + → Connectors 并启用它。

在 Team 和 Enterprise 计划中，所有者只需在 Organization settings → Connectors 下添加一次，然后每位成员选择 Connect 即可。在 Claude 的免费计划中，你可以添加一个自定义连接器。

ChatGPT

1. 打开 chatgpt.com/plugins，选择 +，然后选择 Add custom MCP server。
2. 将其命名为 HandlePilot，粘贴 URL，选择 OAuth 进行身份验证，接受警告，然后选择 Create as a plugin。
3. 登录 HandlePilot 并点击 Allow。在聊天中输入 @，然后选择 HandlePilot。

你的 ChatGPT 方案和工作区设置决定了你是否可以添加自定义 MCP 服务。

Claude Code

claude mcp add --transport http handlepilot https://app.handlepilot.com/mcp

添加 --scope user，即可在每个项目中使用。然后输入 /mcp，选择 handlepilot，选择 Authenticate，登录并点击 Allow。

或者安装插件，它会添加同一个服务，以及作为技能提供的 HandlePilot playbook（/handlepilot:strategy、/handlepilot:remix，……）：

/plugin install handlepilot --marketplace Handlepilot/instagram-mcp

对于低于 2.1.275 的 Claude Code，请运行 /plugin marketplace add Handlepilot/instagram-mcp，然后运行 /plugin install handlepilot@handlepilot。接着输入 /mcp，选择 plugin:handlepilot:handlepilot，选择 Authenticate，登录并点击 Allow。

二选一即可。如果两者都使用，Claude Code 会连接两次，并将每个工具列出两次；使用 claude mcp remove handlepilot 移除手动添加的服务。

Codex

codex mcp add handlepilot --url https://app.handlepilot.com/mcp
codex mcp login handlepilot

或者在 ~/.codex/config.toml 中添加：

[mcp_servers.handlepilot]
url = "https://app.handlepilot.com/mcp"

然后运行 codex mcp login handlepilot。

Cursor

或者将其添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "handlepilot": {
      "url": "https://app.handlepilot.com/mcp"
    }
  }
}

Cursor 首次连接时会要求你登录 HandlePilot。

VS Code

或者在终端中运行：

code --add-mcp '{"name":"handlepilot","type":"http","url":"https://app.handlepilot.com/mcp"}'

或者在 .vscode/mcp.json 中添加：

{
  "servers": {
    "handlepilot": {
      "type": "http",
      "url": "https://app.handlepilot.com/mcp"
    }
  }
}

VS Code 首次使用时会在浏览器中打开 HandlePilot 登录页面。

其他客户端

任何支持使用 OAuth 的远程 Streamable HTTP 服务的 MCP 客户端都可以使用 https://app.handlepilot.com/mcp。

使用个人令牌代替 OAuth

对于不支持 OAuth 的客户端或脚本：

1. 在 https://app.handlepilot.com/connect-ai 登录并创建令牌。令牌以 hp_ 开头，且只会显示一次。
2. 将其作为标头发送：Authorization: Bearer hp_YOUR_TOKEN。

# Claude Code
claude mcp add --transport http handlepilot https://app.handlepilot.com/mcp \
  --header "Authorization: Bearer hp_YOUR_TOKEN"

# Codex: put the token in an environment variable, e.g. export HANDLEPILOT_TOKEN="hp_YOUR_TOKEN"
[mcp_servers.handlepilot]
url = "https://app.handlepilot.com/mcp"
bearer_token_env_var = "HANDLEPILOT_TOKEN"

// Cursor: ~/.cursor/mcp.json
{
  "mcpServers": {
    "handlepilot": {
      "url": "https://app.handlepilot.com/mcp",
      "headers": { "Authorization": "Bearer hp_YOUR_TOKEN" }
    }
  }
}

令牌可以访问你管理的所有工作区，并具有与你在应用中相同的权限。你可以随时在同一页面撤销令牌；撤销后会立即失效。

工具

39 个工具。每个账户都能看到所有工具；具体运行哪些工具取决于套餐。

免费

工具	功能
list_workspaces	你在 HandlePilot 管理的 Instagram 账户
get_creator_context	个人资料、细分领域、受众语言、表达风格指南和示例、套餐及看板摘要。请先阅读
update_voice_pack	保存创作者的说话和写作风格
get_my_performance	创作者自己近 30 天的 Instagram 数据（需要在应用中连接 Instagram）
list_inspiration_accounts	竞争对手和灵感账号关注列表，按优先级排序
verify_inspiration_accounts	根据你的确认，将列表中的账号标记为已验证
remove_inspiration_account	将账号从列表中移除
list_top_content	关注列表中近期表现最佳的帖子，内嵌缓存的视频分析
get_content_plan、save_content_plan	查看或保存内容策略
list_carousel_styles、get_carousel_style	HandlePilot 的轮播图设计，以及每种设计的写作简报
list_carousels、get_carousel、update_carousel	你的轮播图；修改一份幻灯片稿
get_playbook	HandlePilot 的操作指南（与插件技能中的文本相同）
send_feedback	告诉 HandlePilot 团队需要修复、添加或更改的内容

免费，每月额度内

工具	功能	免费额度
watch_video	对 Reel、帖子或素材进行结构化分析：转录文本、屏幕文字、场景、开场钩子、结构、音乐、剪辑方式及其成功原因	每月分析 3 个新视频；重复观看免费
get_instagram_account	公开个人资料及其近期帖子数据	每月查询 30 次，由这三个工具共享
get_instagram_post	单条帖子：说明文字、数据、作者、媒体链接
search_instagram	搜索 Instagram 个人资料，或搜索本月有关某个主题的 Reel
create_workspace	添加 Instagram 账户作为工作区	1 个工作区
add_inspiration_accounts	将账号添加到关注列表，供你验证	每个工作区最多 5 个
create_carousel	按某种风格创作轮播图，可在 Carousel Maker 中编辑	每月 5 个，使用内置风格

付费套餐

工具	功能
scan_instagram_accounts	批量调研：一次调用最多筛查 20 个账号
list_cards、get_card、create_card、update_card、delete_card	制作看板和日历，包含脚本
create_custom_style	设计自定义轮播图风格，并制作第一份幻灯片稿
list_assets、search_assets、get_asset、import_asset_from_url、create_upload_link	素材库，可按含义搜索；也可为过大而无法在聊天中发送的文件创建上传页面
start_asset_upload	将电脑中的文件上传到素材库 *
list_reels、start_reel_upload	Reel Maker，以及 Agent 剪辑完成的 Reel *

* start_asset_upload 和 start_reel_upload 仅提供给在你的电脑上运行的 Agent，例如 Claude Code。ChatGPT 和 claude.ai 等聊天应用无法使用这些工具。

该服务还将其操作手册作为 MCP 提示词提供：getting-started、strategy、discovery、voice-pack、remix、carousel、custom-style、reel-editing。

示例提示词

• “在 HandlePilot 上查找 @yourhandle，告诉我最近 30 条帖子中哪些的浏览量超过了平时水平，以及原因。”
• “观看这个 Reel，并分析它的开场钩子、结构和成功原因：https://www.instagram.com/reel/...”
• “根据我近期的帖子整理我的表达风格指南，并保存到 HandlePilot。”
• “用 HandlePilot 的一种风格，以我的口吻写一篇关于忙碌父母备餐的 7 页轮播图。”
• “研究我的竞争对手，并为我撰写下个月的内容策略。”
• 付费套餐：“在我的细分领域中找出 25 个值得学习的账号，并将它们添加到我的灵感列表。”
• 付费套餐：“把我的计划中最有潜力的创意改写成可直接拍摄的脚本，放到看板上，安排在下周二。”

Claude Code 插件

plugins/handlepilot/ 是一个 Claude Code 插件，已列入此仓库的市场目录（.claude-plugin/marketplace.json）。它在 .mcp.json 中声明远程服务，并将 HandlePilot 的操作手册转化为八项技能：入门、策略、发现、语气包、改编、轮播图、自定义风格和 Reels 剪辑。它不会运行任何本地代码。请参阅 plugins/handlepilot/README.md。

你的数据

• 已连接的应用或令牌可以访问你管理的每个工作区，并拥有与你在应用中相同的权限。你可以随时在 https://app.handlepilot.com/connect-ai 断开应用连接或撤销令牌。
• 工具返回的内容会由你的 Agent 的 AI 提供商读取（例如，ChatGPT 和 Codex 使用 OpenAI，Claude 使用 Anthropic），具体受你与该提供商之间的协议约束。
• HandlePilot 会按需获取 Instagram 公开数据。你的 Agent 不会向 Instagram 发布任何内容。
• 隐私政策：https://handlepilot.com/privacy
• 条款：https://handlepilot.com/terms

支持

• 电子邮件：[email protected]
• 漏洞和需求：提交问题。请勿在问题中粘贴令牌（hp_...）。
• 通过你的 Agent：让它发送反馈；HandlePilot 的 send_feedback 工具会将反馈直接发送给团队。

许可证

此仓库中的文件（文档、server.json、插件及其技能）采用 MIT 许可证；请参阅 LICENSE。HandlePilot 服务受其条款约束。

HandlePilot 是一款独立产品，与 Instagram 或 Meta 无关，也未获得它们的认可或赞助。Instagram 是 Meta Platforms, Inc. 的商标。