生成 API Key 后，用一句话让 Codex App、Claude App 或其他 MCP 客户端接入面试档案、计划和复盘。
Agent API 与 MCP 接入
Agent API 可以把 Interview AiBox 的面试档案、计划、真实转写和复盘能力接入 Codex App、Claude App/Claude Code 或其他支持远程 MCP 的 AI 工具。你不需要先学习 API，生成 Key 后直接把下面这句话交给正在使用的 Agent 即可。
一句话完成接入
创建 API Key
打开 设置 → AI 接入与 Agent API → 创建 API Key。第一次使用建议先选择只读权限，创建后立即复制完整 Key。
把这句话和 Key 一起发给 Agent
在 Codex App、Claude App 或 Claude Code 的私聊窗口中，复制下面这段话，把 粘贴完整 Key 替换成刚生成的 Key：
请帮我接入 Interview AiBox MCP。API Key：粘贴完整 Key。Endpoint：https://api.interviewaibox.co/api/agent/mcp。请完成配置并验证 interview_aibox_* 工具可用，不要在回复、代码仓库或公开文件中回显 Key。配置完成后只告诉我结果。
如果 Agent 提示需要重启，按提示重启一次；工具列表出现 interview_aibox_* 后，就可以直接用自然语言操作。
经过验证的初始化器位于 https://interviewaibox.co/setup-agent-mcp.mjs；请把 Key 保存在 INTERVIEW_AIBOX_AGENT_API_KEY 环境变量中，需要在 shell 示例中取值时使用 ${INTERVIEW_AIBOX_AGENT_API_KEY}。
Key 只发给当前 Agent
完整 Key 可以明文粘贴给你正在使用的、可信的 Codex App 或 Claude App，但不要发到群聊、公开页面、截图或代码仓库。Key 只显示一次；如果泄露，请立即吊销并重新创建。
Agent 无法自动配置时：手动填写
在客户端新增一个远程 MCP 服务：Endpoint 填 https://api.interviewaibox.co/api/agent/mcp，请求头填 Authorization: Bearer <你的 API Key>。保存后重启客户端，并确认工具列表中出现 interview_aibox_*。
接入后可以这样说
复盘最近一场面试
读取我最近一场已完成面试的真实转写，告诉我哪些回答影响了质量，按“问题 → 我的回答证据 → 不足原因 → 下一步练习”整理。不要补写转写里没有的内容；如果生成正式复盘会消耗额度，请先征得我的确认。
准备下一场面试
找到我下一场面试计划，结合已关联的个人资料、岗位资料和补充知识，列出最重要的准备重点、缺少的案例和可能追问；只使用资料里真实存在的经历。
创建面试计划
为下周三的面试准备一条计划，关联我指定的个人资料、岗位资料和补充资料。先展示公司、岗位、时间和关联内容，等我确认后再创建。
权限怎么选
| 你想做什么 | 建议权限 |
|---|---|
| 查看账号与用量 | account:read、usage:read |
| 读取简历和岗位资料 | resumes:read、job_descriptions:read |
| 读取补充知识 | knowledge:read |
| 查看面试、真实转写和已有复盘 | interviews:read |
| 生成正式复盘 | interviews:analyze |
| 读取或创建面试计划 | plans:read、plans:write |
| 编辑或归档面试记录 | interviews:write、interviews:delete |
不确定时先用只读权限。写入、归档和生成正式复盘前，让 Agent 先展示操作并等待确认。
从准备到复盘的完整流程
先用 interview_aibox_interview_create 创建草稿，再用返回的面试 ID 和选定资料 ID 调用 interview_aibox_plan_create。桌面端面试结束后，调用 interview_aibox_interview_get 并传入 "include": "transcript,review"，与用户确认证据后再调用 interview_aibox_interview_analyze。Agent 自己的备注放在 metadata.notes；下一场准备内容使用 interview_aibox_plan_update。
常见问题
工具列表里没有 Interview AiBox
按 Agent 提示重启客户端，确认它支持远程 HTTP MCP、Endpoint 没有写错，并且本地配置仍保存了刚生成的 Key。
提示权限不足
回到设置页创建一个包含所需权限的新 Key。已有 Key 不会自动增加权限。
Key 泄露了
立即在设置页吊销旧 Key，再创建替换 Key。
Endpoint 返回 404
通常表示当前环境尚未启用 Agent API 或部署尚未同步，不一定是 Key 错误；请联系支持或稍后重试。
继续阅读
AI 助读
一键发送到常用 AI
智能总结
深度解读
考点定位
思路启发