如何使用 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 来调试这三类 API。

打开 DbGate Central →

为什么用 Claude 调试 API？

因为读写操作复用了 DbGate Central 表格视图的同一套引擎，Claude 看到的数据和能力与你完全一致——永远不会超出你授予的访问权限。 这让它非常适合作为调试伙伴：

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

你用自然语言描述问题；Claude 负责自省架构、执行查询，并对结果进行推理——全程不需要离开对话窗口。

你需要准备什么

一个已经添加好要调试连接的 DbGate Central 工作区——包括一个 GraphQL 端点、一个 oData 端点（我们会以 Microsoft Dynamics 365 Business Central 为例），以及/或者一个 Shopify 商店。如果还没添加，请先查看连接到 API 端点。
一个支持自定义连接器（custom connectors） 的 Claude 账号。

第 1 步——在 DbGate Central 中创建 MCP 配置

打开 Settings（设置） 选项卡（活动栏底部的齿轮图标），创建一个新的 MCP profile（MCP 配置）。该配置会给出三个你马上要用到的值：

Server URL（服务器 URL）——格式为 https://central.dbgate.cloud/mcp/{profileId}
Client ID（客户端 ID）
Client Secret（客户端密钥）

把这三个值都复制下来。每个工作区可以拥有多个 MCP 配置，每个配置都有自己的 URL、凭据和逐连接授权——这样你就可以发放范围非常窄的访问权限（例如，一个配置只能看到单个只读连接）。

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

在 claude.ai 中，使用上一步的 Server URL 添加一个自定义连接器，并将 Client ID 和 Client Secret 作为 OAuth 凭据填写进去。

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

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

第 3 步——为每个连接授予访问权限

默认情况下，一个 MCP 配置对所有内容的访问权限都是 No access（无访问）——仅仅连接配置本身并不会共享任何东西。对于每一个你希望 Claude 能访问的连接，打开它的编辑器并设置 MCP access（MCP 访问） 级别：

No access（默认）——该连接对代理完全不可见。
Read-only（只读）——代理可以列出、查看和查询，但不能修改任何内容。
Writable（可写）——代理还可以更新行（仅限 Shopify，见下文）。

一个合理的调试起点是：为 GraphQL 和 Business Central 连接设置为 Read-only，只有在你确实希望 Claude 能做修改时，才为 Shopify 设置为 Writable。

Claude 能做什么

一旦连接被共享，Claude 就可以在 oData、GraphQL 和 Shopify 连接上使用这些工具：

List connections（列出连接）——列出该配置被允许使用的连接。
List entities（列出实体）——表、视图或目录实体。
Inspect the schema（查看架构）——列名和数据类型。
Query rows（查询行）——过滤、分页和选择数据。
Update rows（更新行）——仅限 Shopify，且只有在你授予 Writable 访问时才可用。

调试不同类型的 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 连接，并暴露产品、订单、客户、元字段（metafields）等数据。

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

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

如果——并且只有在——你授予了 Writable 访问权限，Claude 还可以直接做修复：

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

Claude 会调用 update_rows，该工具仅对 Shopify 可用，且需要 Writable 访问。它会通过匹配目标和值找到那条记录，然后应用你的更新。在只读连接上，这个工具根本不可用，因此代理永远无法修改你不打算暴露的数据。

你始终掌控一切

MCP 服务器的设计目标，是让你在与 AI 助手共享工作区时，永远不必放弃控制权：

默认不共享任何内容——每个连接一开始都是 No access。
逐连接授权——你可以为每个 MCP 配置精确决定哪些连接是只读、哪些是可写。
写操作是显式且范围有限的——update_rows 只存在于 Shopify，且仅在可写访问时启用。
安全性内建——认证使用 带 PKCE 的 OAuth 2.1，客户端密钥静态存储时会被加密。
永远不会比你看到得更多——代理使用与表格视图相同的引擎，因此它看到的数据和能力与你完全一致。

总结

通过在 DbGate Central 中创建 MCP 配置，并在 claude.ai 中添加自定义连接器，你就能让 Claude 成为 GraphQL、Business Central（oData）和 Shopify API 的实战调试伙伴——检查架构、运行查询，并在你允许的范围内直接应用修复。一次配置好，只授予必要的权限，然后开始“提问”，而不是“写查询”。