知城开放能力

让城市数据,
连接你的 AI

一个 MCP 连接,按授权查询城市数据、指数与研究报告。
从获取密钥到完成第一次查询,在这里开始。

统一接入地址Streamable HTTPBearer 密钥认证
你的接入地址当前环境
https://www.datayicai.com/mcp/zhicheng
01 / 准备接入

三步,开始使用

已有密钥?直接前往客户端配置
  1. 1

    获取接入密钥

    登录知城,在 MCP 服务接入区域申请开通。已开通用户可查看自己的密钥。

    前往接入区域
  2. 2

    添加到客户端

    选择支持 Streamable HTTP 的客户端,填写服务地址,并配置密钥认证。

    查看配置示例
  3. 3

    确认工具并提问

    启用连接,确认工具目录加载成功,再从一个简单的城市问题开始。

    复制示例问题
02 / 连接客户端

选好客户端,复制对应配置

不同客户端的配置格式不同。以下示例只包含占位符,不会读取或填入你的真实密钥。

.cursor/mcp.json
{
  "mcpServers": {
    "zhicheng": {
      "url": "https://www.datayicai.com/mcp/zhicheng",
      "headers": {
        "Authorization": "Bearer <你的接入密钥>"
      }
    }
  }
}

密钥相当于调用凭证,请保存在客户端的安全配置中,不要放进公开代码、分享链接或对话内容。

03 / 了解能力

一个入口,三类研究能力

查找正式指标、识别地区,按统计期查询数值或比较城市。

发现指标

查找指标名称、单位、统计期与口径。

city_search_metrics

确定地区

解析城市名称及可用地区范围。

city_resolve_places

查询数值

读取指定地区、指标与统计期的数据。

city_query

比较与排名

在一致口径下比较城市或查询排名。

city_compare / city_rank

以上为常用工具示例。实际可调用范围以密钥授权与客户端返回的工具目录为准,参数以工具声明为准。

04 / 验证接入

从一个具体问题开始

确认客户端已启用知城工具,将下面的问题复制到客户端中。此处仅复制问题,不发起查询。

查城市数据

查询杭州市最新可用年份的常住人口,注明统计期、单位和数据来源。

看产业走势

查看苏州市城市产业魅力指数最近一年的走势,说明实际覆盖日期。

找研究文章

查找关于高新技术企业迁移的研究报告,列出标题、发布日期和原文链接。

怎样确认接入成功?客户端能加载已授权工具,并实际调用工具返回数据或文章。回答应带有统计期或发布日期,以及数据来源;只有模型的通用回答,还不能说明连接成功。

05 / 解决问题

遇到问题,先看这里

提示 401,或密钥无效怎么办?

确认已替换示例中的密钥占位符,Authorization 的值为 Bearer 加一个空格再加密钥。到「我的 MCP」检查密钥是否过期或已撤销,并确认它属于当前接入环境。

连接成功,但部分工具不可用?

工具权限由密钥决定,连接成功不代表已开通全部能力。遇到 403 或工具无权限提示,可在「我的 MCP」查看工具权限。本文列出的是能力示例,实际可调用工具以当前密钥的授权和客户端返回的目录为准。

为什么提示 429,或调用次数超限?

可能达到每分钟调用上限或每日额度。先降低请求频率,按错误提示稍后重试;在「我的 MCP」查看当前限额与调用记录。重复立即重试不会恢复额度。

地址打不开,或客户端一直连接中?

先确认客户端支持 Streamable HTTP 和自定义 Authorization 请求头。MCP 地址不是普通网页,浏览器直接打开不能验证接入成功。如果地址是 localhost 或 127.0.0.1,它只指向客户端所在机器,远程客户端需要可访问的服务地址。

能查到指标,为什么没有返回数值?

指标目录说明“可以查什么”,不代表每座城市、每个年份都有数值。先确认指标、地区和可用统计期,再查询实际数据;长列表或正文需继续读取后续页。缺值不等于零,也不能用部分城市代表全国。

管理你的接入

查看密钥权限、有效期和调用记录。

前往我的 MCP
知城统一 MCP 城市数据与研究,让每一次回答有据可查。