奇 奇连 AI
学习路线图课程工具计算器企业服务关于加入会员

Macro 的应用体系与扩展点：MCP、GitHub 与自托管到底能接什么

2026-08-17

搜”Macro 能接什么”的人，心里通常压着三个不同的问题：我现在用的服务能不能连进去；我自己的编辑器、CLI、Agent 能不能读写它的数据；如果我不用官方托管、自己部署一套，会缺哪些东西。这三个问题的答案不在同一层上，混在一起看就会得出”能接很多”或者”什么都接不了”这类都不对的印象。

我把官方文档里跟这件事直接相关的三份材料对了一遍：客户端形态那份、GitHub 集成那份、MCP 接入那份。看完的结论是，Macro 的扩展点是分层的，而且各层的开放程度差得很远——MCP 那一层是标准协议，任何支持 MCP 的客户端都能连；GitHub 那一层是产品内写死的状态联动，不是通用集成框架；客户端那一层则纯粹是能力取舍问题。

下面按”外部程序怎么进来 / 外部服务怎么进来 / 你在哪端用”三条线拆，并且把文档明确没写的部分单独标出来。选型阶段最怕的就是把合理推断当成官方承诺，尤其是自托管这块。对 Macro 整体定位还没概念的，可以先看Macro 是什么再回来读这篇。

先把三层扩展点分清楚

三份文档描述的其实是三种性质完全不同的”接入”，放在一张表里对比更清楚：

层级具体形态谁来发起连接认证方式
协议层MCP 远程服务端，端点 https://mcp-server.macro.com/mcp外部 AI 客户端（Claude Code、Codex CLI、支持 JSON 配置的编辑器）客户端连接时走 Macro 的 OAuth 流程
服务集成层GitHub 集成用户在 Macro 设置里关联账号文档写明在 Settings → Account 里关联 GitHub 账号
客户端层Web（浏览器）、iOS App用户自己选择在哪端用同一个工作区

这张表里最值得注意的是方向。协议层是外部进来读写 Macro，服务集成层是 Macro 出去读第三方，两者的工程含义完全不同：前者你要考虑的是外部 Agent 的权限边界，后者你要考虑的是第三方账号授权。把它们笼统叫”集成”是选型时最容易踩的坑。

MCP：目前唯一面向任意客户端开放的口子

MCP 这一层的信息在三份文档里是最完整的，也是最”标准”的一层。几个关键事实照抄文档：

  • 端点固定为 https://mcp-server.macro.com/mcp；
  • 服务端是远程的，不需要在本地跑任何进程；
  • 认证在客户端发起连接时通过 Macro 的 OAuth 流程完成；
  • MCP 访问在所有 Macro 套餐上都可用，包括 Free。

最后一条对做技术选型的人价值不小——免费档就能连，意味着你可以先把链路跑通再谈付费，不用为了验证一个接口先掏钱。

三种接入方式文档都给了原样命令。Claude Code：

claude mcp add --transport http macro https://mcp-server.macro.com/mcp

加完之后启动 Claude Code，调用名为 macro 的 MCP 服务端，在浏览器里完成登录。Codex CLI 的写法不同，注意参数名不是 --transport 而是 --url：

codex mcp add macro --url https://mcp-server.macro.com/mcp

对于接受 JSON 配置的编辑器，在 mcpServers 下加这一段：

{
  "macro": {
    "type": "http",
    "url": "https://mcp-server.macro.com/mcp"
  }
}

然后从编辑器里触发一次连接，同样在浏览器里走完登录。

“服务端是远程的、不需要本地进程”这一句，是这层设计里最省事的地方。本地 MCP 服务端要操心的那一堆事——进程有没有起来、Node 或 Python 环境版本对不对、升级要不要重装、多台机器要不要各配一遍——在这里全部不存在，换机器只要重新走一次 OAuth。代价也很直白：链路完全依赖官方服务端，你在本地做不了任何降级或缓存。这一层想再深入的，我另外整理了Macro MCP 接入总览。

要提醒一句：这三份文档只写了怎么连，没有列出这个 MCP 服务端具体暴露了哪些工具、每个工具的参数是什么、权限粒度能不能按工作区或按资源类型收紧。这些官方文档在我手上这几份里未说明，连上之后自己看工具清单是唯一可靠的办法，不要照着别的产品的 MCP 能力去推。

GitHub 集成做的是一件很具体的事：任务状态跟着代码走

GitHub 这层不是通用的仓库接入，它解决的是一个非常窄的问题——让任务状态不用人手动改。文档写明的状态映射就三段：

你在代码侧的动作Macro 任务状态自动变为
为某个任务创建分支In Progress
打开对应的 Pull RequestIn Review
PR 合并Done

为了让”创建分支”能被正确关联，文档给了一个配套操作：选中任务后按 shift+cmd+b，复制该任务对应的分支名。这一步是整条链路的锚点——分支名是约定，不是自动嗅探，名字不对后面的状态跃迁就无从谈起。

关联上的 Pull Request 会作为信息挂在任务上，文档提到会带出 PR 的标题、PR 编号和 diff 规模，任务的属性里也有专门的 GitHub 分区列出所有已关联的 PR。更值得关注的是文档的这句定性：PR 在 Macro 里和其他东西一样是「块」（block），因此可以在频道和文档里 @ 提及，Agent 也能读它来获取上下文。这句话把 GitHub 集成从”状态同步”抬到了”给 Agent 供料”的位置——PR 不是一条外部链接，而是工作区里可被引用的一等对象。

边界同样要说清楚。文档只写了这三段跃迁，没有说明：PR 被关闭但未合并时任务会怎样、一个任务挂多个 PR 如何处理、反向联动（在 Macro 里改任务状态是否影响 PR）是否存在、以及 Issue 是否参与同步。这些都属于”文档未说明”，不要按其他工具的习惯默认。想看这层更细的拆解，可以读Macro 的 GitHub 集成。

客户端：桌面和 iOS 的能力差在哪

Macro 在任何现代浏览器里都能跑，访问 macro.com 即可，无需安装。文档把桌面端称为完整体验，理由给得也具体：键盘驱动的操作流，以及一个内置的窗口管理机制，允许在同一个标签页里以分屏（splits）方式并行处理多件事——文档的说法是，因此 Macro 可以替掉一堆浏览器标签页。

iOS App 在 App Store 上架，连的是同一个工作区，收件箱、邮件、频道、任务、文档和 Agent 都能在手机上用。Web 端的设置里也提供了移动端的获取入口。

文档明确列出了三项按设计只在桌面端提供的能力：

桌面独有能力文档给出的原因 / 移动端表现
分屏（splits）并排窗口管理需要屏幕宽度，移动端一次只处理一个块
键盘快捷键c 启动器、j/k 导航属于桌面特性
部分设置项管理邮件收件箱与连接器需在桌面端完成

第三条对”扩展点”这个话题影响最直接：连接器的管理只能在桌面端做。也就是说哪怕你日常主力在手机上，配集成这件事仍然得回到桌面。

Android 方面，官方标注为计划中，目前尚未提供。

托管版与自托管的差别，文档只给了一句话

这是最容易被过度解读的部分，所以我把文档的原意原样转述：面向自托管者的提示是，官方托管版本是拿到了 Apple、Google Mail 和 GitHub 三方审批的那一版，至于这对你自己的部署意味着什么，文档把读者指向了 FAQ。

我手上这三份文档不包含 FAQ 内容，所以到此为止。能确定的只有一点：这三项第三方接入的资格是绑在官方托管版上的，自托管不会自动继承——这是文档特意提醒自托管者的原因。至于自托管时需要自己申请什么、审批周期如何、缺了会退化成什么样，文档未说明，我不做推断。

同样属于”文档未说明”的还有：自托管实例能否使用同一个 MCP 端点、自托管下 GitHub 集成的配置路径是否相同、是否存在企业版差异。如果自托管是你的硬需求，正确做法是先去核 FAQ 和官方渠道，而不是照着托管版文档去做部署规划——本地环境的坑我在Macro 自托管与本地调起里另有整理。

什么时候它不适用，以及还有哪些没解决

按上面这些事实，有几类需求现在明显对不上：

  • 想要 Issue 双向同步的：文档只描述了分支/PR 驱动任务状态的单向跟随，Issue 未提及。
  • 主力在 Android 的：官方标注为计划中，目前尚未提供，没有替代方案的说法。
  • 需要在移动端配集成的：邮件收件箱和连接器的管理是桌面端能力，移动端做不了。
  • 想写自己的插件挂进去的：这三份文档里没有任何插件 SDK、Webhook、开放 API 的内容。目前对外的程序化入口只有 MCP 这一个，其余都是产品内置集成。
  • 打算靠自托管拿到与托管版完全一致能力的：至少 Apple、Google Mail、GitHub 这三项接入的差异是官方点名提示过的。

还有两处需要自己动手验证才能定论：MCP 服务端到底暴露了哪些工具和什么权限粒度；以及”Agent 能读 PR 上下文”这条说的是 Macro 工作区内的 Agent，外部通过 MCP 接进来的客户端能否拿到同样的 PR 上下文，文档没有明确对应关系。这两点决定了 Macro 在你的 Agent 工作流里是”数据源”还是只是”任务看板”，值得连上之后第一时间试清楚。

延伸阅读

本文依据 Macro 官方仓库（github.com/macro-inc/macro，AGPL-3.0 协议）的 apps/docs/ 产品文档、 MCP 工具参考与自托管说明整理，核对日 2026-08-17。 我们没有注册或运行过 Macro，因此不涉及界面外观与操作手感； 官方标注为计划中的能力文中已如实标明，不代表当前可用。 价格与额度以官网 macro.com 最新页面为准；许可证相关问题请咨询专业人士并以官方许可证原文为准。

想系统学会用 AI？报名体系课或加入会员，照着学、照着用。

浏览课程 加入会员