把创作，接到你的
AI 工作流。

安装 MCP

航栈 MCP 通过 npm 分发，使用 stdio 连接：AI 客户端在你的电脑上启动服务，再通过 HTTPS 调用航栈。请选择支持本地命令的 MCP 客户端。

1. 安装 Node.js 22 或以上

从 Node.js 官网 安装符合版本要求的 LTS 版本，安装包已包含 npm 和 npx。安装完成后，重新打开终端（Windows 可使用 PowerShell），检查版本：

node -v
npm -v

node -v 应显示 v22 或更高版本，npm -v 应显示版本号。若提示找不到命令，请重新打开终端后再检查。

2. 验证航栈 MCP 安装包

在终端运行下面的命令。npx 会自动从 npm 下载指定版本，无需全局安装，也无需登录 npm 账号。

npx -y @vipbic/mcp@0.1.0 --version

看到 0.1.0，说明安装包已能运行。这个命令只检查版本；连接客户端时使用下方配置中的启动参数。

3. 添加到你的 MCP 客户端

先创建航栈专用令牌，再按客户端配置添加连接。配置里的 npx 会自动下载并启动同一个固定版本的服务，日常使用时由客户端管理进程。

如果在终端直接运行不含 --version 的服务命令，进程会等待 MCP 客户端的 stdio 请求，不会显示交互页面。目前不提供远程 MCP URL。

创建你的投稿令牌

客户端使用航栈的专用令牌访问你的内容。每个人都用自己的网站账号授权，可按客户端分别创建和撤销。

1. 登录航栈并验证邮箱

   投稿前需要验证登录邮箱，可在 账号设置 中完成。

2. 创建专用令牌

   进入 MCP 连接，给令牌起名、设置有效期并选择权限。完整令牌只展示一次，保存后可随时撤销。

3. 复制完整配置

   在令牌创建成功页面复制含令牌的完整配置，按下方说明添加到客户端。完整令牌使用 hz_mcp_ 前缀，不需要 npm 发布令牌。

连接 MCP 客户端

打开客户端的 MCP 服务配置，选择它支持的格式并添加下面的连接。command 使用 npx，args 指定固定版本 npm 包；客户端启动时会自动下载并运行服务。保存后按客户端提示重新加载连接，再调用 hangzhan_status 检查账号和权限。

下方提供通用 JSON 和 Codex TOML 模板，均不包含令牌；含令牌的完整配置可在创建专用令牌后复制，保存在自己的客户端中。

{
  "mcpServers": {
    "hangzhan": {
      "command": "npx",
      "args": [
        "-y",
        "@vipbic/mcp@0.1.0"
      ],
      "env": {
        "HANGZHAN_API_BASE": "https://www.vipbic.com/api",
        "HANGZHAN_SITE_URL": "https://www.vipbic.com"
      }
    }
  }
}

模板中的 command、args 和 env 由客户端读取。不同客户端可能使用不同配置文件；这份结构不代表所有客户端都已完成兼容测试。

先存草稿，再提交第一篇内容

你可以直接告诉 AI：“先查询航栈的文章分类，把这份 Markdown 保存为草稿，给我检查后再提交审核。”普通账号使用 mode: "submit" 投稿，mode: "draft" 保存草稿。

{
  "mode": "submit",
  "title": "我的第一次 MCP 创作实践",
  "summary": "记录用 MCP 整理创作内容并投稿到航栈的完整过程。",
  "content": "## 为什么尝试 MCP\n\n希望在整理好想法之后，直接从 AI 客户端把内容提交到航栈，减少重复复制。\n\n## 我的做法\n\n先确认资料与分类，再保存草稿、检查全文，最后提交审核。",
  "category": "替换为查询返回的文章分类名",
  "tags": [
    "MCP",
    "创作实践"
  ],
  "originalDeclared": true,
  "visibility": "PUBLIC"
}

先用 hangzhan_list_categories 查询 article，再用返回的真实分类名称替换示例。工具官网及免费、开源状态也应按核实后的资料填写。

提交时正文至少 20 个字符，文章与工具摘要至少 10 个字符。工具还需要官网、至少一个标签和一项完整的适用方向（capabilities），并明确是否免费、是否开源。

可调用的工具

“仅查询”令牌可以使用前四项；“查询和投稿”令牌还能保存和更新自己的内容。账号权限和网站审核规则继续生效。

hangzhan_status

检查连接、身份和当前可用权限

hangzhan_list_categories

查询文章、工具和讨论的可用分类

hangzhan_list_my_content

按标题、类型和状态查询自己的内容

hangzhan_get_my_content

读取自己内容的完整正文与编辑字段

hangzhan_publish_article

创建或更新文章，保存草稿、提交审核

hangzhan_publish_tool

创建或更新工具，补充官网与适用方向

hangzhan_publish_discussion

发起或更新讨论，提交社区审核

hangzhan_publish_existing_content

网站管理员登录会话继续发布已有待审内容

知道内容到了哪一步

修改之前，先读完整内容

先调用 hangzhan_get_my_content，再带上原 id 和完整字段更新。更新会替换原内容，省略的标签、图片或工具卡片可能被清空。已发布内容重新提交后也会进入审核。

连接超时，先查询再重试

服务不会自动重复写入。若超时未拿到结果，先用 hangzhan_list_my_content 按标题查询，避免重复创建；有 ID 时直接读取对应内容的实际状态。

令牌与访问出错时

• 401：令牌过期或已撤销，创建新令牌并更新客户端配置。
• 403：检查邮箱验证、账号状态以及令牌是否有投稿权限。
• 429：按返回的 retryAfter 等待，再继续操作。

只有已发布且可见性为 PUBLIC 的内容会返回公开链接。UNLISTED 与 PRIVATE 不开放站点公开详情接口。