AskTable
免费试用

MCP 快速开始：5 分钟让 Claude 连接你的数据库

AskTable 团队
AskTable 团队 2026-03-08

想让 Claude Desktop 直接查询你的数据库吗？只需 5 分钟，跟着本文的步骤，你就能体验到 AI 驱动的数据分析。

本文将手把手教你配置 AskTable MCP Server，让 Claude 拥有数据查询能力。

一、准备工作

1. 你需要什么？

必需：

可选：

  • •📊 你自己的数据库（MySQL、PostgreSQL 等）
  • •🔑 如果没有，可以使用我们提供的演示数据

时间：5-10 分钟

二、方式一：使用演示数据（最快）

这是最快的体验方式，无需任何安装，直接使用我们提供的演示数据。

步骤 1：打开 Claude Desktop 配置文件

macOS：

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

notepad %APPDATA%\Claude\claude_desktop_config.json

如果文件不存在，创建一个新文件。

步骤 2：添加 MCP 配置

将以下内容复制到配置文件中：

{
  "mcpServers": {
    "asktable": {
      "type": "sse",
      "url": "https://mcp.asktable.com/sse/?api_key=ASKER_8H8DRJCH6LT8HCJPXOH4&datasource_id=ds_6iewvP4cpSyhO76P2Tv8MW",
      "headers": {},
      "timeout": 300,
      "sse_read_timeout": 300
    }
  }
}

配置说明：

  • •type: "sse"：使用 SSE 协议（推荐）
  • •url：MCP Server 地址，包含演示账号的 API Key 和数据源 ID
  • •timeout：请求超时时间（秒）
  • •sse_read_timeout：SSE 连接超时时间（秒）

步骤 3：重启 Claude Desktop

保存配置文件后，完全退出并重新打开 Claude Desktop。

步骤 4：测试连接

在 Claude Desktop 中输入：

你好，请帮我查询一下总共有多少学生？

如果配置成功，Claude 会：

  1. •识别到可以使用 AskTable 工具
  2. •调用 query 工具查询数据
  3. •返回查询结果

预期输出：

根据查询结果，总共有 200 名学生。

步骤 5：尝试更多查询

现在你可以尝试各种查询：

基础查询：

  • •"有多少个班级？"
  • •"列出所有课程名称"
  • •"查询学生的平均年龄"

复杂查询：

  • •"每个班级有多少学生？"
  • •"哪个课程的学生最多？"
  • •"查询年龄大于 20 岁的学生数量"

生成 SQL：

  • •"生成查询所有学生的 SQL"
  • •"写一个 SQL 统计每个班级的人数"

三、方式二：连接你自己的数据库

如果你想连接自己的数据库，需要先在 AskTable 中添加数据源。

步骤 1：登录 AskTable

访问 asktable.com 并登录。

步骤 2：添加数据源

  1. •点击"数据源"菜单
  2. •点击"添加数据源"
  3. •选择数据库类型（MySQL、PostgreSQL 等）
  4. •填写连接信息：
    • •主机地址
    • •端口
    • •数据库名
    • •用户名
    • •密码
  5. •测试连接
  6. •保存

步骤 3：获取 API Key 和数据源 ID

获取 API Key：

  1. •点击右上角头像
  2. •选择"设置"
  3. •在"API 密钥"标签页中创建或复制 API Key

获取数据源 ID：

  1. •在"数据源"列表中
  2. •点击你刚创建的数据源
  3. •在 URL 中可以看到数据源 ID（格式：ds_xxxxx）

步骤 4：更新 Claude Desktop 配置

将配置文件中的 api_key 和 datasource_id 替换为你自己的：

{
  "mcpServers": {
    "asktable": {
      "type": "sse",
      "url": "https://mcp.asktable.com/sse/?api_key=YOUR_API_KEY&datasource_id=YOUR_DATASOURCE_ID",
      "headers": {},
      "timeout": 300,
      "sse_read_timeout": 300
    }
  }
}

步骤 5：重启并测试

重启 Claude Desktop，然后尝试查询你的数据。

四、方式三：使用 Stdio 模式（需要安装）

如果你更喜欢本地运行 MCP Server，可以使用 Stdio 模式。

步骤 1：安装 MCP Server

使用 uv 安装（推荐）：

# 安装 uv（如果还没有）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装 AskTable MCP Server
uvx asktable-mcp-server@latest

或使用 pip：

pip install asktable-mcp-server

步骤 2：配置 Claude Desktop

{
  "mcpServers": {
    "asktable": {
      "command": "uvx",
      "args": ["asktable-mcp-server@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY",
        "DATASOURCE_ID": "YOUR_DATASOURCE_ID"
      }
    }
  }
}

配置说明：

  • •command：启动命令
  • •args：命令参数
  • •env：环境变量（API Key 和数据源 ID）

步骤 3：重启并测试

重启 Claude Desktop，测试查询功能。

五、验证配置是否成功

1. 检查 MCP 连接状态

在 Claude Desktop 中，你应该能看到：

  • •左下角有一个"工具"图标
  • •点击后可以看到"使用 AskTable 查询数据"和"使用 AskTable 生成 SQL"两个工具

2. 测试基础查询

输入一个简单的查询：

查询数据库中有多少张表？

如果返回了结果，说明配置成功！

3. 测试 SQL 生成

输入：

生成一个查询所有用户的 SQL

如果返回了 SQL 语句，说明两个工具都正常工作。

六、常见问题

1. Claude Desktop 找不到配置文件

问题：配置文件路径不存在

解决方案：

  • •手动创建目录和文件
  • •macOS: mkdir -p ~/Library/Application\ Support/Claude && touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • •Windows: 在 %APPDATA%\Claude\ 目录下创建 claude_desktop_config.json

2. 配置后没有看到工具

问题：重启后仍然看不到 AskTable 工具

解决方案：

  1. •检查配置文件格式是否正确（JSON 格式）
  2. •确保完全退出了 Claude Desktop（不是最小化）
  3. •查看 Claude Desktop 的日志文件：
    • •macOS: ~/Library/Logs/Claude/mcp*.log
    • •Windows: %APPDATA%\Claude\logs\mcp*.log

3. API Key 无效

问题：提示 "api_key must be set" 或 "Invalid API key"

解决方案：

  1. •检查 API Key 是否正确复制（没有多余空格）
  2. •确认 API Key 没有过期
  3. •在 AskTable 网站上重新生成 API Key

4. 查询超时

问题：查询一直没有返回结果

解决方案：

  1. •增加 timeout 和 sse_read_timeout 的值（如 600 秒）
  2. •检查网络连接
  3. •尝试更简单的查询

5. Stdio 模式启动失败

问题：使用 Stdio 模式时，工具无法启动

解决方案：

  1. •确认已正确安装 asktable-mcp-server
  2. •尝试手动运行：uvx asktable-mcp-server@latest
  3. •检查环境变量是否正确设置

七、下一步

恭喜！你已经成功配置了 AskTable MCP Server。

继续学习：

实践建议：

  1. •尝试各种类型的查询，熟悉工具能力
  2. •探索权限控制功能（role_id 和 role_variables）
  3. •将 MCP 集成到你的日常工作流程中

获取帮助：

相关阅读：

技术交流：

cta.readyToSimplify

无需编程，用自然语言提问，AI 自动生成 SQL 查询和可视化图表。立即免费试用 AskTable，体验 AI 驱动的数据分析。

cta.startFreecta.viewPricing
cta.noCreditCard
cta.quickStart
cta.dbSupport