LyncoreLyncore
Lyncore

A2A 与 MCP API ​

Agent 间互操作（A2A 协议）与 MCP JSON-RPC 入口。

版本说明：A2A 与 MCP 两者都提供。个人版 AgentCard 为 lyncore-lite v2.0（开启 Streaming）。/.well-known/agent.json 公开以便协议互发现；/a2a/tasks/* 组需鉴权。

AgentCard ​

GET /.well-known/agent.json ​

Agent 能力卡片（A2A 互发现）。公开可读。

A2A 任务（需鉴权） ​

方法路径说明
POST/a2a/tasks/send提交 Agent 任务
POST/a2a/tasks/sendSubscribe提交并订阅 SSE 进度
GET/a2a/tasks/:id/status查询任务状态
DELETE/a2a/tasks/:id取消任务

MCP 入口 ​

POST /api/v1/mcp ​

MCP JSON-RPC 入口（单端点多方法）。需 Bearer 令牌。两者都提供。

bash
curl -X POST http://localhost:19824/api/v1/mcp \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

MCP REST 子端点（企业版独有） ​

企业版在 /api/v1/mcp 组上额外挂载一组独立 REST 端点，把常见 JSON-RPC 方法平铺为可直接调用的路径：

方法路径说明
POST/api/v1/mcp/initialize初始化握手
GET/api/v1/mcp/tools/list工具列表
POST/api/v1/mcp/tools/call调用工具
GET/api/v1/mcp/resources/list资源列表
GET/api/v1/mcp/prompts/list提示词列表

⚠️ 版本说明：以上 5 个 REST 子端点为企业版独有。个人版仅注册 POST /api/v1/mcp 单一 JSON-RPC 入口，initialize / tools/list 等在其下均为 JSON-RPC method，/api/v1/mcp/initialize 这类子路径在个人版不存在（返回 404）。MCP Server 的静态注册见 config.yaml 的 mcp_servers 段（重启生效）。

错误码 ​

场景codemessage
未认证40100缺失或非法 Authorization 头
任务不存在40400任务不存在
JSON-RPC 方法不存在40400method not found