跳到主要内容
MetaxisData
EN

Agent 集成

为「程序来调用」而设计

mxd 命令行客户端让 Agent 每条命令只拿到一个 JSON 文档、退出码稳定，并支持设备码登录。启用 MCP 后，注册中心还会以只读工具的形式提供，由 OAuth 2.1 授权服务器保护。

对一个 Agent 来说，元数据平台只有把答案做成机器可读的形态才有用。两个入口都是只读的、按名字而不是内部 id 寻址，并且都会留痕。

mxd —— 每条命令一个 JSON 文档

每条命令只会往 stdout 写一个 JSON 文档，进度、警告和错误都走 stderr。失败会带上稳定的 code 与退出码，调用方无需解析自然语言就能决定下一步。mxd skill install 会把对应指令放到 Agent 运行时能找到的位置。 

$ mxd lineage sql --file etl.sql --depth 2
{
  "results": [
    {
      "scopeName": "dev",
      "scopeGuid": "1;shop",
      "relations": [
        {"sourceGuid": "1;shop;;orders", "sourceColumn": "amount",
         "targetGuid": "1;shop;;order_daily", "targetColumn": "amount",
         "isTemp": false}
      ],
      "warnings": []
    }
  ],
  "warnings": []
}

MCP —— 注册中心变成只读工具

在设置 → 通用设置里启用端点（需要先配置工作区外部地址）。MCP 客户端会被告知去哪里授权、自行注册并走 PKCE 流程，决定会记录在同意页面上。这里没有任何写操作。 

{
  "mcpServers": {
    "metaxisdata": {
      "type": "http",
      "url": "https://mx.example.com/mcp"
    }
  }
}

已知限制

  • 这里没有任何写操作：CLI 与 MCP 只读注册中心。
  • 分析范围从不落盘——一条语句属于哪个实例由调用方决定，每次调用时传入。

延伸阅读