--- name: aifa description: 接入 AIFA 杂志（中英双语杂志与它的内容系统），经 MCP 替用户阅读与管理收藏与订单、写稿排版发布、或处理后台事务。用户要在 AIFA 上以读者、作者或管理员身份让 Agent 代办时使用。Use when the user asks an agent to act on AIFA Magazine via its MCP servers as a reader, an author or an admin. --- # AIFA 杂志：Agent 入口 本文件地址：https://afa5.chaos.callai.online/mcp-guide/skills/SKILL.md（由站点按当前对外地址生成，文中地址都可直接使用）。 AIFA 是一本中英双语杂志，也是它自己的内容系统。你替授权你的 AIFA 账号做事，改动都记在它名下。先连接并授权，技能与说明在授权之后取。 ## 第一步：连接并授权（选第一条走得通的路） 授权页由用户本人登录、选档位、点同意；同意页只认网页登录会话。 1. 终端就在用户这台电脑上（本机有 Node）：`npx -y https://afa5.chaos.callai.online/cli/aifa.tgz login`。它打印授权链接，能开浏览器时自动打开；打不开就把链接原样发给用户。写稿、排版、上传图片与配音都用这个命令（把 login 换成 --help 看用法），不用重开会话。在云端电脑上跑命令的不要 login（回跳 127.0.0.1，用户的浏览器连不到）：请用户在 https://afa5.chaos.callai.online/account/agents 点「签发令牌」，本人把令牌设成你那台机器的环境变量 `AIFA_TOKEN`（不要贴进对话），再运行 `npx -y https://afa5.chaos.callai.online/cli/aifa.tgz status` 确认已连上。 2. 能添加自定义 MCP 连接器（在设置里加，或在对话里自己加都算）：添加单一入口 `https://afa5.chaos.callai.online/mcp`（传输选 Streamable HTTP，鉴权选 OAuth 登录，不填密钥），马上连接即触发授权，弹不出授权页就把登录链接发给用户；阅读、收藏、订单与后台都经它。Claude Code：`claude mcp add --transport http aifa-magazine https://afa5.chaos.callai.online/mcp && claude mcp login aifa-magazine`，或在 `/mcp` 选 `aifa-magazine` 点 Authenticate；会话中途加的服务要重开会话才出现工具。 3. 以上都做不到，照实告诉用户是哪一种： - 连接器要用户在界面里手动加：把第 2 条的地址交给用户，只说你确定的添加位置；不确定就说「在设置里找连接器、插件或 MCP，新建自定义，类型 HTTP，粘贴这个地址」，不要编造菜单名。 - 连接器只能填固定令牌或请求头，走不了 OAuth 登录：请用户在上面的账号页点「签发令牌」，本人填进连接器设置（地址用第 2 条的，请求头 `Authorization: Bearer` 加令牌），不要贴进对话。 - 完全接不了外部工具：直说接不了；能上网的话可以替用户读 AIFA 的公开单篇，但动不了账号。 按用户要做的事选：写稿排版走 1，阅读与后台走 2，都要就都接；没说就走能走的第一条。客户端弹不出浏览器时，把授权链接（形如 `https://afa5.chaos.callai.online/api/oauth/authorize?…`，由客户端生成）原样发给用户。用户没登录会先去 https://afa5.chaos.callai.online/account/login；授权后在 https://afa5.chaos.callai.online/account/agents 查看与吊销。发现地址（自己实现 OAuth 从这里起）：`https://afa5.chaos.callai.online/.well-known/oauth-protected-resource/mcp`、`https://afa5.chaos.callai.online/.well-known/oauth-authorization-server`。 ## 第二步：授权之后经 MCP 取 - 走命令行的按 `--help` 与连接时下发的说明做事。走 MCP 的：连上时下发的说明按用户选的档位写好，就是你的必读；先调 `permissions.retrieve` 核对 `principal` 与 `capabilities`。 - 技能：`aifa_skill` 列出（facet=list）、取全文（facet=file）；写稿先读 `aifa-author/SKILL.md`（技能正文不会自动送达）。 - 调不动是档位不够：请用户在 https://afa5.chaos.callai.online/account/agents 重新授权。 ## 连不上时 - 不带令牌请求端点回 401 是授权的起点，不是故障。 - 请求超时或连不上：多半是你所在环境出网受限或代理没配，先查网络与代理，不行就换一个能联网的客户端。 - 客户端不支持 OAuth：回到第一步，按 1、2、3 选第一条走得通的。 - 个人访问令牌回 401「已到期」或「已被吊销」：刷新没用，请用户重新签发。 - 不连 MCP 也能读的公开副本：技能清单 https://afa5.chaos.callai.online/mcp-guide/skills、整包 https://afa5.chaos.callai.online/mcp-guide/skills.zip、说明页 https://afa5.chaos.callai.online/mcp-guide.md（以说明页和工具自己的说明为准）。