如何使用 Claude 调试你的 API

Published: 2026-07-14 | Jan Procházka

调试 API 通常意味着要在 Postman 集合之间来回切换、编写一次性脚本，或者手写查询，只是为了回答一个简单的问题，比如*“为什么这个字段是 null？”或“哪个订单卡住了？”*。如果你可以直接问呢？

DbGate Central 内置了一个 MCP（Model Context Protocol） 服务器，可以将你的 API 连接暴露给 Claude 等 AI 助手。连接完成后，Claude 就能像你一样探索和查询你的实时 GraphQL、Business Central (oData) 和 Shopify 连接——直接在聊天中完成，且访问权限始终由你掌控。

本指南将向你展示如何在几分钟内完成设置，然后使用 Claude 调试所有这三种连接。

打开 DbGate Central →

为什么用 Claude 调试 API？

由于读写操作复用了与 DbGate Central 表格相同的引擎，Claude 看到的数据和能力与你完全一致——绝不会超出你授予的访问权限。 这使它成为一个天然的调试伙伴：

“这个实体的架构到底是什么样的？”
“找出这个字段为 null 的记录，并告诉我它们有什么共同点。”
“哪个订单缺少履约记录，原因是什么？”

你用日常语言描述问题；Claude 会检查架构、运行查询，并对结果进行推理——你无需离开当前对话。

你需要准备什么

一个已经添加好待调试连接的 DbGate Central 工作区——一个 GraphQL 端点、一个 oData 端点（本文以 Microsoft Dynamics 365 Business Central 为例）和/或一个 Shopify 商店。如果你还没有添加这些连接，请参阅连接 API 端点。
一个支持自定义连接器的 Claude 账户。

第 1 步 - 在 DbGate Central 中创建 MCP 配置文件

打开设置选项卡（活动栏底部的齿轮图标），创建一个新的 MCP 配置文件。该配置文件会为你提供接下来需要用到的三个值：

服务器 URL - 格式为 https://central.dbgate.cloud/mcp/{profileId}
客户端 ID
客户端密钥

将这三个值全部复制下来。每个工作区可以拥有多个 MCP 配置文件，每个都有自己的 URL、凭据和按连接授予的权限——因此你可以分发范围受限的访问权限（例如，某个配置文件只能看到一个只读连接）。

第 2 步 - 在 claude.ai 中添加自定义连接器

在 claude.ai 中，使用上一步得到的服务器 URL，连同客户端 ID 和客户端密钥作为 OAuth 凭据，添加一个自定义连接器。

之后 Claude 会执行 带 PKCE 的 OAuth 2.1 握手流程：系统会要求你登录 DbGate 并进行授权，这会将该连接器绑定到特定的 MCP 配置文件和工作区。客户端密钥在静态存储时会被加密，在你完成此步骤之前，你的任何数据都不会被共享。

Configuring the DbGate Central custom connector in claude.ai
在 claude.ai 中添加 DbGate Central 自定义连接器

第 3 步 - 按连接授予访问权限

默认情况下，MCP 配置文件对所有内容都是无权限的——因此仅仅连接该配置文件本身不会共享任何数据。对于每个你希望 Claude 能够访问的连接，打开其编辑器并设置 MCP 访问级别：

无权限*（默认）* - 该连接对代理不可见。
只读 - 代理可以列出、检查和查询数据，但不能进行任何更改。
可写 - 代理还可以更新行数据（仅限 Shopify，详见下文）。

对于调试场景，一个合理的起点是：为你的 GraphQL 和 Business Central 连接设置只读权限，仅当你确实希望 Claude 对 Shopify 进行修改时，才为其设置可写权限。

Claude 能做什么

一旦连接被共享，Claude 就会获得针对 oData、GraphQL 和 Shopify 连接的以下工具：

列出连接 - 该配置文件被允许使用的连接。
列出实体 - 表、视图或目录实体。
检查架构 - 列名和类型。
查询行数据 - 过滤、分页并选取数据。
更新行数据 - 仅限 Shopify，且仅当你授予可写权限时才可用。

调试各类 API

下面展示了针对每种连接类型的真实调试会话是什么样子。提示词是日常语言——斜体部分是 Claude 在幕后运行的工具调用。

GraphQL

GraphQL 的灵活性同时也是它难以调试的原因：一个查询悄无声息地返回 null，你只能猜测问题出在架构、参数还是数据本身。让 Claude 替你梳理架构。

你：在我的 GraphQL 连接中，列出可用的实体，给我看看 orders 的架构，然后找出所有 total 为 null 的订单，并告诉我它们有什么共同点。

Claude 运行 list_entities 来发现视图，对 orders 运行 get_schema 以确认字段和类型，然后运行 query_rows 拉取有问题的记录——并对结果进行推理以发现规律（例如，这些记录全部缺少一个关联的 payment 节点）。

oData - Business Central

Microsoft Dynamics 365 Business Central 以 oData V4 服务的形式暴露其数据，DbGate Central 将其当作一组普通的表来处理。这使得 ERP 数据——客户、发票、分类账分录——可以用日常语言进行查询。

你：在我的 Business Central 连接中，找出客户“Contoso”上个月的销售发票，并汇总金额。

Claude 使用 query_rows，在幕后将你的请求翻译为 oData 查询选项——用 $filter 缩小到指定客户和日期范围，用 $select 选取列，用 $top/$skip 进行分页——然后为你汇总结果。

Shopify

对于 Shopify 商店，DbGate Central 通过 Shopify Admin API 进行连接，并暴露产品、订单、客户、元字段等数据。

你：找到订单 #1043，并告诉我它的履约为什么卡住了。

Claude 对你的 Shopify 连接运行 query_rows，定位该订单并检查其履约状态和行项目状态。

如果——且仅当——你已授予可写权限，Claude 还可以直接修复问题：

你：给那个订单加上标签 needs-review。

Claude 使用 update_rows，该工具仅适用于 Shopify，且需要可写权限。它会通过匹配目标和值找到记录，然后应用你的更新。在只读连接上，此工具根本不可用，因此代理永远无法更改你未打算暴露的数据。

主动权始终在你手中

MCP 服务器的设计理念是：将你的工作区与 AI 助手共享，绝不意味着放弃控制权：

默认不共享任何内容 - 每个连接的初始状态都是无权限。
按连接授权 - 你可以按 MCP 配置文件，精确决定哪些连接是只读、哪些是可写。
写入是可选且范围受限的 - update_rows 仅适用于 Shopify，且仅在具有可写权限时才存在。
安全设计 - 身份验证使用带 PKCE 的 OAuth 2.1，客户端密钥在静态存储时会被加密。
绝不超出你的权限 - 代理使用与表格相同的引擎，因此它看到的数据和能力与你完全一致。

结语

有了 DbGate Central 的 MCP 配置文件和 claude.ai 中的自定义连接器，Claude 就能成为你调试 GraphQL、Business Central (oData) 和 Shopify API 的得力助手——检查架构、运行查询，并在你允许的范围内直接应用修复。只需设置一次，只授予你需要的权限，然后开始用提问代替编写查询。