Sentry MCP

Sentry MCP

Sentry MCP 是一個原型遙控模型上下文協議 (MCP) 伺服器，作為 AI 驅動的 LLM 應用程式與 Sentry API 之間的中介層。它允許與 Sentry 的錯誤監控和可觀察性平台進行無縫、標準化的整合，以便進行先進的代理工作流程或 LLM 驅動的自動化。

Author: getsentry


查看協議

Sentry MCP 是什麼？

Sentry MCP 是一個開源的 MCP 伺服器，旨在通過標準化的模型上下文協議，安全、結構化地訪問您的 Sentry 數據和操作。它允許主機應用程式，如 Claude 桌面應用或集成開發環境 (IDE)，通過符合 MCP 的工具和端點以程式方式與 Sentry 互動。它支持遙控和本地（stdio）傳輸，對雲和自我託管的 Sentry 安裝都非常靈活。

如何配置

  1. 生產環境使用：
    只需訪問已部署的服務 https://mcp.sentry.dev。

  2. 自託管的 Sentry（Stdio 傳輸）：

    • 創建一個具備適當範圍的 Sentry 用戶身份驗證令牌： 
      org:read
project:read
project:write
team:read
team:write
event:write
    • 啟動 MCP 伺服器： 
      npx @sentry/mcp-server@latest --access-token=sentry-user-token --host=sentry.example.com
    • 或者，使用環境變數進行配置： 
      SENTRY_ACCESS_TOKEN=
SENTRY_HOST=

  3. 本地開發：

    • 在 Sentry 中創建一個 OAuth 應用，使用 http://localhost:5173 作為首頁 URL 和重定向 URI。
    • 將您的憑據添加到 packages/mcp-cloudflare/ 中的 .dev.vars 文件： 
      SENTRY_CLIENT_ID=your_client_id
SENTRY_CLIENT_SECRET=your_client_secret
COOKIE_SECRET=my-super-secret-cookie
    • 本地運行伺服器： 
      pnpm dev

如何使用

  1. 訪問 https://mcp.sentry.dev 獲取託管伺服器，或根據以上說明運行您的本地/stdio 實例。
  2. 使用 MCP 檢查器：
    • 輸入您的伺服器 URL （例如，http://localhost:5173）並連接。
    • 按提示進行身份驗證（OAuth 或訪問令牌）。
    • 通過“列表工具”功能發現可用工具。
    • 從檢查器或 LLM 兼容的客戶端直接調用所需的工具端點（例如，獲取問題、列出項目）。
  3. 對於自託管的 Sentry，使用相關令牌運行，並以“stdio”模式連接。
  4. 使用 pnpm test 運行測試，並通過設置 OPENAI_API_KEY 進行 LLM 支持的評估 pnpm eval。

主要特點

  • 通過符合 MCP 規範的協議與 Sentry 整合，實現 LLM/代理訪問錯誤數據和操作
  • 支持遙控 HTTP(S) 和本地 stdio 傳輸，適用於各種部署類型
  • OAuth 和基於令牌的身份驗證，確保安全訪問 Sentry 資源
  • 提供一組可發現的、可執行的工具（操作/端點），便於自動化和數據檢索
  • 可擴展，開放給本地開發和貢獻
  • 包含內置檢查器工具，便於互動探索和測試

使用案例

  • 允許基於 LLM 的代理或助手在 IDE 或統一桌面環境中監控、獲取或分流 Sentry 事件
  • 自動化常規 Sentry 操作，如問題分配、狀態變更或通知，通過 AI 工作流程觸發
  • 將 Sentry 可觀察性數據整合到基於語言模型的自定義儀表板或報告工具中
  • 通過安全、標準化的 API 實現零觸摸的 Sentry 管理或分流，無需手動編寫腳本

常見問題

Q1: 我可以在自託管的 Sentry 實例中使用 Sentry MCP 嗎？
可以，Sentry MCP 通過 stdio 傳輸模式支持自託管實例。您需要提供具備必要許可的用戶身份驗證令牌並相應配置主機。

Q2: 我需要建立一個 OAuth 應用來在本地測試 Sentry MCP 嗎？
在本地開發和測試中，您需要在 Sentry 帳戶中註冊一個 OAuth 應用，並在項目的配置文件中提供其憑據。

Q3: LLM 是否可以通過 MCP 工具修改我的 Sentry 數據？
可以，通過 MCP 暴露的工具可以根據工具和您的令牌許可讀取和修改 Sentry 中的數據。始終將提供的令牌限制到所需的範圍。

Q4: 我如何測試 MCP 伺服器的整合？
使用內置的檢查器工具連接到您的 MCP 伺服器 URL。這允許您進行身份驗證、發現和互動式調用工具，方便驗證。

Q5: 支持哪些身份驗證方法？
Sentry MCP 支持 OAuth（用於遠程伺服器）和基於訪問令牌（用於本地/stdio）的身份驗證流程。