mcpField
V
Vinktar

Vinktar

リモート
vinktar.comデータ・分析01 週間前に更新
リポジトリ公式サイト

Vinktar について

Vinktarは、エラー追跡データとエラー直前のユーザー操作をコーディングエージェントに提供します。MCPサーバー、セットアップスキル、コマンドを通じて、プロジェクト設定やエラー、リリース、影響を受けたユーザーについての質問を支援します。

主な機能

  1. 01エラーと直前のユーザー操作を確認
  2. 02エラーやリリースの傾向を質問
  3. 03スキルによるプロジェクト計測設定
  4. 04データ受信の確認
  5. 05ワークスペースとプロジェクト単位のアクセス制御

活用シーン

  1. 01直近のデプロイ後に発生したエラーを特定
  2. 02影響を受けたユーザーが多いエラーを特定
  3. 03リポジトリに計測を設定しイベントを検証
  4. 04一週間のエラー傾向の変化を確認

MCP 対応

`https://mcp.vinktar.com/mcp`を通じ、ブラウザー認証と範囲を限定した権限で、MCPクライアントにVinktarのワークスペースおよびプロジェクトデータを提供します。付属のセットアップスキルと`/vinktar`コマンドで、プロジェクト設定やエラーデータの照会を行えます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.vinktar.com/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

31
パラメーター型必須説明
namestringはいチームが見るパネルのタイトル。
textstringいいえタイプが "text" の場合：Markdown の本文。パネル行の見出し、または読み方に関する短いメモを指定します。独自の文章のみを使用してください。取得したデータ（エラーメッセージ、ペイロード、URL）は貼り付けないでください。
typeenumはいまず funnel、retention、trends を使用し、これらでは表現できない場合に限り sql を使用します。funnel | retention | trends | issues | text | sql
viewenumいいえファネルのみ：steps（デフォルト。各ステップの離脱数）、compare（各ステップを直前の期間と並べて比較し、「変更の効果があったか」を確認）、timeToConvert、trend（時間経過に伴うコンバージョン率）、bar、table。steps | timeToConvert | trend | compare | bar | table
chartenumいいえtrends の場合：line（デフォルト）は時間経過に伴う推移、area は時間経過に伴う部分から構成される合計（`display.stacked` で積み上げ）、bar は時間経過に伴うセグメントの比較、hbar はセグメントの合計値によるランキング（長い名前、人気ページ、プラン）、share は全体に占める各セグメントの割合（期間内の内訳、最大6項目）、heatmap は週内に一つの系列が発生する時間帯（曜日 × 時刻、UTC。系列は一つ、内訳なし）、scalar は数値一つ、table は行を表示します。retention の場合：table（デフォルト。コホートグリッド）または line（平均曲線）。sql の場合：table（デフォルト）、line、bar。line | area | bar | hbar | share | heatmap | scalar | table
querystringいいえタイプが "sql" の場合：VinktarQL の SELECT 文。
funnelobjectいいえ
funnel.orderenumいいえ"ordered"（デフォルト）：ステップを順番に実行し、間にほかのイベントがあっても構いません。"strict"：ステップ間にイベントを許可しません。"any"：順序は問いません。ordered | strict | any
funnel.stepsarrayはい順序付きステップ：{event, label?, filters?}。
funnel.filtersobjectいいえAND/OR で結合するフィルター：{combinator: "AND", filters: [{property: {scope, key}, op, values: [..]}], groups: [nested groups]}。演算子：eq、neq、in、contains、gt、lt、is_set。値は文字列です。
funnel.filters.groupsarrayいいえ
funnel.filters.filtersarrayいいえ
funnel.filters.combinatorenumはいAND | OR
funnel.breakdownobjectいいえ{scope, key}。scope が "event" の場合はペイロードのプロパティ、"context" の場合は組み込みディメンション（country、browser、page_path、utm_source…）、"session" の場合はセッション、"user" の場合はユーザー属性を指します。
funnel.breakdown.keystringはい
funnel.breakdown.scopeenumはいevent | context | session | user
funnel.conversionWindowobjectいいえファネルに入ったユーザーが完了までに使える時間。例：{value: 1, unit: "day"}。デフォルトは1日です。
funnel.conversionWindow.unitenumはいminute | hour | day | week | month
funnel.conversionWindow.valueintegerはい
issuesobjectいいえタイプ "issues" の場合：ボードの期間内で重要度の高いエラー課題。すべてのフィールドは省略可能です。
issues.sortenumいいえデフォルトは "occurrences" です。occurrences | users | recent
issues.limitintegerいいえ表示する行数。デフォルトは 5 です。
issues.environmentstringいいえこの環境のみ。例："production"。省略するとすべてが対象です。
trendsobjectいいえ
trends.seriesarrayはいメトリクスは 1～5 個。各項目は {event, aggregation, property?, filters?, label?, breakdown?} です。sum、avg、p95 では `property` が必須です。
trends.filtersobjectいいえAND/OR で結合するフィルター：{combinator: "AND", filters: [{property: {scope, key}, op, values: [..]}], groups: [nested groups]}。演算子：eq、neq、in、contains、gt、lt、is_set。値は文字列です。
trends.filters.groupsarrayいいえ
trends.filters.filtersarrayいいえ
trends.filters.combinatorenumはいAND | OR
trends.breakdownsarrayいいえ独自の `breakdown` がない各系列を、1 つのプロパティで分割します。
displayobjectいいえパネルの表示方法。format、stacked、legend はトレンドと SQL 用です。goal と note はテキスト以外のすべてのパネルで使用します。
display.goalnumberいいえユーザーが指定した目標（コンバージョン率、収益額、エラーバジェットなど）を、パネル独自の単位で指定します。format が percent の場合、25% は 0.25 です。グラフでは線として表示され、数値は目標に応じて緑または赤になります。ユーザーが指定した目標のみを使い、決して捏造しないでください。
display.notestringいいえパネルの見方や変化を説明する、タイトル下の平易な一文です。独自の言葉を使い、取得したデータは含めないでください。
display.formatenumいいえ金額には currency、比率には percent を使用します。デフォルトは count です。count | currency | percent
display.legendbooleanいいえ折れ線グラフ：凡例を表示します。デフォルトは true です。
display.stackedbooleanいいえ複数の系列がある棒グラフ：系列を積み上げます。デフォルトは true です。
display.goalDirectionenumいいえ大きいほど良い場合は up（デフォルト）、小さいほど良い場合（エラー数、読み込み時間など）は down を指定します。up | down
projectsarrayいいえこのパネルがデータを読み取るプロジェクトを handle または id で指定します。パネルごとに独自のプロジェクト集合を持つため、1 つのボードに異なるアプリを対象とするパネルを配置できます。省略すると、この接続がアクセスできるすべてのプロジェクトが対象です。
retentionobjectいいえ
retention.periodenumいいえコホートの粒度。デフォルトは "week" です。day | week | month
retention.filtersobjectいいえAND/OR で結合するフィルター：{combinator: "AND", filters: [{property: {scope, key}, op, values: [..]}], groups: [nested groups]}。演算子：eq、neq、in、contains、gt、lt、is_set。値は文字列です。
retention.filters.groupsarrayいいえ
retention.filters.filtersarrayいいえ
retention.filters.combinatorenumはいAND | OR
retention.periodsintegerいいえ各コホートを追跡する期間数。デフォルトは 8 です。
retention.targetEventstringはいユーザーをコホートに含めるイベント（例："signup"）。
retention.returningEventstringはい再訪としてカウントするイベント（例："session_start"）。
sqlReasonstringいいえタイプ "sql" の場合は必須です。ファネル、リテンション、トレンドのいずれのパネルでもこれを表示できない理由を記述します。
dashboardIdstringはいlist_boards または create_board で取得したボード。

詳細

コーディングエージェント向け Vinktar

Vinktar は、各エラーの直前にユーザーが行った操作とともに、コーディングエージェントが読み取れるエラー追跡ツールです。このプラグインは Claude Code、Cursor、Codex に次の 3 つを提供します。

  • Vinktar MCP サーバー（https://mcp.vinktar.com/mcp）。ブラウザーでサインインし、アクセスを許可するワークスペースとプロジェクト、および読み取り、ビルド、設定の権限を選択します。キーを貼り付ける必要はありません。
  • setup スキル。 Claude Code で /vinktar:setup を実行するか、エージェントに「Vinktar をセットアップして」と頼みます。リポジトリを読み取り、標準的な構成でスタックに合った SDK をインストールし、接続経由でプロジェクトの書き込みキーを取得して、ユーザー識別、エラー、ソースマップを連携し、追跡する各イベントを定義し、実際にデータが届いたことを確認して、最後にすべての環境変数と設定先の一覧を表示します。
  • /vinktar コマンド。 /vinktar と入力して、このリポジトリで Vinktar をセットアップするか、セットアップ後に何が壊れたかを確認します。/vinktar what broke after the last deploy? と入力すると、そのまま質問できます。

インストール後は、「今週何が変わった？」や「前回のリリース以降、最も多くのユーザーに影響したエラーは？」などと尋ねられます。

事前にアカウントを作る必要はありません。誰もサインインしていない状態でも、エージェントがプロジェクトを自動で開始し（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 には接続されません。追加後、次の手順を実行します。

  1. プラグインの Connectors タブ、または claude.ai/customize/connectors を開き、Vinktar の横にある「Connect」を選択します。
  2. ブラウザーでサインインするか無料アカウントを作成し、「Build」と「Configure」をオンのままにして承認します。
  3. 新しいチャットを開始します。すでに開いているチャットには接続が反映されません。

続けて「今日何が壊れた？」と尋ねるか、/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 サーバーとして追加します。サインイン画面は自動で検出されます。次に、エージェントに get_install_guide を呼び出すよう依頼します。各クライアントのセットアップ方法： vinktar.com/docs/mcp。

スキルを読み込めるものの、プラグイン形式に対応していないハーネス

.agents/skills/setup/ をリポジトリ（またはツールが参照するホームディレクトリ）にコピーします。これは多くのツールで共通のパスに配置する同じスキルです。MCP サーバーは別途追加する必要があります。

できることとできないこと

エージェントに表示されるのは、承認したワークスペースとプロジェクトで確認できる情報です。削除できるのはボードとパネルのみで、どちらもボードページから 30 日間復元できます。イベント、エラー、イシュー、プロジェクトを削除したり、サインイン後にプロジェクトやキーを作成したり、メンバーや請求を管理したり、データの新しい送信先を追加したりすることはできません。サインイン前は、クレームされるまで誰にも所有されないプロジェクトを 1 つ開始できます。すべての呼び出しはプロジェクトの AI agents ページに記録され、管理者はエージェントを無効にできます。

Vinktar は Free プランを含むすべてのプランで利用できます。データのリクエストは月間の利用枠にカウントされますが、プロジェクトのセットアップはカウントされず、呼び出しごとの料金も発生しません。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。