让 AI 客户端通过 MCP 调用 AskTable

独立容器的 HTTP transport 接受任意路径，不要求 /mcp/ 前缀；一体化镜像对外只暴露 /mcp/，nginx 会剥掉前缀再转给 8690。

Streamable HTTP 的配置（字段名以你的客户端为准）：

{
  "mcpServers": {
    "asktable": {
      "type": "http",
      "url": "https://mcp.asktable.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Authorization 头是必传的。服务端每个请求构造独立的客户端实例，不跨租户持有状态。

连上后让客户端列出工具，应该看到 43 个。按域分组如下：

列表类工具接受 page 和 size（size 上限 200），不传就走后端默认。

让客户端调用 chat_ask 发起提问。需要多轮时用 chat_followup 接上一次的对话。客户端提供 progressToken 时，这两个工具会在每次轮询之间发进度通知。

删除类工具（*_delete）的入参强制要求 confirm 为 true，不传会被判为参数错误。

需要单独调试或用 MCP Inspector 时，在 mcp/ 目录下起 stdio：

bun src/main.ts --stdio

stdio 模式下 Key 从环境变量取：

export ASKTABLE_API_URL='https://<你的 AskTable 站点>'
export ASKTABLE_API_KEY='YOUR_API_KEY'

服务端用 ASKTABLE_API_URL 指向 AskTable 的 API，默认值是 https://api.asktable.com；一体化镜像里它被设为 http://127.0.0.1:8688，走同容器 localhost。

客户端配置文件通常会被同步或备份。生产环境用客户端的密钥管理能力注入 Authorization，不要把 Key 明文留在配置仓库里。Key 泄露时立即到「设置」 → 「API-Key」删除该 Key 并重建。