Cómo usar Claude para depurar tus APIs

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

Depurar una API suele significar hacer malabares con colecciones de Postman, escribir scripts desechables o elaborar consultas a mano solo para responder una pregunta sencilla como "¿por qué este campo es nulo?" o "¿qué pedido está atascado?". ¿Y si simplemente pudieras preguntar?

DbGate Central incluye un servidor MCP (Model Context Protocol) integrado 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 igual que lo haces tú, directamente desde el chat y 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.

Abrir DbGate Central →

¿Por qué depurar APIs con Claude?

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

"¿Cómo es realmente el esquema de esta entidad?"
“Encuentra los registros donde este campo es nulo y muéstrame qué tienen en común.”
"¿A qué pedido le falta un cumplimiento, y por qué?"

Describes el problema en lenguaje natural; Claude introspecciona el esquema, ejecuta las consultas y razona sobre los resultados, sin que salgas de la conversación.

Lo que necesitarás

Un espacio de trabajo de DbGate Central con las conexiones que quieres depurar ya añadidas: un endpoint de GraphQL, un endpoint de oData (usaremos Microsoft Dynamics 365 Business Central como ejemplo) o una tienda de Shopify. Consulta Conectar a endpoints de API 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 Ajustes (el icono de engranaje en la parte inferior de la barra de actividad) y crea un nuevo perfil MCP. El perfil te da tres valores que necesitarás en un momento:

URL del servidor - 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 concesiones por conexión, de modo que puedes repartir accesos con un alcance muy acotado (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 conector personalizado usando la URL del servidor del paso anterior, junto con el Client ID y el Client Secret como credenciales de OAuth.

Claude ejecuta entonces el intercambio de OAuth 2.1 con PKCE: se te pide iniciar sesión en DbGate y dar tu consentimiento, lo que vincula el conector a ese perfil MCP y espacio de trabajo concretos. Los secretos de cliente se cifran en reposo, y no se comparte nada sobre tus datos hasta que completas 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 Sin acceso a todo, por lo que conectar el perfil por sí solo no comparte nada. Para cada conexión que quieras que Claude alcance, abre su editor y establece el nivel de acceso MCP:

Sin acceso (predeterminado) - la conexión es invisible para el agente.
Solo lectura - el agente puede listar, inspeccionar y consultar, pero no cambiar nada.
Con escritura - el agente también puede actualizar filas (solo Shopify, ver más abajo).

Un punto de partida sensato para depurar es Solo lectura para tus conexiones de GraphQL y Business Central, y Con escritura para Shopify solo si realmente quieres que Claude haga cambios.

Lo que Claude puede hacer

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

Listar conexiones - las conexiones que este perfil tiene permitido usar.
Listar entidades - tablas, vistas o entidades del catálogo.
Inspeccionar el esquema - nombres y tipos de columnas.
Consultar filas - filtrar, paginar y seleccionar datos.
Actualizar filas - solo Shopify, y solo cuando concedes acceso Con escritura.

Depurar cada tipo de API

Así es como se ve una sesión de depuración real para cada tipo de conexión. Los prompts están en lenguaje natural; las llamadas a herramientas en cursiva son lo que Claude ejecuta por debajo.

GraphQL

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

Tú: En mi conexión de GraphQL, lista las entidades disponibles, muéstrame el esquema de orders y luego encuentra los pedidos donde total sea nulo y dime qué tienen en común.

Claude ejecuta list_entities para descubrir las vistas, get_schema sobre orders para confirmar los campos y tipos, y luego query_rows para extraer los registros problemáticos, y razona sobre el resultado para detectar el patrón (por ejemplo, que a todos les falta un nodo payment relacionado).

oData - Business Central

Microsoft Dynamics 365 Business Central expone sus datos como un servicio de oData V4, que DbGate Central trata como un conjunto ordinario de tablas. Eso hace que los datos de ERP (clientes, facturas, asientos contables) se puedan consultar en lenguaje natural.

Tú: En mi conexión de Business Central, encuentra las facturas de venta del cliente “Contoso” del mes pasado y suma sus importes.

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

Shopify

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

Tú: Encuentra el pedido #1043 y dime por qué su cumplimiento está atascado.

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

Si, y solo si, concediste acceso Con escritura, Claude también puede aplicar la corrección:

Tú: Añade la etiqueta needs-review a ese pedido.

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

Tú mantienes el control

El servidor MCP está construido de forma que compartir tu espacio de trabajo con un asistente de IA nunca signifique renunciar al control:

Nada se comparte de forma predeterminada - cada conexión empieza en Sin acceso.
Concesiones por conexión - tú decides exactamente qué conexiones son de Solo lectura o Con escritura, por cada perfil MCP.
Las escrituras son opcionales y acotadas - update_rows existe solo para Shopify y solo con acceso Con escritura.
Seguro por diseño - la autenticación usa OAuth 2.1 con PKCE, y los secretos de cliente se cifran en reposo.
Nunca más que tú - el agente usa el mismo motor que la cuadrícula, así que ve exactamente los mismos 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 de depuración práctico para tus APIs de GraphQL, Business Central (oData) y Shopify: inspecciona esquemas, ejecuta consultas y, donde tú lo permitas, aplica correcciones. Configúralo una vez, concede solo lo que necesitas y empieza a hacer preguntas en lugar de escribirlas.