Como Usar o Claude para Depurar suas APIs

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

Depurar uma API costuma significar lidar com coleções do Postman, escrever scripts descartáveis ou criar manualmente consultas 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 a assistentes de IA como o Claude. Uma vez conectado, o Claude pode explorar e consultar suas conexões GraphQL, Business Central (oData) e Shopify ao vivo da mesma forma que você faria - diretamente pelo chat, com um acesso que você continua controlando.

Este guia mostra como configurar tudo em poucos minutos e depois usar o Claude para depurar as três.

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ê concede. Isso o torna um parceiro natural para depuração:

“Como é realmente o esquema desta entidade?”
“Encontre os registros em que este campo é nulo e me mostre o que eles têm em comum.”
“Qual pedido está sem um cumprimento (fulfillment) e por quê?”

Você descreve o problema em linguagem simples; 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ê deseja depurar já adicionadas - um endpoint GraphQL, um endpoint oData (usaremos o Microsoft Dynamics 365 Business Central como exemplo) e/ou uma loja Shopify. Veja Conectar a endpoints de API caso ainda não os tenha adicionado.
Uma conta Claude que suporte conectores personalizados.

Passo 1 - Criar um perfil MCP no DbGate Central

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

URL do servidor - no formato https://central.dbgate.cloud/mcp/{profileId}
Client ID
Client Secret

Copie os três. Cada workspace pode ter múltiplos perfis MCP, cada um com sua própria URL, credenciais e permissões por conexão - assim você pode conceder acesso com escopo restrito (por exemplo, um perfil que enxerga apenas uma única conexão somente leitura).

Passo 2 - Adicionar o conector personalizado no claude.ai

No claude.ai, adicione um conector personalizado usando a URL do servidor obtida no passo anterior, junto com o Client ID e o Client Secret como credenciais OAuth.

O Claude então executa o processo OAuth 2.1 com PKCE: você será solicitado a fazer login no DbGate e consentir, o que vincula o conector a esse perfil MCP e workspace específicos. Os client secrets são criptografados em repouso, e nada dos seus dados é compartilhado até que você conclua essa etapa.

Configuring the DbGate Central custom connector in claude.ai
Adicionando o conector personalizado do DbGate Central no claude.ai

Passo 3 - Conceder acesso por conexão

Por padrão, um perfil MCP tem Sem acesso a tudo - portanto, conectar o perfil sozinho não compartilha nada. Para cada conexão que você deseja que o Claude alcance, abra o editor dela e defina o nível de acesso MCP:

Sem acesso (padrão) - a conexão fica invisível para o agente.
Somente leitura - o agente pode listar, inspecionar e consultar, mas não alterar nada.
Gravável - o agente também pode atualizar registros (somente Shopify, veja abaixo).

Um ponto de partida sensato para depuração é Somente leitura para suas conexões GraphQL e Business Central, e Gravável para o Shopify apenas se você realmente quiser que o Claude faça alterações.

O que o Claude pode fazer

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

Listar conexões - as conexões que esse perfil tem permissão para usar.
Listar entidades - tabelas, visualizações ou entidades de catálogo.
Inspecionar o esquema - nomes e tipos de colunas.
Consultar registros - filtrar, paginar e selecionar dados.
Atualizar registros - somente Shopify, e apenas quando você concede acesso Gravável.

Depurando cada tipo de API

Veja como é uma sessão de depuração real para cada tipo de conexão. Os prompts estão em portuguê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 torna sua depuração difícil: uma consulta retorna null silenciosamente e você fica sem saber se é o esquema, os argumentos ou os dados. Deixe o Claude percorrer o esquema para você.

Você: Na minha conexão GraphQL, liste as entidades disponíveis, mostre-me o esquema de orders e depois encontre pedidos em que total seja nulo e me diga o que eles têm em comum.

O Claude executa list_entities para descobrir as visualizações, get_schema em orders para confirmar os campos e tipos e, em seguida, query_rows para trazer 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 Microsoft Dynamics 365 Business Central 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 simples.

Você: Na minha conexão do Business Central, encontre as faturas de venda do cliente “Contoso” do mês passado e some seus valores.

O Claude usa query_rows, traduzindo sua solicitação para as opções de consulta oData nos bastidores - $filter para restringir ao cliente e ao intervalo de datas, $select para escolher as colunas e $top/$skip para paginar - e então soma os resultados para você.

Shopify

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

Você: Encontre o pedido #1043 e me diga por que o cumprimento (fulfillment) dele está travado.

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

Se - e somente se - você concedeu acesso Gravável, o Claude também pode fazer a correção:

Você: Adicione a tag needs-review a esse pedido.

O Claude usa update_rows, que está disponível somente para Shopify e exige acesso Gravável. Ele localiza o registro por um alvo e valor de correspondência e, então, aplica sua atualização. Em conexões somente leitura, essa ferramenta simplesmente não está disponível, de modo que um agente nunca pode alterar dados que você não pretendia expor.

Você continua no controle

O servidor MCP foi construído 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 Sem acesso.
Permissões por conexão - você decide exatamente quais conexões são Somente leitura ou Graváveis, por perfil MCP.
Gravações são opcionais e restritas - update_rows existe apenas para o Shopify e apenas com acesso Gravável.
Seguro por design - 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 ele vê exatamente os dados e capacidades que você vê.

Conclusão

Com um perfil MCP do DbGate Central e um conector personalizado no claude.ai, o Claude se torna um parceiro de depuração prático para suas APIs de 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.