API
管理 API，面向 你的整个实例
把 dashboard 能做的一切都变成 REST。创建 connector、生成工具、切换 code mode、签发密钥并运行 File Search — 来自脚本、CI 作业或 agent。
# a management key from the dashboard or `amcp login --browser`$ export AMCP_API_KEY=amk_live_xxx# the CLI resolves the base URL and auth for you$ amcp api GET /api/connectors$ amcp api POST /api/mcp-servers --data '{"name":"ops"}'# or call the HTTP API directly$ curl -H "Authorization: Bearer $AMCP_API_KEY" \ https://cloud.anythingmcp.com/api/connectors
认证
两个 realm 可以访问 API，且都尊重你的角色。选择适合调用方的那个。
会话 (JWT)
dashboard 中已登录的用户。无需配置 — 浏览器携带会话。
管理密钥
面向脚本和 agent。在设置中或通过 `amcp login --browser` 签发带 scope 的密钥，然后作为 Bearer token 发送。
scope — 密钥带有 scope — management-read 或 management-admin — 其实际权限取密钥 scope 与所有者角色中较小的一个。agent 密钥默认 read-only。
你可以调用什么
200 多个操作，按资源分组。在交互式参考中浏览完整且始终最新的 schema。
Connectors
/api/connectors创建 connector 并从 OpenAPI、WSDL、GraphQL、Postman、cURL 或 HAR 导入工具 — 或从 MCP server 发现它们。
Tools
/api/connectors/:id/tools列出、创建、更新和删除 connector 暴露的工具，连同它们的输入 schema。
MCP servers
/api/mcp-servers创建 server、分配工具和角色，并在 off、tools 和 inline 之间切换 code mode。
Adapters
/api/adapters按 slug 从内置的现成 connector 目录中导入。
API keys
/api/mcp-keys签发、列出和吊销 MCP 以及 management-scoped 密钥 — 自助式，绑定到你的账户。
File Search
/api/file-search管理可搜索的 space 和文件夹，让 agent 能从你的文档中检索。
约定
Base URL
在 Cloud 上为 cloud.anythingmcp.com，self-hosted 时为你自己的主机。CLI 会为你解析。
认证头
Authorization: Bearer <key>。同一个 guard 也接受会话 JWT。
格式
JSON 入、JSON 出。用 --data（CLI）或 Content-Type: application/json（HTTP）发送请求体。
作用范围
每个查询都限定在你的组织内；密钥永远无法触及其他 tenant 的数据。
速率限制
默认每个密钥每分钟 300 个请求，运营者可调整。429 表示请放慢。
错误
标准 HTTP 状态码；401 认证错误或缺失，403 scope 或角色过低，404 未找到。