Apidog의 AI 에이전트 디버거는 Free 플랜을 포함한 모든 플랜의 최신 Apidog 클라이언트에서 사용할 수 있습니다. 이 디버거를 사용하면 OpenAI 및 Anthropic 모델에 대해 AI 에이전트를 실행하고, MCP 서버를 연결하고, 추적(Traces) 패널에서 모든 모델 호출 및 도구 호출을 검사하고, 실행당 비용을 추적할 수 있습니다.
이 문서에서는 AI 에이전트 디버거를 사용할 수 있는 대상, 지원하는 기능, 지원하지 않는 기능, 활성화 방법, 그리고 기존 Apidog 프로젝트에 대한 변경 사항이 없는지에 대해 다룹니다.
사용 가능한 기능
AI 에이전트 디버거는 표준 Apidog 클라이언트에 포함되어 제공됩니다. 별도의 라이선스, 추가 플랜 또는 사용자당 요금은 없습니다.
- Free, Basic, Professional, Enterprise 플랜 모두 AI 에이전트 디버거를 포함합니다.
- 이 기능은 기본적으로 활성화되어 있으며, 별도로 설정할 필요가 없습니다.
- 최신 Apidog 클라이언트 버전을 사용해야 합니다. 이전 클라이언트에는 AI 에이전트 디버거 탭이 없습니다.
지원되는 모델 제공업체
| 제공업체 | 상태 | 모델 |
|---|---|---|
| OpenAI | 지원됨 | GPT-5.5, GPT-5.5 Instant, o-series 및 OpenAI 계정의 모든 모델 |
| Anthropic | 지원됨 | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| 사용자 지정 OpenAI 호환 엔드포인트 | 기본 URL 재정의를 통해 지원됨 | OpenAI 호환 API를 노출하는 모든 제공업체 |
| 다른 제공업체 (Google, Mistral, xAI) | 로드맵에 포함 | 현재 일급 지원은 아님 |
MCP 서버 연결 방법
디버거는 모델 컨텍스트 프로토콜(MCP)을 기본적으로 지원합니다. 세 가지 전송 방식이 지원됩니다:
- STDIO. 로컬 서브프로세스. 활발하게 개발 중인 MCP 서버에 가장 적합합니다.
- HTTP Streamable. HTTP를 통해 접근 가능한 호스팅된 MCP 서버.
- SSE. 레거시 서버 전송 이벤트. 여전히 일반적이며, 하위 호환성을 위해 지원됩니다.
MCP 서버 인증은 두 가지 패턴을 지원합니다: 표준 헤더(API 키) 및 OAuth 2.0(전체 토큰 교환).
디버거 지원 범위
디버거는 에이전트 실행의 전체 실행 체인을 캡처합니다:
- 전체 요청 및 응답 페이로드가 포함된 모델 호출.
- 모델이 노출하는 경우(OpenAI o-시리즈, Anthropic 확장 사고) 모델의 사고 추적.
- 매개변수 값 및 반환 데이터가 포함된 도구 호출.
- 다른 도구 호출과 마찬가지로 추적(Traces) 패널에 나열되는 MCP 서버 트래픽.
- 내장 도구:
bash,web_fetch,read,edit,write,grep,glob,kill_shell. - 실행당 성능 지표: 응답 시간, 입력 토큰, 출력 토큰, 예상 비용.
- 스킬(Skills): 시나리오를 다시 실행하기 위한 시스템 프롬프트 + 도구 목록 + 매개변수의 저장된 번들.
디버거에서 지원하지 않는 기능
- 프로덕션 가시성. 장기적인 트래픽 로깅을 위해서는 전용 가시성 도구를 사용하십시오.
- 자동화된 회귀 테스트. 픽스처에 대한 프롬프트 그리드에는 Promptfoo와 같은 하네스를 사용하십시오.
- 에이전트 간(A2A) 프로토콜 트래픽. A2A의 경우 Apidog의 별도 A2A 디버거를 사용하십시오.
- 독립적인 MCP 서버 유효성 검사. 에이전트 루프 없이 단일 MCP 서버의 도구 및 리소스를 테스트하려면 Apidog의 MCP 서버 테스트 흐름을 사용하십시오.
활성화 방법
- Apidog를 최신 버전으로 업데이트하십시오.
- Apidog를 열고 상단 탭 바에서 AI Agent Debugger를 클릭하십시오.
- 모델 제공업체와 모델을 선택하십시오.
- 기본 URL(제공업체에서 자동 채워짐)을 확인하거나 사용자 지정 엔드포인트를 위해 재정의하십시오.
- API 키를 붙여넣으십시오.
- 빈 스레드에서 실행(Run)을 클릭하여 연결을 확인하십시오.
프로젝트 수준 구성은 필요하지 않습니다. 디버거는 자체 작업 공간에서 실행됩니다.
변경되지 않는 사항
- 기존 Apidog 프로젝트, API 정의 및 테스트 스위트는 영향을 받지 않습니다.
- MCP 서버 테스트 흐름과 A2A 디버거는 계속 병렬로 작동합니다.
- API 엔드포인트 디버깅, Mock 서버 및 OpenAPI 편집은 변경되지 않습니다.
- 청구 및 플랜 티어는 변경되지 않습니다. AI 에이전트 디버거는 새로운 크레딧을 소비하지 않습니다.
OpenAI 또는 Anthropic 계정에 청구되는 대로 기본 모델 API 호출 비용을 지불합니다. Apidog는 사용량에 대해 추가 요금을 부과하지 않습니다.
팀 및 엔터프라이즈 관리자를 위한 정보
- AI 에이전트 디버거는 사용자별로 활성화됩니다. 각 멤버는 자신의 제공업체 API 키를 사용합니다.
- 디버거에 입력된 API 키는 각 사용자의 클라이언트에 로컬로 저장됩니다. Apidog 서버로 전송되지 않습니다.
- 작업 공간 소유자는 표준 Apidog 환경 변수를 통해 공유 MCP 서버 엔드포인트를 중앙에서 관리할 수 있습니다.
- MCP 서버에 대한 감사 및 접근 제어는 MCP 서버 자체의 인증 모델(헤더 또는 OAuth 2.0)을 따릅니다.
알려진 제한 사항
- OpenAI 및 Anthropic 이외의 제공업체 확장은 로드맵에 포함되어 있습니다. 그 동안 OpenAI 호환 제공업체의 경우 기본 URL 재정의를 사용하십시오.
- 추적 공유는 로컬에서만 가능합니다. 추적을 공유하려면 원시 보기(Raw view) JSON을 복사하거나 패널을 스크린샷하십시오.
- 비용 예측은 공개된 모델 가격을 기반으로 한 로컬 근사치입니다. 청구에 대해서는 제공업체의 사용량 대시보드를 참조하십시오.