게시된 문서를 AI에 연결하기

Apidog MCP Server를 사용하면 AI가 Apidog에서 게시한 온라인 API 문서에 연결하고 이를 활용할 수 있으므로, 외부 개발자와 AI 어시스턴트가 공개 API 문서에 원활하게 접근할 수 있습니다.

이 구성 방법은 공개적으로 게시된 온라인 문서만 지원합니다. 비밀번호 또는 허용 목록 설정이 적용된 문서는 지원하지 않습니다.

비공개 문서의 경우 대신 Apidog Project 데이터 소스를 사용하십시오.

온라인 문서용 MCP 활성화하기

Apidog 버전 2.7.2 이상이 필요합니다.

MCP 서비스 활성화

Apidog 프로젝트로 이동하십시오.

Publish Docs → Publish Docs Sites → LLM-friendly Features로 이동하십시오.

MCP 서비스를 활성화하십시오.

구성 파일 가져오기

MCP를 활성화하면 온라인 문서에 접근할 때 MCP 버튼이 표시됩니다.

버튼을 클릭하면 구성 가이드와 MCP 구성 파일이 표시되며, 이 파일에는 문서의 site-id가 자동으로 포함됩니다. IDE 통합을 위해 이 구성을 복사하십시오.

MCP 클라이언트 구성하기

사전 요구 사항

MCP 클라이언트를 구성하기 전에 다음을 갖추었는지 확인하십시오.

Node.js(버전 18 이상, 가급적 최신 LTS 버전)

MCP 호환 IDE:

Cursor

VS Code + Cline plugin

기타 MCP 지원 편집기

Apidog 온라인 문서에서 복사한 MCP JSON 구성

Cursor에서 MCP 구성하기

MCP 설정 열기

Cursor 편집기를 여십시오.

설정 아이콘(오른쪽 상단)을 클릭하십시오.

왼쪽 메뉴에서 MCP를 선택하십시오.

+ Add new global MCP server를 클릭하십시오.

구성 추가

온라인 문서에서 복사한 MCP JSON 구성을 열린 mcp.json 파일에 붙여넣으십시오.

macOS / Linux

Windows

{
  "mcpServers": {
    "apidog-site-123456": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=123456"
      ]
    }
  }
}

구성 확인

AI에게 다음을 요청하여 연결을 테스트하십시오(Agent 모드에서).

Please fetch API documentation via MCP and tell me how many endpoints exist in the project.

AI가 올바른 API 정보를 반환하면 연결이 성공한 것입니다.

중요 참고 사항

여러 문서 사이트 사용하기

서로 다른 API 문서 사이트를 사용하려면 구성 파일에 여러 MCP Server 구성을 추가하십시오. 각 문서 사이트에는 고유한 <site-id>가 있어야 합니다.

온프레미스 배포

온프레미스 배포의 경우 IDE MCP 구성에 서버의 API 주소를 포함하십시오.

{
  "mcpServers": {
    "apidog-site-123456": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=123456",
        "--apidog-api-base-url=<your-server-url>"
      ]
    }
  }
}

<your-server-url>을 온프레미스 서버의 API 주소(http:// 또는 https://로 시작)로 바꾸십시오. www.npmjs.com에 대한 네트워크 접근이 가능한지 확인하십시오.

기타 데이터 소스

Apidog Project 내 API Specification을 AI에 연결하기

OpenAPI 파일을 AI에 연결하기

FAQ

Windows 구성 문제

Windows에서 표준 구성이 실패하는 경우 다음 대안을 사용하십시오.

{
  "mcpServers": {
    "apidog-site-123456": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=123456"
      ]
    }
  }
}

Node.js 버전 문제

AI가 업데이트된 API 문서에서 최신 데이터를 읽게 하려면 어떻게 해야 합니까?

게시된 문서를 AI에 연결하기

온라인 문서용 MCP 활성화하기#

MCP 클라이언트 구성하기#

사전 요구 사항#

Cursor에서 MCP 구성하기#

중요 참고 사항#

여러 문서 사이트 사용하기#

온프레미스 배포#

기타 데이터 소스#

FAQ#

온라인 문서용 MCP 활성화하기

MCP 클라이언트 구성하기

사전 요구 사항

Cursor에서 MCP 구성하기

중요 참고 사항

여러 문서 사이트 사용하기

온프레미스 배포

기타 데이터 소스

FAQ