Raygun
chính thứcTươ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
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_searchvà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_latesthoặcdeployment_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_analyzehoặcapm_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_searchvà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_statusvà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_sendvà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
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
- Tài khoản Raygun với gói đăng ký đang hoạt động
- Một máy khách MCP hỗ trợ OAuth hoặc Raygun Personal Access Token
🚀 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ộ.
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.comvà 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ạnapplications_search- Tìm kiếm ứng dụng theo tênapplication_get_details- Lấy thông tin chi tiết về ứng dụngapplication_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ụngerror_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ỉnherror_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ỗierror_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ỗierror_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ụngdeployment_create- Tạo bản ghi triển khai mớideployment_get_latest- Lấy lần triển khai gần nhất với phân tích lỗideployment_investigate- Lấy thông tin triển khai toàn diệndeployment_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 danhcustomer_investigate- Lấy hồ sơ khách hàng, nhóm lỗi gần đây và phiênsessions_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ẫuapm_issue_investigate- Kiểm tra số liệu của một vấn đề và các trace bị ảnh hưởngapm_traces_search- Tìm yêu cầu backend chậm hoặc thất bạiapm_trace_investigate- Kiểm tra luồng profiler và các lệnh gọi quan trọng trong một traceapm_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ụngpage_investigate- Lấy chi tiết trang cho truy vấn số liệumetrics_website_performance_analyze- Theo dõi xu hướng hiệu suất theo thời gianmetrics_performance_distribution_analyze- Hiểu biến động hiệu suấtmetrics_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óminvitation_send- Gửi lời mời nhóm mớiinvitation_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:
- Điều hướng đến Raygun Personal Access Tokens
- Nhấp Tạo token mới
- Đặt tên mô tả cho token của bạn (ví dụ: "MCP Server Access")
- Chọn quyền phù hợp cho trường hợp sử dụng của bạn
- 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
- 📚 Tài liệu Raygun
- 📘 Hướng dẫn thiết lập MCP Raygun
- 🔌 Tham chiếu API Raygun
- 🤖 Model Context Protocol
- 🐛 Báo cáo sự cố
Được xây dựng với ❤️ bởi Raygun