Raygun

chính thức

Tương tác với dữ liệu báo cáo sự cố và giám sát thời gian thực trên tài khoản Raygun của bạn

GitHub
22
Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Raygun MCP?

  • Điều tra các nhóm lỗi — Yêu cầu tìm kiếm và kiểm tra các nhóm lỗi bằng error_groups_search và error_group_investigate để lấy stack trace và ngữ cảnh.
  • Theo dõi các bản triển khai — Sử dụng deployment_get_latest hoặc deployment_investigate để liên hệ các lỗi mới với các bản phát hành gần đây.
  • Phân tích hiệu suất — Truy vấn metrics_website_performance_analyze hoặc apm_hotspots_search để tìm các phương thức chậm, truy vấn cơ sở dữ liệu hoặc sự suy giảm thời gian tải trang.
  • Khám phá phiên của khách hàng — Tra cứu hoạt động của người dùng bằng customers_search và session_investigate để xem trải nghiệm thất bại ở đâu.
  • Quản lý trạng thái lỗi — Cập nhật trạng thái giải quyết hoặc thêm bình luận qua error_group_update_status và error_group_add_comment.
  • Xem lại lời mời nhóm — Liệt kê, gửi hoặc thu hồi lời mời bằng invitations_manage, invitation_send và invitation_revoke.

Tài liệu

🔭 Máy chủ MCP Raygun

Điều tra lỗi và hiệu suất trong Raygun với trợ lý AI

MCP API Status Docs

Một máy chủ Model Context Protocol (MCP) từ xa kết nối trợ lý AI với Raygun Crash Reporting, Real User Monitoring và Application Performance Monitoring.

📘 Hướng dẫn thiết lập • 📚 Tài liệu tham khảo công cụ • 🚀 Bắt đầu nhanh


✨ Tính năng chính

  • 🐛 Quản lý lỗi - Điều tra, giải quyết và theo dõi lỗi ứng dụng cùng sự cố với đầy đủ stack trace và ngữ cảnh
  • 🚀 Theo dõi triển khai - Giám sát các bản phát hành và đối chiếu lỗi với các lần triển khai để xác định thay đổi có vấn đề
  • ⚡ Thông tin chi tiết về hiệu suất - Phân tích thời gian tải trang, số liệu người dùng và xu hướng hiệu suất theo thời gian
  • 🔬 Điều tra APM - Tìm điểm nghẽn backend, vấn đề hiệu suất tái diễn và trace chậm
  • 👥 Giám sát người dùng - Theo dõi phiên khách hàng, mẫu hành vi và xác định người dùng bị ảnh hưởng
  • 🤝 Cộng tác nhóm - Quản lý lời mời và phối hợp giải quyết lỗi trong nhóm của bạn
  • 📊 Số liệu và phân tích - Phân tích chuỗi thời gian và biểu đồ phân phối cho lỗi và hiệu suất

📋 Yêu cầu

🚀 Bắt đầu

Máy chủ MCP Raygun được lưu trữ tại:

https://api.raygun.com/v3/mcp

Raygun lưu trữ và cập nhật dịch vụ, vì vậy không cần cài đặt gói hoặc máy chủ cục bộ.

Install in Cursor Install in VS Code

OAuth (khuyến nghị)

Thêm URL dưới dạng máy chủ HTTP Streamable mà không có tiêu đề Authorization. Khi kết nối lần đầu, máy khách MCP của bạn sẽ mở Raygun trong trình duyệt để bạn đăng nhập, chọn gói, xem lại các quyền được yêu cầu và ủy quyền truy cập.

Bạn không cần cung cấp ID máy khách OAuth hoặc bí mật máy khách. Raygun hỗ trợ đăng ký máy khách tự động.

Codex và ứng dụng ChatGPT dành cho máy tính để bàn
codex mcp add raygun --url https://api.raygun.com/v3/mcp
codex mcp login raygun

Cấu hình này được dùng chung bởi Codex CLI, tiện ích mở rộng Codex IDE và ứng dụng ChatGPT dành cho máy tính để bàn trên cùng một máy chủ Codex.

Trong ứng dụng ChatGPT dành cho máy tính để bàn, mở Cài đặt > Máy chủ MCP, chọn Thêm máy chủ, chọn HTTP Streamable và nhập điểm cuối Raygun. Lưu và khởi động lại ứng dụng, sau đó chọn Xác thực cho Raygun.

ChatGPT trên web sử dụng công cụ MCP từ xa thông qua Plugins và không đọc cấu hình MCP Codex cục bộ của bạn. Một Raygun Plugin được xuất bản riêng sẽ được cài đặt từ danh mục Plugins.

Claude Code
claude mcp add --transport http raygun https://api.raygun.com/v3/mcp

Chạy /mcp trong Claude Code và làm theo luồng xác thực trình duyệt.

Cursor
{
  "mcpServers": {
    "raygun": {
      "url": "https://api.raygun.com/v3/mcp"
    }
  }
}

Cursor sẽ nhắc bạn xác thực khi kết nối.

VS Code
{
  "servers": {
    "raygun": {
      "type": "http",
      "url": "https://api.raygun.com/v3/mcp"
    }
  }
}

VS Code sẽ nhắc bạn xác thực khi kết nối.

Personal Access Token

Xác thực PAT vẫn được hỗ trợ cho các máy khách không hỗ trợ MCP OAuth và cho tự động hóa. Ví dụ sau sử dụng định dạng cấu hình của Cursor; các máy khách khác sử dụng cùng tiêu đề Authorization trong cấu hình máy chủ HTTP của họ:

{
  "mcpServers": {
    "raygun": {
      "url": "https://api.raygun.com/v3/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}

💬 Câu lệnh đầu tiên của bạn

Sau khi cấu hình, hãy thử hỏi trợ lý AI của bạn:

  • "Tìm các lỗi xuất hiện lần đầu sau lần triển khai mới nhất của ứng dụng thanh toán của tôi."
  • "Điều tra lỗi sản xuất xảy ra thường xuyên nhất và hiển thị cho tôi một stack trace đại diện."
  • "Phương thức backend hoặc truy vấn cơ sở dữ liệu nào tiêu tốn nhiều thời gian nhất trong 24 giờ qua?"
  • "Hiển thị cho tôi phiên cuối cùng của khách hàng user@example.com và giải thích nơi trải nghiệm của họ thất bại."
  • "So sánh hiệu suất trang p95 trong bảy ngày qua và xác định mức suy giảm lớn nhất."

🛠️ Công cụ

Máy chủ MCP Raygun cung cấp các danh mục công cụ sau:

📱 Ứng dụng
  • applications_list - Liệt kê tất cả ứng dụng trong tài khoản Raygun của bạn
  • applications_search - Tìm kiếm ứng dụng theo tên
  • application_get_details - Lấy thông tin chi tiết về ứng dụng
  • application_regenerate_api_key - Tạo khóa API mới cho một ứng dụng
🐛 Quản lý lỗi
  • error_groups_list - Liệt kê các nhóm lỗi trong một ứng dụng
  • error_groups_search - Tìm kiếm sự cố theo lỗi, stack trace, URL, phiên bản, người dùng, thẻ hoặc dữ liệu tùy chỉnh
  • error_group_investigate - Lấy thông tin chi tiết đầy đủ về một nhóm lỗi cụ thể
  • error_group_update_status - Thay đổi trạng thái nhóm lỗi (giải quyết, bỏ qua, kích hoạt)
  • error_group_add_comment - Thêm ghi chú điều tra vào một nhóm lỗi
  • error_group_read_comments - Xem lại các ghi chú điều tra hiện có
  • error_group_instances_list - Liệt kê các sự cố trong một nhóm lỗi
  • error_instance_get - Lấy stack trace đầy đủ và ngữ cảnh cho một sự cố
🚀 Triển khai
  • deployments_list - Liệt kê các lần triển khai cho một ứng dụng
  • deployment_create - Tạo bản ghi triển khai mới
  • deployment_get_latest - Lấy lần triển khai gần nhất với phân tích lỗi
  • deployment_investigate - Lấy thông tin triển khai toàn diện
  • deployment_manage - Cập nhật hoặc xóa một lần triển khai
👥 Khách hàng và phiên
  • customers_search - Tìm kiếm khách hàng theo tên, email hoặc mã định danh
  • customer_investigate - Lấy hồ sơ khách hàng, nhóm lỗi gần đây và phiên
  • sessions_list - Liệt kê phiên người dùng với dữ liệu môi trường và thiết bị
  • session_investigate - Kiểm tra môi trường, lỗi và lượt xem trang của một phiên
🔬 Giám sát hiệu suất ứng dụng
  • apm_issues_search - Tìm vấn đề hiệu suất backend tái diễn và phản mẫu
  • apm_issue_investigate - Kiểm tra số liệu của một vấn đề và các trace bị ảnh hưởng
  • apm_traces_search - Tìm yêu cầu backend chậm hoặc thất bại
  • apm_trace_investigate - Kiểm tra luồng profiler và các lệnh gọi quan trọng trong một trace
  • apm_hotspots_search - Xếp hạng phương thức chậm, truy vấn cơ sở dữ liệu và lệnh gọi bên ngoài
📊 Hiệu suất và số liệu
  • pages_list - Liệt kê các trang được giám sát trong một ứng dụng
  • page_investigate - Lấy chi tiết trang cho truy vấn số liệu
  • metrics_website_performance_analyze - Theo dõi xu hướng hiệu suất theo thời gian
  • metrics_performance_distribution_analyze - Hiểu biến động hiệu suất
  • metrics_error_trends_analyze - Theo dõi tỷ lệ lỗi và mẫu lỗi
🤝 Quản lý nhóm
  • invitations_manage - Liệt kê và xem lại lời mời nhóm
  • invitation_send - Gửi lời mời nhóm mới
  • invitation_revoke - Hủy lời mời đang chờ xử lý

Để có tài liệu chi tiết về từng công cụ, hãy xem Tài liệu tham khảo công cụ.

🔐 Xác thực

OAuth

Raygun triển khai luồng ủy quyền MCP cho máy khách HTTP. Máy chủ quảng bá máy chủ ủy quyền của mình thông qua OAuth Protected Resource Metadata và các máy khách tương thích tự đăng ký bằng Client ID Metadata Documents hoặc Dynamic Client Registration.

Quyền truy cập gắn với người dùng Raygun, gói và phạm vi được phê duyệt trên màn hình đồng ý. Các máy khách tương thích lưu trữ và làm mới token của riêng họ một cách an toàn.

Mỗi kết nối OAuth cấp quyền truy cập vào một gói Raygun. Thêm một cấu hình MCP Raygun khác và ủy quyền riêng khi bạn cần làm việc với một gói khác.

Bảo mật và quyền truy cập

  • OAuth không bao giờ cấp cho máy khách quyền truy cập nhiều hơn người dùng Raygun đã đăng nhập.
  • Quyền đọc và ghi được kiểm soát bởi các phạm vi được phê duyệt trong OAuth hoặc được gán cho PAT.
  • Một số công cụ có thể thay đổi dữ liệu Raygun, bao gồm trạng thái lỗi, triển khai, lời mời, bình luận và khóa API ingestion. Xem lại các hành động ghi trước khi phê duyệt chúng trong máy khách MCP của bạn.
  • Các công cụ ứng dụng có thể trả về hoặc xoay vòng khóa API ingestion. Xử lý khóa được trả về như thông tin xác thực; xoay vòng khóa ngay lập tức vô hiệu hóa khóa trước đó.
  • Kết quả công cụ có thể được đưa vào các cuộc hội thoại được xử lý bởi máy khách AI hoặc nhà cung cấp mô hình bạn chọn. Tuân theo chính sách của tổ chức bạn về việc chia sẻ dữ liệu chẩn đoán và dữ liệu khách hàng.

Lấy Personal Access Token

PAT vẫn khả dụng khi OAuth không phù hợp:

  1. Điều hướng đến Raygun Personal Access Tokens
  2. Nhấp Tạo token mới
  3. Đặt tên mô tả cho token của bạn (ví dụ: "MCP Server Access")
  4. Chọn quyền phù hợp cho trường hợp sử dụng của bạn
  5. Sao chép token được tạo và gửi dưới dạng Authorization: Bearer YOUR_PAT_TOKEN

Giữ PAT an toàn và không bao giờ cam kết chúng vào kiểm soát phiên bản.

Để biết thêm chi tiết, hãy xem tài liệu API Raygun.


📖 Giới thiệu

Máy chủ MCP Raygun cho phép trợ lý AI điều tra dữ liệu Crash Reporting, RUM và APM; theo dõi triển khai; phân tích hiệu suất; và quản lý giám sát ứng dụng thông qua các cuộc hội thoại ngôn ngữ tự nhiên.

🔗 Tài nguyên


Được xây dựng với ❤️ bởi Raygun

Raygun