​
개요

Rootly MCP(Multiplayer Collaboration Protocol) 서버를 사용하면 Cursor, Windsurf, Claude와 같은 IDE 환경 내에서 신속하게 프로덕션 인시던트를 해결할 수 있습니다. 이 오픈 소스 도구는 Rootly의 OpenAPI 사양에서 MCP 리소스를 동적으로 생성하여 개발 워크플로우 내에서 원활한 인시던트 관리 기능을 제공합니다.

이것은 Rootly AI Labs에서 개발한 프로토타입이며 프로덕션 사용을 위한 것이 아닙니다.

​
기능

  • 동적 리소스 생성: Rootly의 OpenAPI 사양에서 MCP 리소스를 자동으로 생성합니다
  • 기본 페이지네이션: 인시던트 엔드포인트에 대한 내장 페이지네이션(10개 항목)을 제공합니다
  • 보안 및 컨텍스트 최적화: 향상된 보안 및 컨텍스트 관리를 위해 노출된 API 경로를 제한합니다
  • IDE 통합: 인기 있는 개발 환경과 함께 작동합니다

​
지원되는 엔드포인트

서버는 다음을 포함하여 약 20-25개의 화이트리스트 API 엔드포인트에 대한 액세스를 제공합니다:

  • 인시던트: 인시던트에 액세스하고 관리합니다
  • 알림: 특정 인시던트에 대한 알림을 관리합니다
  • 심각도: 심각도 구성에 액세스합니다
  • 팀: 팀 정보를 관리합니다
  • 서비스: 서비스 구성에 액세스합니다
  • 그리고 종합적인 인시던트 관리를 위한 추가 엔드포인트

​
전제 조건

  • Python 3.12 이상
  • uv 패키지 관리자
  • 유효한 Rootly API 토큰

​
설치

​
옵션 1: PyPI를 통해 설치 (권장)

pip install rootly-mcp-server

​
옵션 2: 호스팅된 MCP 서버에 연결

로컬 설치 없이 Rootly의 호스팅된 MCP 서버에 직접 연결:

{
  "mcpServers": {
    "rootly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.rootly.com/sse",
        "--header",
        "Authorization:${ROOTLY_AUTH_HEADER}"
      ],
      "env": {
        "ROOTLY_AUTH_HEADER": "Bearer <YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}

이 옵션은 다음을 제공합니다:

  • 설치 및 유지 관리 오버헤드 없음
  • 항상 최신 기능으로 업데이트됨
  • 관리되는 인프라 및 안정성
  • 로컬 설정 없이 즉시 액세스

​
옵션 3: 자체 호스팅 배포

배포에 대한 완전한 제어가 필요한 조직의 경우:

git clone https://github.com/Rootly-AI-Labs/Rootly-MCP-server
cd Rootly-MCP-server
uv pip install .

이 옵션을 통해 다음을 수행할 수 있습니다:

  • 자체 인프라에서 MCP 서버 호스팅
  • 서버 구성 및 엔드포인트 사용자 정의
  • 내부 보안 정책 준수 보장
  • 데이터 흐름 및 API 액세스 패턴 제어

​
구성

​
PyPI 설치의 경우 (옵션 1)

MCP 클라이언트 구성 파일에 다음 구성을 추가하세요:

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": [
        "--from",
        "rootly-mcp-server",
        "rootly-mcp-server"
      ],
      "env": {
        "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}

​
API 토큰 얻기

모든 설치 옵션에 대해 Rootly API 토큰이 필요합니다. Account > Manage API keys > Generate New API Key에서 생성하세요.

  • 옵션 1 및 3의 경우: 토큰을 직접 ROOTLY_API_TOKEN
  • 옵션 2의 경우: 토큰을 Bearer 접두사와 함께 사용하세요.ROOTLY_AUTH_HEADER

​
개발자 설정

개발 및 테스트 목적으로:

  1. 의존성 설치:

    uv pip install .

  2. 가상 환경 생성:

    uv venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

  3. 테스트 클라이언트 실행:

    python test_mcp_client.py

​
사용자 정의

에서 구성을 수정하여 노출되는 API 경로를 사용자 정의할 수 있습니다 src/rootly_mcp_server/server.py. 이를 통해 MCP 서버를 통해 사용 가능한 Rootly API 엔드포인트를 제어할 수 있습니다.

​
지원

이 통합은 Rootly AI Labs에서 Apache-2.0 라이선스 하에 오픈 소스 프로젝트로 개발 및 유지 관리됩니다. 이 프로젝트는 시스템 안정성과 운영 우수성에 중점을 두며, 커뮤니티의 기여와 피드백을 환영합니다.

질문이나 문제가 있는 경우:

​
관련 문서