MCP 및 API 플러그 인을 로컬로 디버그

팁

권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.

플러그 인을 사용하면 Microsoft 365 Copilot의 선언적 에이전트가 MCP(모델 컨텍스트 프로토콜) 서버 또는 REST API를 호출하여 데이터를 검색하고 작업을 수행할 수 있습니다. Microsoft 365 Copilot은 인터넷을 통해 MCP 또는 API 서버에 연결해야 합니다. 일반적으로 디버깅 도구는 디버깅 도구를 실행하는 컴퓨터에서만 액세스할 수 있는 (127.0.0.1)에서 localhost 디버그 세션을 호스팅합니다. 개발 터널과 같은 역방향 프록시를 사용하면 디버그 세션을 인터넷에 노출하여 Microsoft 365 Copilot에서 호출을 디버깅할 수 있습니다.

이 문서에서는 MCP 서버 또는 API에 대한 로컬 디버깅을 사용하도록 도구를 사용하는 방법을 devtunnel 보여줍니다.

참고

디버깅 도구가 이미 역방향 프록시 솔루션을 제공할 수 있습니다. 개발자 도구의 설명서에서 확인하는 것이 좋습니다. 예를 들어 Microsoft 365 에이전트 도구 키트를 사용하여 새 API를 만든 경우 도구 키트에서 역방향 프록시 구성을 처리합니다.

필수 구성 요소

  • devtunnel 디버그 세션을 호스트하는 컴퓨터에 설치된 CLI
  • 디버깅 도구에서 사용하는 HTTP 포트 번호입니다

영구 개발 터널 만들기

devtunnel CLI를 사용하면 호스트된 URL을 변경하지 않고 필요에 따라 중지하고 시작할 수 있는 터널인 영구 개발 터널을 만들 수 있습니다. 영구 URL이 있는 터널을 사용하면 선언적 에이전트 앱 패키지를 새 URL로 업데이트할 필요가 없으므로 플러그인에 대한 디버깅이 간소화됩니다.

  1. devtunnel CLI에 아직 로그인하지 않은 경우 사용 가능한 옵션을 확인하는 데 사용합니다 devtunnel user login --help . 계속하기 전에 CLI에 로그인합니다.

  2. 익명 액세스를 허용하는 터널을 만듭니다. 익명 액세스는 Microsoft 365 Copilot이 터널에 액세스할 수 있도록 하는 데 필요하며 API에 필요한 인증과 관련이 없습니다.

    devtunnel create --allow-anonymous
    

    팁

    새 터널을 생성하면 기본 터널이 새로 생성된 터널로 전환됩니다. 이렇게 하면 후속 명령에 대한 인수를 생략 tunnel-id 할 수 있습니다. 여러 터널을 만드는 경우 인수를 tunnel-id 사용하여 예상 터널을 사용하고 있는지 확인해야 할 수 있습니다. 자세한 내용은 명령을 사용 devtunnel --help 하거나 개발 터널 명령줄 참조를 참조하세요.

  3. 디버깅 도구에서 사용하는 HTTP 포트 번호를 추가합니다. 포트 번호로 바꾸 <port> 고 디버깅 도구가 포트에서 HTTPS를 사용하는 경우 또는 http HTTPS를 사용하지 않는 경우 매개 변수 https 를 --protocol 설정합니다.

    devtunnel port create --port-number <port> --protocol https
    
  4. 개발 터널을 시작합니다.

    devtunnel host
    
  5. 이 개발 터널을 처음 실행하는 경우 브라우저를 통해 연결이라고 레이블이 지정된 URL을 복사합니다. 브라우저에서 이 URL을 열고 계속을 선택하여 터널을 사용하도록 설정합니다.

    참고

    계속을 선택하면 브라우저에 오류가 표시됩니다. 이는 예상된 것이며 무시될 수 있습니다.

터널이 활성화되면 CTRL + C를 사용하여 터널을 중지할 수 있습니다. 명령을 사용하여 터널을 다시 시작할 수 있습니다.devtunnel host host-id

개발자 터널 사용

디버깅에 개발 터널을 사용하려면 서버 URL 대신 개발 터널의 URL을 사용하여 앱 패키지를 사이드로드합니다.

플러그 인 매니페스트 내에서 MCP 서버 사양 개체의 속성을 설정합니다url.

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "<your-dev-tunnel-url>",
    }
  }
]

Visual Studio Code에서 에이전트 도구 키트를 사용하여 선언적 에이전트를 관리하는 경우 환경 변수를 /env/.env.dev.user 파일에 PLUGIN_SERVER_URL 추가하고 개발 터널 URL 대신 사용할 수 있습니다. 수명 주기 창의 프로비저닝 단계를 사용하여 에이전트를 사이드로드합니다. /env/.env.dev.user 파일에 다음을 추가합니다.

OPENAPI_SERVER_URL=<your-dev-tunnel-url>

플러그인 매니페스트에서 속성을 업데이트합니다.url

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "${{PLUGIN_SERVER_URL}}",
    }
  }
]

에이전트 도구 키트를 사용하지 않는 경우 새 앱 패키지 ZIP 파일을 생성하고 에이전트를 업로드할 수 있습니다.