教程 /接入你的 AI

接入你的 AI

把一句话发给你的 AI,它会自己装好 PublishPort Skill,再给你一个授权链接;点一下授权就能驱动你这台电脑发布。也支持用 MCP 接入 Cursor、WorkBuddy、Cline、Claude、Codex 等客户端。

把下面这句话发给你的 AI(Claude Code、Codex、Cursor、OpenClaw、Gemini CLI 等能运行命令的 AI 都行):

读取 https://www.publishport.app/skill.md 并按说明为我配置 PublishPort。

客户端的接入 AI 页也有这句话,点复制即可。

接下来会发生什么

  1. AI 读完说明,先把 PublishPort Skill 装进它自己的 skills 目录,以后的会话都知道怎么发布。
  2. AI 运行 publishport login,给你一个授权链接和一个核对码。
  3. 你打开链接,登录(没有账号就顺手注册),确认页面上的核对码和 AI 给你的一致,点授权。
  4. AI 自动拿到凭据,再查一遍你的设备和平台登录状态,告诉你哪些已经能发、还差什么。

授权页会写明是哪台设备、从哪个地区发起的请求。不是你自己让 AI 发起的,就点拒绝。 授权等于允许这个 AI 通过 PublishPort 在你登录了客户端的电脑上执行命令;授权过的 AI 都列在网页账号页的「AI 接入」里,随时可以撤销。

AI 在云端也一样能用:命令经官方中转打回你这台电脑执行,AI 跑在哪台机器上都行。保持客户端开着就好。

改用 MCP

如果你的 AI 只支持 MCP、不能运行命令(例如部分聊天类客户端),或者你更习惯 MCP,也可以手动接入。

进入客户端的接入 AI 页,展开改用 MCP:

  1. 确认状态是本地执行器已连接(没连上先回安装那一步检查客户端是否在后台运行)。
  2. 点生成接入地址,会得到一条形如 https://…/mcp 的 MCP 地址,以及一段可直接复制的 JSON 配置。

这条地址就是钥匙。任何拿到它的 AI 都能调用你这台电脑,所以不要把它公开贴到聊天群、截图或代码仓库里。

一键复制 JSON 配置(Cursor / WorkBuddy / Cline 等)

大多数 GUI 客户端都用同一套 mcpServers 标准 JSON。客户端「接入 AI」页已经把你的地址填好,点复制拿到这段配置,再粘进对应客户端的 MCP 配置文件即可:

{
  "mcpServers": {
    "publishport": {
      "url": "https://…/mcp"
    }
  }
}

把 https://…/mcp 换成你自己的接入地址(客户端复制出来的已是完整地址,无需手改)。

各客户端粘贴位置:

  • Cursor:Settings → MCP → Add new MCP server,或直接编辑项目里的 .cursor/mcp.json / 全局 ~/.cursor/mcp.json,把上面的 mcpServers 片段合并进去。
  • WorkBuddy:在 MCP / 工具服务器设置里粘贴同一段 JSON。
  • Cline(VS Code 插件):点 Cline 面板顶部的 MCP Servers → Configure → Edit Configuration,把片段填进 cline_mcp_settings.json。
  • 其它 GUI 客户端:入口叫法各不相同(多是“Add MCP server / 添加工具服务器”),但基本都吃这套 mcpServers + url 的 JSON。

两个常见变体

有的客户端字段名不一样,直接复制上面的可能连不上,按下面改一下:

  • Windsurf:把 url 换成 serverUrl(文件在 ~/.codeium/windsurf/mcp_config.json):
    {
      "mcpServers": {
        "publishport": {
          "serverUrl": "https://…/mcp"
        }
      }
    }
  • VS Code(原生 MCP,非 Cline):顶层键是 servers(不是 mcpServers),且必须写明 "type": "http",否则会被当成本地 stdio 启动而失败(文件在 .vscode/mcp.json):
    {
      "servers": {
        "publishport": {
          "type": "http",
          "url": "https://…/mcp"
        }
      }
    }

命令行工具(Claude Code / Codex)

CLI 工具不用手改 JSON,客户端「接入 AI」页对它们给的是可直接复制到终端运行的命令:

  • Claude Code:
    claude mcp add --transport http publishport "<你的接入地址>"
  • Codex:
    codex mcp add publishport --url "<你的接入地址>"

接入其它 MCP 客户端

Claude 桌面版、Manus,以及任何支持 MCP 的 AI,都可以用通用接入地址:在「接入 AI」页复制那条通用地址,按对应客户端“添加一个 MCP / 工具服务器(HTTP 类型)“的入口填进去即可。不同客户端的叫法不一,但流程都是”添加一个 MCP 服务器“然后粘贴地址。

已有接入地址时用 CLI

拿到的接入地址也能直接交给官方 CLI,省掉浏览器授权:

npx publishport login "<你的接入地址>"

凭据存在 ~/.publishport/config.json(权限 600),和接入地址是同一把钥匙,同样不要外传。

确认接好了

接入成功后,可以让 AI 先“看一眼”能力,例如问它:

你现在能帮我发布到哪些平台?

AI 会通过 PublishPort 列出你这台电脑上已登录、可用的平台。看到列表,就说明通道打通了——可以去第一次让 AI 发布了。