用途:通过 Jam.dev 的 MCP(Model Context Protocol)服务器访问 Jam 缺陷报告数据,适合排查问题、整理缺陷、分析录制内容。
主要能力:列出与筛选 Jam(按文本、类型、文件夹、作者、URL、日期);获取 Jam 详情;读取控制台日志(按 error、warn、info、log、debug 过滤);列出网络请求(按 statusCode、contentType、host、limit 过滤);读取用户事件(点击、输入、页面跳转);提取截图;获取视频转录(WebVTT);对视频做 AI 分析;读取自定义元数据;列出文件夹与团队成员;添加 Markdown 评论;将 Jam 移动到文件夹。
使用方式:MCP 端点为 https://mcp.jam.dev/mcp,使用 JSON-RPC 2.0 over HTTP 与 Bearer token 认证。需先初始化会话,再调用工具。示例:curl -s -X POST "https://mcp.jam.dev/mcp" --header "Content-Type: application/json" --header "Authorization: Bearer $JAM_TOKEN" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"vm0","version":"1.0.0"}}}' -D /tmp/jam_headers.txt | jq .。之后可用 tools/list 发现工具,用 tools/call 调用具体工具,如 listJams、getDetails、getConsoleLogs、getNetworkRequests、getUserEvents、getScreenshot、getVideoTranscript、analyzeVideo、getMetadata、listFolders、listMembers、createComment、updateJam。多数工具需要 jamUrl,格式为 https://jam.dev/c/JAM_ID。
限制:读操作需 mcp:read,写操作(评论、移动)需 mcp:write;PAT 有强制过期时间(7 天至 1 年);API 有速率限制,遇到 HTTP 429 需退避;请求失败可用 zero doctor check-connector --env-name JAM_TOKEN 或 zero doctor check-connector --url https://mcp.jam.dev/mcp --method POST 排查。