关于 Vinktar
Vinktar 将错误跟踪数据及错误发生前的用户操作提供给编码 Agent。它结合 MCP 服务、setup 技能和命令，支持配置项目，并查询错误、版本发布及受影响用户情况。
主要功能
- 01查看错误及此前的用户操作
- 02询问错误与版本发布趋势
- 03通过技能配置项目埋点
- 04检查数据是否已收到
- 05按工作区和项目限制访问
适用场景
- 01查找近期部署后出现的错误
- 02识别影响用户最多的错误
- 03为代码库配置埋点并验证事件
- 04查看一周内错误趋势的变化
MCP 相关
通过 `https://mcp.vinktar.com/mcp` 向 MCP 客户端提供 Vinktar 工作区和项目数据，并使用浏览器登录及范围限定的权限。配套的 setup 技能和 `/vinktar` 命令可帮助 Agent 配置项目并查询错误数据。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://mcp.vinktar.com/mcpclaude mcp add --transport http com-vinktar https://mcp.vinktar.com/mcp{"mcpServers":{"com-vinktar":{"type":"http","url":"https://mcp.vinktar.com/mcp"}}}在 Cursor 中打开{"servers":{"com-vinktar":{"type":"http","url":"https://mcp.vinktar.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-vinktar":{"type":"http","url":"https://mcp.vinktar.com/mcp"}}}{"mcpServers":{"com-vinktar":{"serverUrl":"https://mcp.vinktar.com/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
31| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 团队成员看到的面板标题。 |
| text | string | 否 | 类型为 "text" 时：Markdown 正文。可用作面板行的标题，或简要说明如何阅读这些面板。只能使用你自己的文字：切勿将捕获的数据（错误消息、负载、URL）粘贴到其中。 |
| type | enum | 是 | 优先使用 funnel、retention 和 trends；仅在这些类型无法表达时使用 sql。funnel | retention | trends | issues | text | sql |
| view | enum | 否 | 仅适用于漏斗：steps（默认值，显示每一步的流失情况）、compare（将每一步与前一时段并列比较，用于判断“变更是否有效”）、timeToConvert、trend（随时间变化的转化率）、bar 或 table。steps | timeToConvert | trend | compare | bar | table |
| chart | enum | 否 | 对于 trends：line（默认值），显示随时间变化的趋势；area 显示随时间变化的部分构成总量（使用 `display.stacked` 堆叠）；bar 按时间比较细分项；hbar 按细分项的总量排序（长名称、热门页面、套餐）；share 显示各细分项在整体中所占比例（按所选时间范围拆分，最多六个部分）；heatmap 显示单个序列在一周内的发生时间（工作日 × 小时，UTC；单个序列，不拆分）；scalar 显示一个数字；table 显示行。对于 retention：table（默认值，群组网格）或 line（平均曲线）。对于 sql：table（默认值）、line 或 bar。line | area | bar | hbar | share | heatmap | scalar | table |
| query | string | 否 | 类型为 "sql" 时：VinktarQL SELECT 语句。 |
| funnel | object | 否 | |
| funnel.order | enum | 否 | "ordered"（默认值）：按顺序执行步骤，中间允许出现其他事件；"strict"：步骤之间不允许出现任何事件；"any"：顺序不限。ordered | strict | any |
| funnel.steps | array | 是 | 有序步骤：{event, label?, filters?}。 |
| funnel.filters | object | 否 | 使用 AND/OR 组合的筛选条件：{combinator: "AND", filters: [{property: {scope, key}, op, values: [..]}], groups: [nested groups]}。操作符：eq、neq、in、contains、gt、lt、is_set。值为字符串。 |
| funnel.filters.groups | array | 否 | |
| funnel.filters.filters | array | 否 | |
| funnel.filters.combinator | enum | 是 | AND | OR |
| funnel.breakdown | object | 否 | {scope, key}。scope 为 "event" 时表示负载属性，"context" 表示内置维度（country、browser、page_path、utm_source…），"session" 表示会话，"user" 表示用户特征。 |
| funnel.breakdown.key | string | 是 | |
| funnel.breakdown.scope | enum | 是 | event | context | session | user |
| funnel.conversionWindow | object | 否 | 用户进入漏斗后完成转化的时限，例如 {value: 1, unit: "day"}。默认值为 1 天。 |
| funnel.conversionWindow.unit | enum | 是 | minute | hour | day | week | month |
| funnel.conversionWindow.value | integer | 是 | |
| issues | object | 否 | 对于类型 "issues"：看板时间范围内优先级最高的错误问题。所有字段均为可选。 |
| issues.sort | enum | 否 | 默认值为 "occurrences"。occurrences | users | recent |
| issues.limit | integer | 否 | 显示的行数，默认值为 5。 |
| issues.environment | string | 否 | 仅限此环境，例如 "production"。省略则表示全部环境。 |
| trends | object | 否 | |
| trends.series | array | 是 | 一到五个指标。每项格式为：{event, aggregation, property?, filters?, label?, breakdown?}。sum、avg 和 p95 必须提供 `property`。 |
| trends.filters | object | 否 | 使用 AND/OR 组合的筛选条件：{combinator: "AND", filters: [{property: {scope, key}, op, values: [..]}], groups: [nested groups]}。操作符：eq、neq、in、contains、gt、lt、is_set。值为字符串。 |
| trends.filters.groups | array | 否 | |
| trends.filters.filters | array | 否 | |
| trends.filters.combinator | enum | 是 | AND | OR |
| trends.breakdowns | array | 否 | 按一个属性拆分每个未设置自身 `breakdown` 的序列。 |
| display | object | 否 | 面板的呈现方式。format、stacked 和 legend 适用于趋势图和 SQL；goal 和 note 适用于除文本面板以外的所有面板。 |
| display.goal | number | 否 | 用户指定的目标（转化率、收入数值或错误预算），使用面板自身的单位：使用 percent 格式时，25% 填 0.25。图表会将其显示为一条线；数值会根据目标变为绿色或红色。只能使用用户给出的目标，切勿自行编造。 |
| display.note | string | 否 | 标题下方的一句普通文本，说明如何阅读面板或发生了什么变化。使用自己的措辞，不得包含采集的数据。 |
| display.format | enum | 否 | 金额使用 currency，比例使用 percent；默认值为 count。count | currency | percent |
| display.legend | boolean | 否 | 折线图：显示图例。默认值为 true。 |
| display.stacked | boolean | 否 | 包含多个序列的柱状图：将其堆叠。默认值为 true。 |
| display.goalDirection | enum | 否 | 当数值越大越好时使用 up（默认值）；当数值越小越好时使用 down（例如错误数、加载时间）。up | down |
| projects | array | 否 | 此面板读取的项目，可按 handle 或 id 指定：每个面板有自己的项目集合，因此一个看板可以包含读取不同应用数据的面板。省略则包含此连接可访问的所有项目。 |
| retention | object | 否 | |
| retention.period | enum | 否 | 队列粒度。默认值为 "week"。day | week | month |
| retention.filters | object | 否 | 使用 AND/OR 组合的筛选条件：{combinator: "AND", filters: [{property: {scope, key}, op, values: [..]}], groups: [nested groups]}。操作符：eq、neq、in、contains、gt、lt、is_set。值为字符串。 |
| retention.filters.groups | array | 否 | |
| retention.filters.filters | array | 否 | |
| retention.filters.combinator | enum | 是 | AND | OR |
| retention.periods | integer | 否 | 跟踪每个队列的周期数。默认值为 8。 |
| retention.targetEvent | string | 是 | 将用户纳入队列的事件（例如 "signup"）。 |
| retention.returningEvent | string | 是 | 用于统计用户回访的事件（例如 "session_start"）。 |
| sqlReason | string | 否 | 对于类型 "sql"，必填：说明为什么漏斗、留存或趋势面板都无法呈现此内容。 |
| dashboardId | string | 是 | 看板，取自 list_boards 或 create_board。 |
详细介绍
面向编码 Agent 的 Vinktar
Vinktar 是一种错误跟踪工具，你的编码 Agent 可以读取错误信息，以及每个错误发生前用户的操作。此插件为 Claude Code、Cursor 和 Codex 提供三项功能：
- Vinktar MCP 服务（
https://mcp.vinktar.com/mcp）。你可以在浏览器中登录，并选择工作区、它可访问的项目，以及读取、构建或配置权限。无需粘贴密钥。 setup技能。 在 Claude Code 中运行/vinktar:setup，或让你的 Agent“设置 Vinktar”。它会读取你的代码仓库，为你的技术栈按标准布局安装 SDK，通过连接获取项目的写入密钥，接入用户识别、错误和源映射，定义所跟踪的每个事件，检查实际收到的数据，最后列出每个环境变量及其设置位置。/vinktar命令。 输入/vinktar，即可在此代码仓库中设置 Vinktar；设置完成后，也可以用它了解出了什么问题。/vinktar what broke after the last deploy?可以直接提问。
安装完成后，可以询问“这周有什么变化？”或“自上次发布以来，哪些错误影响了最多人？”之类的问题。
你无需提前创建账户。任何人登录前，Agent 都可以自行创建一个项目（start_project），用它的密钥设置应用并检查数据是否到达；然后你打开它提供的认领链接，即可登录或创建账户，并保留该项目及其数据。未认领的项目最多可接收 10,000 个事件，7 天后会连同数据一起删除。
安装
Claude Code
claude plugin marketplace add vinktarhq/agent
claude plugin install vinktar@vinktar
运行 /vinktar:setup。你可以在登录前设置应用；之后若要询问数据相关问题，请运行 /mcp，选择 vinktar 并完成身份验证。
Claude（claude.ai、桌面应用、Cowork）
添加插件不会连接 Vinktar。添加后：
- 打开插件的 Connectors 选项卡，或前往 claude.ai/customize/connectors，然后点击 Vinktar 旁边的 Connect。
- 在浏览器中登录或创建免费账户，保持 Build 和 Configure 处于启用状态，然后批准。
- 开始新聊天。已经打开的聊天不会获取此连接。
然后询问“今天出了什么问题？”，或输入 /vinktar。
Cursor
在 Customize → Plugins → From GitHub Repository 下导入此代码仓库。Cursor 首次连接时会提示你登录。
Codex
codex plugin marketplace add vinktarhq/agent
codex plugin add vinktar@vinktar
codex mcp add vinktar --url https://mcp.vinktar.com/mcp
最后一行会添加此连接，并在浏览器中打开登录页面。
其他 MCP 客户端
将 https://mcp.vinktar.com/mcp 添加为 Streamable HTTP 服务；它会自动找到登录方式。然后让你的 Agent 调用 get_install_guide。各客户端的设置说明：
vinktar.com/docs/mcp。
可读取技能但没有插件格式的运行环境
将 .agents/skills/setup/ 复制到你的代码仓库（或你的主目录，具体取决于工具查找技能的位置）。这是同一个技能，路径是大多数工具都认可的路径；还需要单独添加 MCP 服务。
它能做什么，不能做什么
Agent 看到的内容与你在已批准的工作区和项目中看到的内容相同。它只能删除看板和面板，而且这些内容在看板页面上保留 30 天，可供恢复。它无法删除事件、错误、问题或项目；你登录后也无法让它创建项目或密钥、管理成员或账单，或添加新的数据发送目的地。登录前，它可以创建一个项目，该项目在你认领前不属于任何人。每次调用都会记录在项目的 AI agents 页面中，管理员可以关闭 Agent。
Vinktar 适用于所有套餐，包括 Free。数据请求会计入每月额度；设置项目不会计入，也不会按调用次数收费。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。