AI에 Apidog 프로젝트 연결

Apidog MCP Server를 사용하면 AI가 Apidog 프로젝트 내 API 사양에 연결하고 이를 활용할 수 있으므로, AI 어시스턴트가 코드를 생성하고, 사양을 검색하며, 개발 워크플로를 가속화할 수 있습니다.

사전 요구 사항

MCP 클라이언트를 구성하기 전에 다음이 준비되어 있는지 확인하십시오.

Node.js(버전 18 이상, 최신 LTS 버전 권장)

MCP 호환 IDE:

Cursor

VS Code + Cline plugin

기타 MCP 지원 편집기

필요한 자격 증명 얻기

API 액세스 토큰 생성

Apidog을 열고 프로필 사진(오른쪽 상단)에 마우스를 올리십시오.

Account Settings → API Access Token을 선택하십시오.

새 API 액세스 토큰을 생성하십시오.

구성에서 <access-token>을 대체할 토큰을 복사하십시오.

Apidog 프로젝트 ID 가져오기(선택 사항)

Apidog에서 대상 프로젝트를 여십시오.

왼쪽 사이드바에서 Project Settings를 클릭하십시오.

Basic Settings로 이동하십시오.

구성에서 <project-id>를 대체할 프로젝트 ID를 복사하십시오.

프로젝트 내 MCP 구성 복사

아무 API나 열고 AI Coding 항목을 사용하여 해당 MCP 구성을 직접 복사할 수 있습니다.

Cursor에서 MCP 구성

MCP 설정 열기

Cursor 편집기를 여십시오.

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

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

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

구성 추가

열린 mcp.json 파일에 다음 구성을 붙여 넣으십시오. <access-token> 및 <project-id>를 실제 값으로 대체하십시오.

macOS / Linux

Windows

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project-id=<project-id>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

구성 확인

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

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

AI가 Apidog 프로젝트의 API 정보를 반환하면 연결이 성공한 것입니다.

중요 참고 사항

<access-token> 및 <project-id>를 개인 Apidog API 액세스 토큰과 프로젝트 ID로 대체하십시오.

여러 프로젝트로 작업하기

여러 프로젝트의 API 사양으로 작업하려면 구성 파일에 여러 MCP Server 구성을 추가하십시오. 각 프로젝트에는 고유한 <project-id>가 있어야 합니다.

명확성을 위해 각 MCP Server의 이름은 "[Project Name] API Specification" 형식을 따르도록 지정하십시오.

보안 모범 사례

팀에서 MCP 구성 파일을 코드 저장소에 동기화하는 경우:

구성에서 "APIDOG_ACCESS_TOKEN": "<access-token>" 줄을 제거하십시오.

각 팀원 컴퓨터에서 APIDOG_ACCESS_TOKEN을 환경 변수로 구성하십시오.

이렇게 하면 버전 관리에서 토큰이 유출되는 것을 방지할 수 있습니다.

온프레미스 배포

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

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project-id=<project-id>",
        "--apidog-api-base-url=<your-server-url>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

<your-server-url>을 온프레미스 서버의 API 주소(http:// 또는 https://로 시작)로 대체하십시오. www.npmjs.com에 네트워크로 액세스할 수 있는지 확인하십시오.

기타 데이터 소스

Apidog에서 게시한 온라인 API 문서를 AI에 연결

OpenAPI 파일을 AI에 연결

FAQ

Apidog Europe을 사용하고 있습니다. MCP 서버를 시작할 때 특별한 구성이 필요합니까?

예. Apidog Europe을 사용하는 경우 --apidog-api-base-url 매개변수를 추가하고 EU API 엔드포인트로 설정해야 합니다.

아래는 구성 예시입니다.

"Pet Store- Apidog": {
  "command": "npx",
  "args": [
    "-y",
    "apidog-mcp-server@latest",
    "--project-id=xxx",
    "--apidog-api-base-url=https://api.eu.apidog.com"
  ],
  "env": {
    "APIDOG_ACCESS_TOKEN": "xxx"
  }
}

Windows 구성 문제

Node.js 버전 문제

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

AI에 Apidog 프로젝트 연결

사전 요구 사항#

필요한 자격 증명 얻기#

Cursor에서 MCP 구성#

중요 참고 사항#

여러 프로젝트로 작업하기#

보안 모범 사례#

온프레미스 배포#

기타 데이터 소스#

FAQ#

사전 요구 사항

필요한 자격 증명 얻기

Cursor에서 MCP 구성

중요 참고 사항

여러 프로젝트로 작업하기

보안 모범 사례

온프레미스 배포

기타 데이터 소스

FAQ