Cómo usar Claude para depurar tus API

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

Depurar una API suele significar estar malabareando colecciones de Postman, escribiendo scripts desechables o componiendo consultas a mano solo para responder a una pregunta sencilla como «¿por qué este campo es null?» o «¿qué pedido está atascado?». ¿Y si pudieras simplemente preguntar?

DbGate Central incluye un servidor integrado de MCP (Model Context Protocol) que expone tus conexiones de API a asistentes de IA como Claude. Una vez conectado, Claude puede explorar y consultar tus conexiones en vivo de GraphQL, Business Central (oData) y Shopify de la misma forma que tú lo haces: directamente desde el chat, con un acceso que sigues controlando.

Esta guía te muestra cómo configurarlo en unos minutos y luego usar Claude para depurar los tres tipos de conexión.

Abrir DbGate Central →

Por qué depurar API con Claude

Como las operaciones de lectura y escritura reutilizan el mismo motor que la cuadrícula de DbGate Central, Claude ve exactamente los mismos datos y capacidades que tú, nunca más acceso del que le concedes. Eso lo convierte en un compañero natural para la depuración:

«¿Cómo es realmente el esquema de esta entidad?»
«Encuentra los registros donde este campo es null y muéstrame qué tienen en común.»
«¿Qué pedido no tiene un fulfillment y por qué?»

Tú describes el problema en lenguaje natural; Claude introspecciona el esquema, ejecuta las consultas y razona sobre los resultados, sin que tengas que salir de la conversación.

Qué necesitas

Un espacio de trabajo de DbGate Central con las conexiones que quieres depurar ya añadidas: un endpoint GraphQL, un endpoint oData (usaremos Business Central de Microsoft Dynamics 365 como ejemplo) y/o una tienda de Shopify. Consulta Connect to API endpoints si aún no las has añadido.
Una cuenta de Claude que admita conectores personalizados.

Paso 1: Crear un perfil MCP en DbGate Central

Abre la pestaña Settings (el icono de engranaje en la parte inferior de la barra de actividad) y crea un nuevo MCP profile. El perfil te proporciona tres valores que necesitarás en un momento:

Server URL: con el formato https://central.dbgate.cloud/mcp/{profileId}
Client ID
Client Secret

Copia los tres. Cada espacio de trabajo puede tener varios perfiles MCP, cada uno con su propia URL, credenciales y permisos por conexión; así puedes otorgar accesos muy acotados (por ejemplo, un perfil que solo vea una única conexión de solo lectura).

Paso 2: Añadir el conector personalizado en claude.ai

En claude.ai, añade un custom connector usando la Server URL del paso anterior, junto con el Client ID y el Client Secret como credenciales OAuth.

Claude ejecuta entonces el handshake de OAuth 2.1 with PKCE: se te pide que inicies sesión en DbGate y des tu consentimiento, lo que vincula el conector a ese perfil MCP y espacio de trabajo concretos. Los client secrets se cifran en reposo y nada de tus datos se comparte hasta que completes este paso.

Configuring the DbGate Central custom connector in claude.ai
Añadiendo el conector personalizado de DbGate Central en claude.ai

Paso 3: Conceder acceso por conexión

De forma predeterminada, un perfil MCP tiene No access a todo, así que conectar solo el perfil no comparte nada. Para cada conexión a la que quieras que Claude acceda, abre su editor y establece el nivel de MCP access:

No access (predeterminado): la conexión es invisible para el agente.
Read-only: el agente puede listar, inspeccionar y consultar, pero no cambiar nada.
Writable: el agente también puede actualizar filas (solo Shopify, ver más abajo).

Un punto de partida sensato para depuración es Read-only para tus conexiones de GraphQL y Business Central, y Writable para Shopify solo si realmente quieres que Claude haga cambios.

Qué puede hacer Claude

Una vez que compartes una conexión, Claude obtiene estas herramientas para conexiones de oData, GraphQL y Shopify:

List connections: las conexiones que este perfil puede usar.
List entities: tablas, vistas o entidades de catálogo.
Inspect the schema: nombres y tipos de columnas.
Query rows: filtrar, paginar y seleccionar datos.
Update rows: solo Shopify, y solo cuando concedas acceso Writable.

Depuración de cada tipo de API

Así es como se ve una sesión real de depuración para cada tipo de conexión. Las indicaciones están en inglés sencillo; las llamadas de herramientas en cursiva son lo que Claude ejecuta por debajo.

GraphQL

La flexibilidad de GraphQL también es lo que lo hace difícil de depurar: una consulta devuelve silenciosamente null y te quedas adivinando si el problema está en el esquema, en los argumentos o en los datos. Deja que Claude recorra el esquema por ti.

Tú: In my GraphQL connection, list the available entities, show me the schema of orders, then find any orders where total is null and tell me what they have in common.

Claude ejecuta list_entities para descubrir las vistas, get_schema sobre orders para confirmar los campos y tipos, y luego query_rows para obtener los registros problemáticos; después razona sobre el resultado para detectar el patrón (por ejemplo, que todos carecen de un nodo payment relacionado).

oData: Business Central

Microsoft Dynamics 365 Business Central expone sus datos como un servicio oData V4, que DbGate Central trata como un conjunto normal de tablas. Eso hace que los datos de ERP (clientes, facturas, asientos de libro mayor) sean consultables en lenguaje natural.

Tú: In my Business Central connection, find the sales invoices for customer “Contoso” from last month, and total their amounts.

Claude usa query_rows, traduciendo tu petición a las opciones de consulta oData entre bastidores: $filter para acotar al cliente y al rango de fechas, $select para elegir las columnas y $top/$skip para paginar; luego suma los resultados por ti.

Shopify

Para una tienda de Shopify, DbGate Central se conecta a través de la Shopify Admin API y expone productos, pedidos, clientes, metafields y más.

Tú: Find order #1043 and tell me why its fulfillment is stuck.

Claude ejecuta query_rows contra tu conexión de Shopify para localizar el pedido e inspeccionar su fulfillment y el estado de las líneas.

Si, y solo si, has concedido acceso Writable, Claude también puede aplicar la corrección:

Tú: Add the tag needs-review to that order.

Claude usa update_rows, que solo está disponible para Shopify y requiere acceso Writable. Encuentra el registro mediante un objetivo y valor de coincidencia y luego aplica tu actualización. En conexiones de solo lectura esta herramienta simplemente no está disponible, de modo que un agente nunca puede cambiar datos que no pretendías exponer.

Tú mantienes el control

El servidor MCP está diseñado para que compartir tu espacio de trabajo con un asistente de IA nunca signifique perder el control:

Nada se comparte por defecto: cada conexión comienza con No access.
Permisos por conexión: decides exactamente qué conexiones son Read-only y cuáles son Writable, por perfil MCP.
Las escrituras son opcionales y acotadas: update_rows existe solo para Shopify y solo con acceso Writable.
Seguro por diseño: la autenticación usa OAuth 2.1 with PKCE y los client secrets se cifran en reposo.
Nunca más que tú: el agente usa el mismo motor que la cuadrícula, así que ve exactamente los datos y capacidades que tú.

Conclusión

Con un perfil MCP de DbGate Central y un conector personalizado en claude.ai, Claude se convierte en un compañero práctico de depuración para tus API de GraphQL, Business Central (oData) y Shopify: inspecciona esquemas, ejecuta consultas y, donde tú lo permites, aplica correcciones. Configúralo una vez, concede solo lo que necesites y empieza a hacer preguntas en lugar de escribirlas.