롤바 MCP 서버

Rollbar API 통합을 위한 동적 MCP 서버 구현으로 LLM이 Rollbar 오류 추적 데이터와 상호 작용할 수 있습니다.

특징

오류 항목 나열 및 필터링
자세한 오류 정보를 얻으세요
오류 발생 보기
프로젝트 및 환경 세부 정보 접근
배포 추적
사용자 및 팀 목록

구성

환경 변수

ROLLBAR_PROJECT_TOKEN : Rollbar 프로젝트 액세스 토큰 - API가 프로젝트 오류 및 배포 정보를 검색하는 데 필요합니다.
ROLLBAR_ACCOUNT_TOKEN : Rollbar 계정 액세스 토큰 - API가 계정 전체 프로젝트 및 사용자 정보에 액세스하는 데 필요합니다.
ROLLBAR_PROJECT_ID : 기본 프로젝트 ID(요청에 지정되지 않은 경우 사용) - 선택 사항
ROLLBAR_PROJECT_NAME : 참조용 기본 프로젝트 이름 - 선택 사항

참고 : 사용하는 기능에 따라 ROLLBAR_PROJECT_TOKEN , ROLLBAR_ACCOUNT_TOKEN 또는 둘 다 필요합니다. 모든 기능을 사용하려면 두 토큰을 모두 구성하는 것이 좋지만, 서비스는 특정 API에 해당하는 토큰만 사용하여 작동합니다.

필수 토큰 및 API 대응표

API	필수 토큰
`rollbar_list_items`	롤바 프로젝트 토큰
`rollbar_get_item`	롤바 프로젝트 토큰
`rollbar_get_item_by_counter`	롤바 프로젝트 토큰
`rollbar_list_occurrences`	롤바 프로젝트 토큰
`rollbar_get_occurrence`	롤바 프로젝트 토큰
`rollbar_list_environments`	롤바 프로젝트 토큰
`rollbar_list_deploys`	롤바 프로젝트 토큰
`rollbar_get_deploy`	롤바 프로젝트 토큰
`rollbar_list_projects`	롤바 계정 토큰
`rollbar_get_project`	롤바 계정 토큰
`rollbar_list_users`	롤바 계정 토큰
`rollbar_get_user`	롤바 계정 토큰

다음과 같이 Rollbar 액세스 토큰을 얻을 수 있습니다.

Rollbar 계정에 로그인하세요( https://rollbar.com/ )
프로젝트 토큰의 경우: 설정 -> 프로젝트 액세스 토큰(프로젝트 수준 액세스용)
계정 토큰의 경우: 설정 -> 계정 액세스 토큰(계정 수준 액세스용)
"read" 범위로 새 토큰을 만듭니다.

사용 방법

커서 통합

~/.cursor/mcp.json 에 다음을 추가합니다.

지엑스피1

장소 상에서

이 저장소를 복제한 후 다음 단계에 따라 MCP 클라이언트를 설정하세요.

$ cd mcp-rollbar-server
$ npm install
$ npm run build

~/.cursor/mcp.json 에 다음을 추가합니다.

{
    "mcpServers": {
      "rollbar-mcp": {
        "command": "YOUR_NODE_PATH",
        "args": ["YOUR_PROJECT_PATH/mcp-rollbar-server/dist/src/index.js"],
        "env": {
          "ROLLBAR_PROJECT_TOKEN": "YOUR_PROJECT_ACCESS_TOKEN",
          "ROLLBAR_ACCOUNT_TOKEN": "YOUR_ACCOUNT_ACCESS_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

"YOUR_NODE_PATH" 값을 찾으려면 터미널에서 which node를 실행하세요.

사용 예

List the most recent errors in my production environment.

오류 세부 정보 보기

Get detailed information for error item with ID 12345, including stack trace and recent occurrences.

배포 추적

Show me the recent deployments for project 67890.

레벨별 오류 필터링

List all critical errors that occurred in the last week.

도구

롤바_목록_항목

Rollbar에서 항목(오류) 목록

입력:
- status (문자열, 선택 사항): 상태(활성, 해결됨, 음소거 등)로 필터링합니다.
- level (문자열, 선택 사항): 레벨(중요, 오류, 경고, 정보, 디버그)로 필터링
- environment (문자열, 선택 사항): 환경(프로덕션, 스테이징 등)으로 필터링합니다.
- limit (숫자, 선택 사항): 반환할 최대 항목 수(기본값: 20)
- page (번호, 선택 사항): 페이지 번호(기본값: 1)
반환: 카운터, 레벨, 총 발생 횟수 등의 세부 정보가 포함된 오류 항목 목록

롤바_겟_아이템

Rollbar 시스템에서 유지 관리하는 내부 항목 ID를 사용하여 Rollbar에서 특정 항목(오류)을 가져옵니다.

입력:
- id (숫자): 항목 ID
반환: 특정 오류 항목에 대한 자세한 정보

롤바_카운터_항목_가져오기

Rollbar에서 프로젝트 카운터로 특정 항목을 가져옵니다. 카운터는 Rollbar UI에 표시되는 ID입니다.

입력:
- counter (숫자): 해당 항목에 대한 프로젝트 카운터
반환: 프로젝트 카운터에서 식별된 특정 오류 항목에 대한 자세한 정보

롤바_목록_발생

Rollbar에서 발생한 오류 목록

입력:
- itemId (숫자, 선택 사항): 발생 항목을 필터링할 항목 ID
- limit (숫자, 선택 사항): 반환할 최대 발생 횟수(기본값: 20)
- page (번호, 선택 사항): 페이지 번호(기본값: 1)
반환: 자세한 정보가 포함된 오류 발생 목록

롤바_get_occurrence

Rollbar에서 특정 오류 발생을 가져옵니다.

입력:
- id (문자열): 발생 ID
반환: 특정 오류 발생에 대한 자세한 정보

롤바_리스트_프로젝트

Rollbar에서 프로젝트 목록 보기

입력: 없음
반환: ID, 이름 및 상태가 포함된 프로젝트 목록

롤바_겟_프로젝트

Rollbar에서 특정 프로젝트 가져오기

입력:
- id (숫자): 프로젝트 ID
반환: 특정 프로젝트에 대한 자세한 정보

롤바_목록_환경

Rollbar에서 환경 나열

입력:
- projectId (숫자): 프로젝트 ID
반환: 지정된 프로젝트에 대한 환경 목록

롤바_리스트_사용자

Rollbar에서 사용자 목록 보기

입력: 없음
반환: ID, 사용자 이름, 이메일 및 액세스 수준이 포함된 사용자 목록

롤바_겟_유저

Rollbar에서 특정 사용자 가져오기

입력:
- id (숫자): 사용자 ID
반환: 특정 사용자에 대한 자세한 정보

롤바_리스트_배포

Rollbar에서 배포 목록

입력:
- projectId (숫자): 프로젝트 ID
- environment (문자열, 선택 사항): 환경 이름
- limit (숫자, 선택 사항): 반환할 최대 배포 수(기본값: 20)
- page (번호, 선택 사항): 페이지 번호(기본값: 1)
반환: 지정된 프로젝트 및 환경에 대한 배포 목록

롤바_겟_디플로이

Rollbar에서 특정 배포 가져오기

입력:
- deployId (숫자): 배포 ID
반환: 특정 배포에 대한 자세한 정보