连接 AI 客户端

通过模型上下文协议(MCP),让 AI 客户端查询已发布的模型,或执行获准的建模操作。

本页目录

开启所需的 MCP 服务

管理员在运行配置 → MCP 服务中分别启用查询和建模。两项服务默认关闭。需要通过客户端发布时,再开启发布权限。

/mcp/query
列出可见模型,获取已发布的结构,执行有界的只读查询。
/mcp/modeling
读取、校验、创建和保存获准的草稿。发布需要服务端开启且账号具备发布权限。

在客户端注册 GraphLake

在控制台打开 AI,生成个人令牌并存入客户端的凭据配置。按需为每个服务添加一项 Streamable HTTP MCP 配置。将示例域名替换为 GraphLake 对外的 HTTPS 地址,在 Authorization 请求头中使用令牌。

JSON
{
  "mcpServers": {
    "graphlake-query": {
      "url": "https://graphlake.example/mcp/query",
      "headers": {
        "Authorization": "Bearer <PERSONAL_AI_TOKEN>"
      }
    }
  }
}

令牌沿用所属账号当前的模型权限与租户范围。管理员也可为允许接入 MCP 的成员签发令牌。在 AI 工作区测试连接,核对认证身份和可见工具。

发起第一次请求

请客户端先列出有权访问的模型,再查看其已发布结构并执行一条小查询。建模时先读取当前草稿和版本,校验并保存,审核后再发布。角色检查、令牌轮换和查询限制见MCP 参考。