Enables AI tools to interact with API documentation from OpenAPI/Swagger specifications, providing search, endpoint details, schema definitions, and project statistics from Swagger-documented APIs.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apidog MCP Serversearch for user authentication endpoints"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apidog MCP Server (HTTP)
HTTP 기반 Model Context Protocol (MCP) 서버로, API 문서를 AI 도구에서 활용할 수 있게 해줍니다.
기능
API 엔드포인트 검색: 키워드로 API 검색
엔드포인트 상세 조회: 파라미터, 요청/응답 스키마 확인
스키마 조회: 모델/스키마 정의 조회
프로젝트 정보: API 통계 및 메타데이터
Requirements
Node.js 18+
pnpm
설치
pnpm install설정
.env 파일:
PORT=3333
# 방법 1: Apidog 프로젝트 사용
APIDOG_ACCESS_TOKEN=your-token
APIDOG_PROJECT_ID=your-project-id
# 방법 2: OpenAPI/Swagger URL 직접 사용
APIDOG_OAS_URL=https://petstore3.swagger.io/api/v3/openapi.json
# 선택: MCP 서버 인증 (설정하지 않으면 인증 없이 접근)
MCP_API_KEY=your-mcp-api-key실행
# 개발
pnpm dev
# 프로덕션
pnpm build
pnpm startMCP 도구
도구 | 설명 |
| 키워드로 API 엔드포인트 검색 |
| 특정 엔드포인트 상세 정보 조회 |
| 모든 엔드포인트 목록 |
| 스키마/모델 정의 조회 |
| 프로젝트 정보 및 통계 |
| 캐시 갱신 |
Claude Desktop 설정
claude_desktop_config.json:
{
"mcpServers": {
"apidog": {
"url": "http://localhost:3333/mcp",
"transport": "http"
}
}
}인증 필요 시:
{
"mcpServers": {
"apidog": {
"url": "http://localhost:3333/mcp",
"transport": "http",
"headers": {
"x-api-key": "your-mcp-api-key"
}
}
}
}API 테스트
# 헬스 체크
curl http://localhost:3333/mcp
# Initialize
curl -X POST http://localhost:3333/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
# 도구 목록
curl -X POST http://localhost:3333/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
# API 검색
curl -X POST http://localhost:3333/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"apidog_search","arguments":{"keyword":"user"}}}'Docker
docker build -t apidog-mcp-server .
docker run -p 3333:3333 --env-file .env apidog-mcp-serverThis server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.