01 / 人来操作
先配置，再启动
- 创建连接与同名只读授权
monica add work-github --repo your-org/repo
- 配置 AI 客户端（这里选 Codex）
monica mcp-config work-github --install codex
- 启动代理，保持这个终端打开
monica serve --proxy-grant my-model-client --session-minutes 60
- 在另一个终端验证通道
monica check work-github
使用自定义 --config 时，每一步和另一个终端都沿用同一路径。check 验证代理通道，AI 客户端仍需加载配置。
连接和授权可以不同名
在已有连接 work-github 上创建另一份授权：
monica grant review-agent --connection work-github --repo your-org/repo
monica next --grant review-agent
之后用 mcp-config review-agent、check review-agent、renew review-agent。续期只需主密码；它会轮换 capability，随后重启 MCP 并重新启动代理。
先摘要，再查一条命令
monica commands --summary --json
monica commands grant --json
摘要用来定位命令。完整说明包含参数角色、前提条件、执行影响、信任边界与重试规则；不必每次读取整棵语法树。
- 发现命令不等于获得执行权限。本地管理仍需人的授权；MCP 只提供当前 grant 允许的服务操作。
- AI 提交公开参数。受信执行器通过
--secrets-stdin 注入秘密；密码和 Token 不进对话、参数或环境变量。
--json 不弹提示。读取 error.code 和 error.recovery，先恢复前提条件。- 授权到期请人续期；写入结果不确定时先核对，不换新的
request_id 盲目重试。
MCP 内从 monica_list_connections {} 开始，读取授权工具和范围。CLI 的 commands 是另一层接口。
查看发现接口 →
Android API Key → 本地模型地址
用手机在 MDBX 中保存的 Key 代理 OpenAI 或 Anthropic 请求。模型客户端只拿到可撤销的本地 Key；原条目保持原生类型和身份。
monica library
monica bind work-ai --entry <ENTRY_ID> --protocol openai
monica grant my-model-client --connection work-ai --repo "*" --operation model-list --operation model-invoke
monica proxy-config my-model-client --output ./model-client.json
monica serve --proxy-grant my-model-client --session-minutes 60
OpenAI 本地地址默认 http://127.0.0.1:47831/v1；Anthropic 使用 --protocol anthropic，地址为 http://127.0.0.1:47831。让受信客户端读取输出文件的 base_url 和 api_key；文件应放在版本库外。
支持 JSON 与 SSE。一个本地 Key 选择一个上游，不转换协议。renew 后重新用 proxy-config --force 生成配置并让客户端重新载入。revoke 撤销授权；unbind 保留手机原条目。
serve --proxy-grant my-model-client --session-minutes 60 明确批准一小时模型代理；可重复指定授权。实际期限会在启动时显示，默认 Multi 仍有解锁后两小时的绝对上限。未指定代理授权时保留原新鲜认证规则。模型授权不能调用通用服务 API 或 Issue 工具。
查看完整接入步骤与限制 →
