Como usar o Claude para depurar suas APIs

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

Depurar uma API normalmente significa ficar alternando entre coleções do Postman, escrevendo scripts descartáveis ou montando consultas manualmente só para responder a uma pergunta simples como “por que esse campo está nulo?” ou “qual pedido está travado?”. E se você pudesse simplesmente perguntar?

O DbGate Central vem com um servidor MCP (Model Context Protocol) embutido que expõe suas conexões de API para assistentes de IA como o Claude. Depois de conectado, o Claude pode explorar e consultar suas conexões GraphQL, Business Central (oData) e Shopify em produção do mesmo jeito que você faz — diretamente a partir do chat, com um nível de acesso que continua sob o seu controle.

Este guia mostra como configurar tudo em poucos minutos e depois usar o Claude para depurar os três tipos de conexão.

Abrir o DbGate Central →

Por que depurar APIs com o Claude?

Como as leituras e gravações reutilizam o mesmo mecanismo da grade do DbGate Central, o Claude vê exatamente os mesmos dados e capacidades que você — nunca mais do que o acesso que você conceder. Isso o torna um companheiro natural de depuração:

“Como é exatamente o esquema dessa entidade?”
“Encontre os registros em que esse campo está nulo e me mostre o que eles têm em comum.”
“Qual pedido está sem fulfillment e por quê?”

Você descreve o problema em linguagem natural; o Claude introspecta o esquema, executa as consultas e raciocina sobre os resultados — sem que você precise sair da conversa.

O que você vai precisar

Um workspace do DbGate Central com as conexões que você quer depurar já adicionadas — um endpoint GraphQL, um endpoint oData (vamos usar o Business Central do Microsoft Dynamics 365 como exemplo) e/ou uma loja Shopify. Veja Conectar a endpoints de API se ainda não os adicionou.
Uma conta do Claude que ofereça suporte a custom connectors (conectores personalizados).

Etapa 1 – Criar um perfil MCP no DbGate Central

Abra a aba Settings (o ícone de engrenagem na parte inferior da barra de atividades) e crie um novo MCP profile. O perfil fornece três valores de que você vai precisar em instantes:

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

Copie os três. Cada workspace pode ter vários MCP profiles, cada um com sua própria URL, credenciais e permissões por conexão — assim você pode conceder acessos bem restritos (por exemplo, um perfil que enxerga apenas uma única conexão somente leitura).

Etapa 2 – Adicionar o conector personalizado no claude.ai

No claude.ai, adicione um custom connector usando a Server URL da etapa anterior, junto com o Client ID e o Client Secret como credenciais OAuth.

O Claude então executa o handshake OAuth 2.1 com PKCE: você é solicitado a entrar no DbGate e conceder o consentimento, o que vincula o conector àquele MCP profile e workspace específicos. Os client secrets são criptografados em repouso, e nada sobre seus dados é compartilhado até você concluir essa etapa.

Configurando o conector personalizado do DbGate Central no claude.ai
Adicionando o conector personalizado do DbGate Central no claude.ai

Etapa 3 – Conceder acesso por conexão

Por padrão, um MCP profile tem No access a tudo — então conectar apenas o perfil não compartilha nada. Para cada conexão à qual você quer que o Claude tenha acesso, abra o editor da conexão e defina o nível de MCP access:

No access (padrão) — a conexão é invisível para o agente.
Read-only — o agente pode listar, inspecionar e consultar, mas não alterar nada.
Writable — o agente também pode atualizar linhas (apenas Shopify, veja abaixo).

Um ponto de partida sensato para depuração é Read-only para suas conexões GraphQL e Business Central, e Writable para Shopify somente se você realmente quiser que o Claude faça alterações.

O que o Claude pode fazer

Depois que uma conexão é compartilhada, o Claude recebe estas ferramentas para conexões oData, GraphQL e Shopify:

List connections — as conexões que esse perfil está autorizado a usar.
List entities — tabelas, views ou entidades de catálogo.
Inspect the schema — nomes e tipos de colunas.
Query rows — filtrar, paginar e selecionar dados.
Update rows — apenas Shopify, e somente quando você conceder acesso Writable.

Depurando cada tipo de API

Veja como é uma sessão real de depuração para cada tipo de conexão. Os prompts estão em inglês simples — as chamadas de ferramenta em itálico são o que o Claude executa nos bastidores.

GraphQL

A flexibilidade do GraphQL também é o que o torna difícil de depurar: uma consulta retorna null silenciosamente e você fica tentando adivinhar se o problema é o esquema, os argumentos ou os dados. Deixe o Claude percorrer o esquema para você.

Você: 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.

O Claude executa list_entities para descobrir as views, get_schema em orders para confirmar os campos e tipos e, em seguida, query_rows para buscar os registros problemáticos — e raciocina sobre o resultado para identificar o padrão (por exemplo, todos eles sem um nó payment relacionado).

oData – Business Central

O Business Central do Microsoft Dynamics 365 expõe seus dados como um serviço oData V4, que o DbGate Central trata como um conjunto comum de tabelas. Isso torna os dados de ERP — clientes, faturas, lançamentos contábeis — consultáveis em linguagem natural.

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

O Claude usa query_rows, traduzindo seu pedido nas opções de consulta oData por trás dos panos — $filter para restringir ao cliente e ao intervalo de datas, $select para escolher as colunas e $top/$skip para paginação — e depois soma os resultados para você.

Shopify

Para uma loja Shopify, o DbGate Central se conecta por meio da Shopify Admin API e expõe produtos, pedidos, clientes, metafields e muito mais.

Você: Find order #1043 and tell me why its fulfillment is stuck.

O Claude executa query_rows na sua conexão Shopify para localizar o pedido e inspecionar o status de fulfillment e dos itens de linha.

Se — e somente se — você tiver concedido acesso Writable, o Claude também pode aplicar a correção:

Você: Add the tag needs-review to that order.

O Claude usa update_rows, que está disponível apenas para Shopify e exige acesso Writable. Ele encontra o registro por um alvo e valor de correspondência e, em seguida, aplica sua atualização. Em conexões Read-only essa ferramenta simplesmente não está disponível, então um agente nunca pode alterar dados que você não pretendia expor.

Você continua no controle

O servidor MCP foi projetado para que compartilhar seu workspace com um assistente de IA nunca signifique abrir mão do controle:

Nada é compartilhado por padrão — toda conexão começa com No access.
Permissões por conexão — você decide exatamente quais conexões são Read-only ou Writable, por MCP profile.
Gravações são opt-in e limitadas — update_rows existe apenas para Shopify e somente com acesso Writable.
Seguro por padrão — a autenticação usa OAuth 2.1 com PKCE, e os client secrets são criptografados em repouso.
Nunca mais do que você — o agente usa o mesmo mecanismo da grade, então vê exatamente os dados e capacidades que você vê.

Conclusão

Com um MCP profile do DbGate Central e um conector personalizado no claude.ai, o Claude se torna um parceiro prático de depuração para suas APIs GraphQL, Business Central (oData) e Shopify — inspecionando esquemas, executando consultas e, onde você permitir, aplicando correções. Configure uma vez, conceda apenas o que for necessário e comece a fazer perguntas em vez de escrevê-las.