Zed

Zed

이 가이드는 Zed 편집기용 mcp-grafana 서버를 설정하는 방법을 안내해요.

출처: 문서

본문

전제 조건

  • Zed 편집기 설치
  • 서비스 계정 토큰이 있는 Grafana 9.0+
  • PATH에 있는 mcp-grafana 바이너리

구성

Zed는 settings.json에서 mcpServers가 아닌 context_servers를 사용해요.

UI로 추가

  1. 에이전트 패널을 열어요(Cmd+Shift+A).
  2. 설정(기어 아이콘)을 클릭해요.
  3. Add Custom Server를 클릭해요.
  4. 명령과 인자를 입력해요.

수동 구성

Zed 설정(Cmd+,)을 열고 다음을 추가해요:

{
  "context_servers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": [],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

참고: Zed는 mcpServers가 아닌 context_servers를 사용해요.

Docker 구성

{
  "context_servers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "grafana/mcp-grafana",
        "-t",
        "stdio"
      ],
      "env": {
        "GRAFANA_URL": "http://host.docker.internal:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

디버그 모드

{
  "context_servers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["-debug"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

구성 검증

  1. 에이전트 패널 설정을 열어요.
  2. grafana 옆의 표시등을 확인해요.
    • 녹색 = 서버 활성
    • 다른 색 = 툴팁에서 상태 확인
  3. 에이전트 패널 채팅을 열어요.
  4. "내 Grafana 대시보드를 나열해 줘"라고 물어봐요.

팁: 프롬프트에 "grafana"를 언급하면 모델이 올바른 도구를 고르는 데 도움이 돼요.

도구 권한

기본적으로 Zed는 각 도구 호출에 대해 권한을 묻는답니다. 자동 허용하려면:

{
  "agent": {
    "always_allow_tool_actions": true
  }
}

주의해서 사용하세요. 이것은 확인 없이 모든 MCP 도구를 활성화해요.

문제 해결

서버가 시작되지 않음:

  • Zed 로그를 확인해요: Cmd+Shift+P -> zed: open logs
  • 바이너리 경로 확인: which mcp-grafana
  • 구성 변경 후 Zed를 다시 시작해요.

도구가 나타나지 않음:

  • Zed는 stdio와 HTTP 전송을 모두 지원해요.
  • 원격 서버에는 기본 URL 구문 또는 mcp-remote 셰임(shim)을 사용해요.

원격 서버 (기본 URL 구문): Zed는 원격 MCP 서버에 대한 직접 URL 연결을 지원해요:

{
  "context_servers": {
    "grafana": {
      "url": "http://localhost:8000/sse",
      "headers": {}
    }
  }
}

먼저 서버를 시작해요:

mcp-grafana --transport sse --address localhost:8000

원격 서버 (mcp-remote 대체): mcp-remote 셰임을 사용하는 대안:

{
  "context_servers": {
    "grafana": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8000/sse"]
    }
  }
}

읽기 전용 모드

{
  "context_servers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["--disable-write"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

다음 단계