MCP(Model Context Protocol)는 대규모 언어 모델(LLM) 애플리케이션과 외부 데이터 소스 및 도구 간의 표준화된 통신을 설정하기 위한 개방형 프로토콜입니다. Apidog에는 MCP 서버의 디버깅 및 테스트를 지원하는 MCP 클라이언트가 내장되어 있습니다.MCP 서버는 세 가지 주요 기능을 제공하며, Apidog MCP 클라이언트는 이 모든 기능의 디버깅을 지원합니다.Resources: 서버에서 제공하는 데이터 리소스
STDIO: 표준 입력/출력을 통한 통신이며, 로컬 프로세스에 적합합니다.
HTTP: Streamable HTTP를 통한 통신이며, 원격 서버에 적합합니다.
웹 버전을 사용하시거나 홈페이지에서 데스크톱 애플리케이션의 최신 버전을 다운로드해 주십시오.
MCP 클라이언트 생성#
HTTP 프로젝트에서 새 엔드포인트를 생성하고 MCP를 선택하십시오.
MCP 서버에 연결#
서버 주소 입력#
Apidog는 MCP 서버 연결 정보를 입력하는 여러 방법을 지원합니다.터미널 명령을 붙여 넣으면 프로토콜이 자동으로 STDIO로 전환됩니다.URL을 붙여 넣으면 프로토콜이 자동으로 HTTP로 전환됩니다.https://example-server.modelcontextprotocol.io/mcp
{
"mcpServers": {
"Everything Server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"],
"env": {}
}
}
}
{
"type": "streamable-http",
"url": "https://example-server.modelcontextprotocol.io/mcp"
}
연결 설정#
연결을 시작하려면 Connect 버튼을 클릭하십시오.로컬 명령 실행이 필요하므로 Apidog가 보안 확인 대화 상자를 표시합니다. 확인 후 로컬 프로세스를 시작하고 연결을 설정합니다.OAuth 2.0 인증이 있는 MCP 서버의 경우, Apidog가 인증 구성을 자동으로 가져오고 인증 창을 표시합니다.
기타 인증 방법(API Key, Bearer Token, Basic Auth 등)도 Auth 탭에서 수동으로 구성할 수 있습니다.
디버깅 기능#
Tools는 서버에서 제공하는 실행 가능한 함수입니다. Tool을 선택한 후 양식 또는 JSON 편집기를 통해 매개변수를 구성할 수 있습니다.매개변수를 구성한 후 Run을 클릭하여 실행하십시오. 결과는 응답 영역에 표시됩니다.Prompts#
Prompts는 사전 정의된 프롬프트 템플릿입니다. Prompt를 선택한 후 매개변수(있는 경우)를 구성하고 Run을 클릭하여 생성된 프롬프트를 가져오십시오.Resources#
Resources는 서버에서 제공하는 데이터 리소스입니다. Resource를 선택한 후 Run을 클릭하여 리소스 콘텐츠를 검색하십시오.
구성 옵션#
STDIO 모드에서만 사용할 수 있습니다. MCP 서버 프로세스를 시작할 때 환경 변수를 구성하는 데 사용됩니다.| 키 | 값 |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
HTTP 모드에서만 사용할 수 있습니다. 여러 인증 방법을 지원합니다.OAuth 2.0을 지원하는 MCP 서버의 경우 Apidog가 인증 구성을 자동으로 가져오고 채울 수 있습니다.HTTP 모드에서만 사용할 수 있습니다. 사용자 지정 HTTP 요청 헤더를 구성하는 데 사용됩니다.
응답 보기#
Run을 클릭하면 도구 실행 결과가 Response 패널에 표시됩니다. Apidog는 상호작용을 Messages와 Notifications 두 가지 유형으로 분류합니다.Messages#
Message는 표준 요청-응답 상호작용(예: 도구 실행 및 결과 수신)을 나타냅니다.각 메시지에 대해 Apidog는 데이터를 시각화하는 데 도움이 되는 세 가지 보기 모드를 제공합니다. 응답 영역 상단의 탭을 사용하여 전환할 수 있습니다.Content: 기본 보기입니다. 정리된 텍스트 출력을 표시합니다. Apidog는 JSON-RPC 메시지를 파싱하고 도구에서 반환된 핵심 콘텐츠(예: text 필드)만 추출하여 프로토콜 세부 정보를 제거함으로써 더 쉽게 읽을 수 있도록 합니다.
Preview: 도구에서 반환된 리치 콘텐츠를 렌더링합니다. 응답에 Markdown, images 또는 기타 멀티미디어 리소스가 포함된 경우, 이 탭은 이를 자동으로 시각적 형식(예: 서식 있는 텍스트, 차트 또는 디코딩된 Base64 이미지)으로 렌더링합니다. 이를 통해 수동 디코딩이나 원시 텍스트 파싱이 필요하지 않습니다.
Raw: 모든 프로토콜 세부 정보(jsonrpc, id, result 구조 등)를 포함한 전체 JSON-RPC 상호작용 메시지를 표시합니다. MCP 서버를 디버깅할 때 프로토콜 준수 여부를 확인하려면 이 모드를 사용하십시오.
Notifications#
Notification은 응답이 필요하지 않은 MCP 서버의 단방향 메시지(예: 로깅, 진행률 업데이트 또는 리소스 변경)를 나타냅니다.Notifications는 응답 타임라인에 별도로 나열됩니다.
일반적으로 로그 수준(예: info, debug, error)과 함께 제공되는 메시지 텍스트를 표시합니다.
변수 지원#
다음 위치에서 변수 {{variable_name}}가 지원됩니다.
저장 및 공유#
구성된 MCP 클라이언트는 이후 사용 및 팀 협업을 위해 프로젝트에 저장할 수 있습니다.참고: MCP 디렉터리 트리(Tools, Prompts, Resources 목록)는 로컬에만 저장되며, 각 연결 시 자동으로 새로 고쳐집니다.
FAQ#
STDIO 연결이 "command not found" 오류와 함께 실패합니다#
필요한 런타임(Node.js 등)이 설치되어 있는지 확인하고 명령 경로가 올바른지 확인하십시오.HTTP 연결이 401 오류를 반환합니다#
Apidog는 OAuth 2.0 구성을 자동으로 가져오려고 시도합니다. 실패하는 경우 Auth 탭에서 인증 정보를 수동으로 구성하십시오.연결은 성공했지만 디렉터리 트리가 비어 있습니다#
서버 구성이 올바른지 확인하 고 Notifications 탭을 확인하여 서버가 도구 목록을 반환했는지 확인하십시오.매개변수 유형 불일치#
양식 모드를 사용할 때 Apidog는 매개변수 유형을 자동으로 검증합니다. JSON 편집기 모드에서는 숫자 주위에 따옴표를 추가하지 않도록 주의하고, 불리언 값에는 true/false를 사용하십시오. 