전송 방식과 주소
전송 방식과 주소 (Transports and addresses)
이 문서에서는 Grafana MCP 서버가 지원하는 세 가지 전송(transport) 방식과, MCP 클라이언트가 연결하는 방식에 맞는 주소·경로를 설정하는 방법을 알아봐요.
출처: 문서
본문
달성할 목표 (What you'll achieve)
올바른 전송 방식으로 서버를 실행하고, SSE 또는 streamable-http를 사용할 때는 클라이언트가 연결할 수 있는 올바른 주소와 경로를 설정해요.
시작하기 전에 (Before you begin)
- uvx로 설치하기, Docker로 설치하기
stdio 전송 사용 (Use stdio transport)
stdio(바이너리나 uvx로 실행할 때의 기본값)를 사용하면 서버가 표준 입력과 출력으로 클라이언트와 통신해요. 클라이언트가 서버를 하위 프로세스로 실행할 때(예: Claude Desktop, Cursor) 이 방식을 사용해요. --address나 포트는 필요하지 않아요.
mcp-grafana
# 또는
uvx mcp-grafana
SSE 또는 streamable-http 전송 사용 (Use SSE or streamable-http transport)
-t sse 또는 -t streamable-http를 사용하면 서버가 주소(기본값 localhost:8000)에서 수신해요. --address로 호스트와 포트를 바꾸고, 선택적으로 --base-path 또는 --endpoint-path로 경로를 구성할 수 있어요.
mcp-grafana -t sse
mcp-grafana -t streamable-http --address :9090
클라이언트는 서버 URL에 연결해요(예: SSE의 경우 http://localhost:8000/sse). streamable-http의 기본 엔드포인트 경로는 /mcp이며, 클라이언트가 다른 경로를 기대한다면 --endpoint-path로 바꿀 수 있어요.
--base-path는 리스너의 애플리케이션 라우트에 접두어를 붙여요:
mcp-grafana -t sse --address :8000 --base-path /my-base --metrics
이렇게 하면 /my-base/sse를 서비스해요. /healthz와 /metrics는 프로브(probe)와 스크레이퍼(scraper)를 위한 내부 전용 엔드포인트이므로, 이 플래그와 관계없이 항상 서버 루트에 남아 있어요. 절대 --base-path 아래에 두지 마세요.
다음 단계 (Next steps)
- 서버 TLS (streamable-http)
- 클라이언트 TLS