다중 조직과 헤더

다중 조직과 헤더 (Multi-organization and headers)

이 문서에서는 Grafana MCP 서버를 특정 Grafana 조직에 지정하고, Grafana로 보내는 모든 요청에 커스텀 HTTP 헤더를 추가하는 방법을 알아봐요.

출처: 문서

모든 Grafana API 호출이 선택한 조직 컨텍스트를 사용하고, 필요한 추가 헤더(예: 테넌트 또는 커스텀 인증)도 자동으로 전송돼요.

GRAFANA_ORG_ID를 숫자 조직 ID로 설정해요. 그러면 서버가 Grafana로 보내는 모든 요청에 X-Grafana-Org-Id를 전송해요.

SSE 또는 streamable-http를 사용할 때는 클라이언트에서 X-Grafana-Org-Id를 보낼 수도 있어요. 헤더가 환경 변수보다 우선하므로 요청별로 기본 조직을 덮어쓸 수 있어요.

위 설정은 연결 전체에 조직을 고정해요. 단일 연결이 호출마다 다른 조직을 대상으로 하려면 --dynamic-multi-org 플래그로 서버를 시작해요. 이 기능은 기본적으로 꺼져 있어요.

활성화하면:

이 기능은 둘 이상의 조직에 속한 자격 증명(예: 사용자 또는 on-behalf-of 신원)에만 동작해요. 서비스 계정 토큰은 단일 조직에 묶여 있어요. user_info 도구를 호출해 어떤 orgId 값이 유효한지 확인해요.

GRAFANA_EXTRA_HEADERS에 헤더 이름을 값에 매핑하는 JSON 객체를 설정해요. 이 헤더들은 모든 Grafana API 요청에 추가돼요.

예시:

"GRAFANA_EXTRA_HEADERS": "{\"X-Custom-Header\": \"value\", \"X-Tenant-ID\": \"tenant-123\"}"