Claude를 사용해 API를 디버깅하는 방법

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

API를 디버깅한다는 것은 보통 Postman 컬렉션을 이리저리 옮겨 다니고, 일회용 스크립트를 쓰거나, “왜 이 필드가 null이지?”, “어느 주문이 멈춰 있지?” 같은 간단한 질문에 답하기 위해 쿼리를 손으로 만드는 일을 의미합니다. 그냥 물어볼 수 있다면 어떨까요?

DbGate Central에는 Claude 같은 AI 어시스턴트에 API 연결을 노출하는 MCP(Model Context Protocol) 서버가 내장되어 있습니다. 한 번 연결해 두면, Claude는 여러분이 하듯이 채팅 안에서 바로 라이브 GraphQL, Business Central(oData), Shopify 연결을 탐색하고 쿼리할 수 있습니다. 이때 접근 권한은 항상 여러분이 제어합니다.

이 가이드는 몇 분 안에 설정을 마치고 Claude로 세 가지 API를 모두 디버깅하는 방법을 보여줍니다.

DbGate Central 열기 →

왜 Claude로 API를 디버깅할까?

읽기와 쓰기는 DbGate Central 그리드와 동일한 엔진을 재사용하기 때문에, Claude는 여러분이 보는 것과 정확히 같은 데이터와 기능만 봅니다. 여러분이 부여한 권한을 넘어서는 접근은 절대 없습니다. 그래서 Claude는 자연스러운 디버깅 파트너가 됩니다.

“이 엔터티의 실제 스키마는 어떻게 생겼지?”
“이 필드가 null인 레코드를 찾아서, 공통점이 뭔지 보여줘.”
“어느 주문이 미배송 상태인지, 그리고 이유가 뭔지 알려줘.”

여러분은 문제를 자연어로 설명하고, Claude는 스키마를 조사하고 쿼리를 실행한 뒤 결과를 바탕으로 추론합니다. 대화를 떠날 필요가 없습니다.

준비물

디버깅하려는 연결이 이미 추가된 DbGate Central 워크스페이스
- GraphQL 엔드포인트
- oData 엔드포인트(예제로 Microsoft Dynamics 365 Business Central 사용)
- 그리고/또는 Shopify 스토어
  아직 추가하지 않았다면 API 엔드포인트 연결을 참고하세요.
커스텀 커넥터를 지원하는 Claude 계정

1단계 - DbGate Central에서 MCP 프로필 만들기

Settings 탭(활동 표시줄 맨 아래의 톱니바퀴 아이콘)을 열고 새 MCP profile을 생성합니다. 이 프로필은 잠시 후 필요할 세 가지 값을 제공합니다.

Server URL - 형식: https://central.dbgate.cloud/mcp/{profileId}
Client 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 수준을 설정하세요.

No access (기본값) - 에이전트에게 이 연결은 보이지 않습니다.
Read-only - 에이전트가 나열, 조회, 쿼리는 할 수 있지만 변경은 할 수 없습니다.
Writable - 에이전트가 행을 업데이트할 수도 있습니다(아래 설명처럼 Shopify에만 해당).

디버깅을 시작할 때 합리적인 설정은 다음과 같습니다.

GraphQL, Business Central 연결: Read-only
Shopify: 실제로 Claude가 변경을 수행하길 원할 때만 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에게 맡기세요. Claude가 스키마를 차근차근 따라가 줍니다.

You: 내 GraphQL 연결에서 사용 가능한 엔터티를 나열하고, orders의 스키마를 보여준 다음, total이 null인 주문을 찾아서 공통점이 뭔지 알려줘.

Claude는 먼저 list_entities로 뷰를 찾고, get_schema를 orders에 실행해 필드와 타입을 확인한 뒤, query_rows로 문제가 되는 레코드를 가져옵니다. 그리고 결과를 분석해, 예를 들어 모두 관련 payment 노드가 없는 패턴을 찾아냅니다.

oData - Business Central

Microsoft Dynamics 365 Business Central은 데이터를 oData V4 서비스로 노출하며, DbGate Central은 이를 일반적인 테이블 집합처럼 다룹니다. 덕분에 고객, 송장, 원장 항목 같은 ERP 데이터를 자연어로 쿼리할 수 있습니다.

You: 내 Business Central 연결에서 고객 “Contoso"의 지난달 판매 송장을 찾아서, 금액 합계를 계산해 줘.

Claude는 query_rows를 사용해 여러분의 요청을 oData 쿼리 옵션으로 변환합니다. $filter로 고객과 날짜 범위를 좁히고, $select로 필요한 컬럼만 선택하며, $top/$skip으로 페이지를 나눕니다. 그런 다음 결과를 합산해 보여줍니다.

Shopify

Shopify 스토어의 경우, DbGate Central은 Shopify Admin API를 통해 연결하고, 상품, 주문, 고객, 메타필드 등을 노출합니다.

You: 주문 #1043을 찾아서, 왜 배송(fulfillment)이 멈춰 있는지 알려줘.

Claude는 Shopify 연결에 대해 query_rows를 실행해 해당 주문을 찾고, 배송 및 라인 아이템 상태를 확인합니다.

그리고 여러분이 Writable 권한을 부여한 경우에만, Claude가 수정까지 수행할 수 있습니다.

You: 그 주문에 needs-review 태그를 추가해 줘.

Claude는 update_rows를 사용합니다. 이 도구는 Shopify에만 제공되며 Writable 권한이 필요합니다. Claude는 매치 타깃과 값으로 레코드를 찾은 뒤, 요청한 업데이트를 적용합니다. Read-only 연결에서는 이 도구가 아예 제공되지 않으므로, 의도하지 않은 데이터 변경은 일어날 수 없습니다.

제어권은 항상 여러분에게

MCP 서버는 AI 어시스턴트와 워크스페이스를 공유하더라도 제어권을 잃지 않도록 설계되었습니다.

기본값은 공유 안 함 - 모든 연결은 처음에 No access입니다.
연결별 권한 부여 - MCP 프로필마다 어떤 연결을 Read-only, Writable로 둘지 세밀하게 결정할 수 있습니다.
쓰기 권한은 명시적이고 제한적 - update_rows는 Shopify에만 존재하며, Writable 권한이 있을 때만 사용됩니다.
보안 중심 설계 - 인증은 PKCE가 포함된 OAuth 2.1을 사용하고, 클라이언트 시크릿은 저장 시 암호화됩니다.
사용자보다 더 많이 보지 않음 - 에이전트는 그리드와 동일한 엔진을 사용하므로, 여러분이 가진 데이터와 기능만 그대로 봅니다.

마무리

DbGate Central MCP 프로필과 claude.ai의 커스텀 커넥터를 설정하면, Claude는 GraphQL, Business Central(oData), Shopify API를 위한 실질적인 디버깅 파트너가 됩니다. 스키마를 살펴보고, 쿼리를 실행하며, 여러분이 허용한 범위 안에서 수정까지 적용합니다. 한 번만 설정해 두고, 필요한 권한만 부여한 뒤, 쿼리를 “작성”하는 대신 질문을 “던지기” 시작하세요.