API 概览
使用个人 API 密钥调用 AgentConnect REST API——列出 Agent、读取会话、在脚本和 CI 中驱动定时任务。
| 基础 URL | https://api.agentconnect.md/v1 |
|---|---|
| 版本 | v2.0.0 |
| OpenAPI 文档 | 下载 openapi.json (OpenAPI 3.1.0, 227 paths) |
控制台所做的一切都建立在 https://api.agentconnect.md 的 REST API 之上——你也可以自己调用它。在 AgentConnect OSS 上，内置栈在 <your-control-plane-url>/api/v1 提供同一套 API。个人 API 密钥以你的身份、带着你的角色、在一个组织中进行认证。
创建密钥
个人资料 → API 密钥 → 新建密钥：
- 组织——此密钥绑定的组织。
- 名称——可选的标签（“ci-runner”）。
- 权限——密钥可以调用什么：
- 完全访问——你的角色允许的一切。
- 只读——
GET接口，以及 MCP 连接器的读取工具。 - Agent 对话——只能为选中的 Agent 签发对话 token；见 Agent 对话 API。
- Agent——全部 Agent 或 指定 Agent。只有 Agent 对话权限会用到这个选择。
- 过期时间——30 / 60 / 90 天、1 年或永不过期（默认 90 天）。
密钥只显示一次——请当场复制。之后列表中只会显示密钥尾部、过期时间和最近使用时间。
密钥只能在控制台中管理。API 密钥不能列出、创建或撤销密钥，也不能创建或删除组织；这些请求会返回 403。
使用密钥
curl https://api.agentconnect.md/v1/orgs \
-H "Authorization: Bearer $AGENTCONNECT_API_KEY"所有资源都以组织为范围，位于 /v1/orgs/{orgId}/… 之下——列出 Agent、读取会话元数据和消息、管理定时任务、触发运行。每个操作都列在侧边栏中，并各自带有一个可以直接发送请求的调试面板；原始的 OpenAPI 文档链接在上方的表格里。
由于密钥携带你的角色，查看者的密钥只能读取而不能修改——很适合用于仪表盘。
同一个密钥也可以在无头客户端中为 MCP 连接器认证——把它作为 Authorization: Bearer 头传入，而不必走浏览器 OAuth 流程。
撤销
撤销会让密钥立即失效——仍在使用它的任何程序都会开始收到 401。轮换时请先创建新密钥，迁移你的脚本，然后再撤销旧密钥。
其他凭证（补充说明）
- Daemon 密钥——由添加 Daemon 生成，用于认证一台机器而不是一个人。只在安装命令中显示一次；删除 Daemon 时随之撤销。
- 机器人令牌——属于聊天平台；参见机器人。