Jarvis Registry REST API 速查手册MCP 服务器与 A2A Agent 核心端点与 Scopes 完整一览【免费下载链接】jarvis-registryConnect any AI copilot or autonomous agent to your enterprise tools — through a single, secure MCP/Agent gateway with built-in identity, access control, and full observability.项目地址: https://gitcode.com/gh_mirrors/ja/jarvis-registryJarvis Registry 是连接 AI 编程助手与自主 Agent 到企业工具的 MCP/Agent 安全网关内置身份认证、访问控制ACL与全链路可观测性。本文作为一份REST API 速查手册帮你快速上手 MCP 服务器与 A2A Agent 管理的核心端点并一次性看懂 RBAC Scopes 权限体系。快速认识Jarvis Registry 网关架构Jarvis Registry 由registry注册中心 API、auth-server认证服务、MCP Gateway 代理层组成。所有管理接口统一挂载在/api/v1前缀下版本见 core/config.py 的api_version配置路由注册逻辑集中在 routers.py。调用方式很简单核心只有两类认证API 调用JWT Bearer Token放在Authorization: Bearer token请求头中控制台 UIOAuth2 登录后的 Session Cookie。没有可用令牌时可先调用个人令牌生成端点POST /api/v1/tokens/generate源码见 token_routes.py获取。MCP 服务器管理核心端点速查表MCP 服务器是 Jarvis Registry 的一等资源路由实现在 server_routes.py。方法端点作用GET/api/v1/servers列出已注册的 MCP 服务器GET/api/v1/servers/{server_id}获取单个服务器详情POST/api/v1/servers注册新 MCP 服务器PATCH/api/v1/servers/{server_id}修改服务器配置DELETE/api/v1/servers/{server_id}删除服务器POST/api/v1/servers/{server_id}/toggle启用/禁用服务器POST/api/v1/servers/{server_id}/refresh重新探测能力健康检查 工具发现GET / PATCH/api/v1/servers/{server_id}/tools查看/更新工具启用状态POST/api/v1/servers/connection触发客户端连接GET/api/v1/servers/stats全局服务器统计需system-opsMCP 连接与 OAuth 管理端点当下游 MCP 服务器需要用户级 OAuth 授权时常用端点包括源码见 oauth_router.py 与 connection_router.pyGET /api/v1/mcp/oauth/discover— 探测 OAuth 元数据GET /api/v1/mcp/{server_id}/oauth/initiate— 发起授权流程GET /api/v1/mcp/{server_path}/oauth/callback— OAuth 回调GET /api/v1/mcp/oauth/tokens/{flow_id}— 拉取授权令牌POST /api/v1/mcp/oauth/refresh/{server_id}— 刷新令牌POST /api/v1/mcp/{server_id}/reinitialize— 重连会话GET /api/v1/mcp/connection/status— 查询连接状态GET /api/v1/mcp/{server_name}/auth-values— 查看已配置的认证值代理转发层由mcp-proxy-ops/a2a-proxy-ops两个 scope 保护实际流量走/proxy/mcpgw/mcp、/proxy/server/{path}、/proxy/a2a/{path}会话清理端点为DELETE /proxy/sessions/{server_id}。A2A Agent 管理核心端点速查表A2A Agent 是 Jarvis Registry 的另一类一等资源支持 Agent Card 同步与能力发现路由实现在 agent_routes.py。方法端点作用GET/api/v1/agents列出已注册 AgentGET/api/v1/agents/{agent_id}获取 Agent 详情POST/api/v1/agents注册新 A2A AgentPATCH/api/v1/agents/{agent_id}修改 Agent 配置DELETE/api/v1/agents/{agent_id}删除 AgentPOST/api/v1/agents/{agent_id}/toggle启用/禁用 AgentPOST/api/v1/agents/{agent_id}/refresh从.well-known/agent-card.json刷新技能POST/api/v1/agents/{agent_id}/wellknown同步 Agent CardGET/api/v1/agents/{agent_id}/skills查看 Agent 技能GET/api/v1/agents/.well-known/agent-cards按 URL 获取 Agent CardA2A 协议GET/api/v1/agents/statsAgent 统计信息Scopes 权限体系角色与端点对照Scopes 是 Jarvis Registry RBAC 的核心定义在 scopes.yml设计说明见 docs/design/scopes.md。核心 scope 与对应能力如下Scope覆盖端点说明servers-readGET /servers、GET /servers/{id}、GET /servers/{id}/tools查看 MCP 服务器、工具与连接状态servers-writePOST/PATCH/DELETE /servers/**、toggle、refresh注册、修改、删除、启停、刷新servers-sharePUT /permissions/mcpServer/{id}管理 MCP 服务器 ACLagents-readGET /agents、/agents/{id}、/skills、/rating、well-known查看与发现 Agentagents-writePOST/PATCH/DELETE /agents/**、wellknown注册与管理 A2A Agentagents-sharePUT /permissions/agent/{id}管理 Agent ACLfederations-read/federations-writeGET/POST/PUT/DELETE /federations/**、/sync联邦注册表连接管理user-read/auth/me、/version、/tokens/generate、/search、/mcp/*个人账号、令牌、搜索、MCP 连接acl-read/acl-writeGET/PUT /permissions/**查看与变更资源 ACLmcp-proxy-ops/a2a-proxy-ops/proxy/mcpgw/mcp、/proxy/server/、/proxy/a2a/代理调用工具与 Agentsystem-opsGET /servers/stats、/admin/tokens全局统计与管理员令牌四个内置角色的 Scope 组合角色用户组权限范围jarvis-registry-admin全部 scope含system-opsjarvis-registry-power-user读写 共享*-share ACL无system-opsjarvis-registry-user读写资源但不可共享、不可写 ACLjarvis-registry-read-only仅 *-read 与user-read⚠️ 注意federations-read/federations-write只控制端点访问具体资源可见性仍由 ACL 二层模型过滤二者配合使用。共享与 ACL 管理端点资源级共享走通用 ACL 接口源码见 acl_routes.pyGET /api/v1/permissions/search-principals— 搜索可授权的用户/用户组GET /api/v1/permissions/{resource_type}/{resource_id}— 查看资源权限PUT /api/v1/permissions/{resource_type}/{resource_id}— 变更资源权限GET /api/v1/permissions/{resource_type}/roles— 查询角色其中resource_type支持mcpServer、agent、federation、workflow等。一个易踩的坑共享 federation 不会级联共享其下同步来的 MCP 服务器或 Agent子资源需独立授权。最小实战示例三步调用 REST API# 1. 生成个人令牌控制台登录后调用 curl -X POST $BASE/api/v1/tokens/generate \ -H Cookie: mcp_gateway_session$SESSION # 2. 列出所有 MCP 服务器 curl $BASE/api/v1/servers -H Authorization: Bearer $TOKEN # 3. 按语义搜索服务器与 Agent curl -X POST $BASE/api/v1/search \ -H Authorization: Bearer $TOKEN \ -d {query: 查询天气的 MCP 工具}完整端点清单含请求/响应示例与 OpenAPI 说明可参阅 docs/api-reference.md 与旧版接口文档 docs/registry_api.md。核心文件导航MCP 服务器路由server_routes.pyA2A Agent 路由agent_routes.py联邦注册表路由federation_routes.py路由汇总注册routers.pyScopes 与角色定义scopes.yml权限设计文档docs/design/scopes.mdAPI 完整参考docs/api-reference.md掌握以上端点与 Scopes你就能用 REST API 完成 Jarvis Registry 中 MCP 服务器与 A2A Agent 的注册、发现、共享与代理调用全流程 【免费下载链接】jarvis-registryConnect any AI copilot or autonomous agent to your enterprise tools — through a single, secure MCP/Agent gateway with built-in identity, access control, and full observability.项目地址: https://gitcode.com/gh_mirrors/ja/jarvis-registry创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考