Meertrack

@meertrack/mcp

Meertrack 用の Model Context Protocol サーバーです。Claude、Cursor、Claude Code、VS Code、Windsurf、Cline、ChatGPT、または MCP に対応するあらゆる環境から、エージェントに 「今週、競合他社は何をリリースしましたか？」と尋ねられます。

Meertrack v1 REST API を、読み取り専用ツール 8 個と プロンプトワークフロー 3 個として利用できます。バックエンドの変更は不要で、mt_live_ キーとレート制限はそのままです。

---

トランスポートを選択する

	ローカル（stdio）	リモート（Streamable HTTP）
セットアップ時間	30 秒（JSON ブロックを貼り付け）	10 秒（URL を貼り付け）
最適な用途	個人の Pro 顧客、すべての Claude Desktop プラン、ノート PC 上のあらゆる IDE	チーム／Enterprise のカスタムコネクター、Claude.ai のウェブ版、リモート対応 IDE
実行場所	お使いのマシン（npx -y @meertrack/mcp）	Meertrack の Fly.io フリート（https://mcp.meertrack.com/mcp）
認証	MEERTRACK_API_KEY 環境変数	OAuth 2.1（ブラウザーフロー、推奨）または Authorization: Bearer mt_live_… ヘッダー
プランによる制限	Claude Pro、Team、Enterprise で利用可能	Claude Desktop の「カスタムコネクターを追加」はTeam／Enterprise 限定

Claude Pro をご利用の場合は、ローカル（stdio）方式をお使いください。 Claude Desktop の設定にある「カスタム コネクターを追加」ボタンは Team／Enterprise に限定されています。Pro プランでは、そこに https://mcp.meertrack.com/mcp を貼り付けても何も起こりません。

API キーを取得する

Meertrack アプリの Settings → API Keys で本番キーを発行してください。キーは mt_live_ で始まります。本番キーのみ利用でき、mt_test_ の種類はありません。

レート制限について。 各 API キーには、上流で適用される毎分 60 リクエストの上限が共有されています。MCP を複数のクライアント（Claude Desktop + Cursor + バックグラウンドエージェント）から同時に実行すると、すべてのクライアントが同じ上限を消費します。上限を分けるには、ワークステーションまたはエージェントごとに別々のキーを発行してください。429 エラー時のツールエラーメッセージには、人が読めるリセット時刻と、生の X-RateLimit-Reset エポック時刻の両方が含まれるため、エージェントは自動的にリクエストを控えられます。

---

ローカルインストール：推奨されるデフォルト

ローカルモードのクライアントはすべて、環境に MEERTRACK_API_KEY を設定して npx -y @meertrack/mcp を実行する同じ形式を使います。異なるのは、設定ファイルと その周囲の JSON キーです。

以下のすべての設定ファイルのコピーは examples/ にあります。

Claude Desktop（すべてのプラン）

~/Library/Application Support/Claude/claude_desktop_config.json（macOS） または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

注意点：Claude Desktop は起動時にのみこのファイルを再読み込みします。完全に終了し （macOS では ⌘Q）、再度開いてください。ウィンドウを再読み込みするだけでは不十分です。

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）を編集します。

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

Claude Code（CLI）

claude mcp add meertrack npx -y @meertrack/mcp \
  --env MEERTRACK_API_KEY=mt_live_...

VS Code（GitHub Copilot MCP）

.vscode/mcp.json（ワークスペースごと）またはユーザー設定に相当するファイルを編集します。

{
  "servers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

注意点：VS Code では mcpServers ではなく servers を使います。Claude Desktop のキーを使うと、Copilot MCP ピッカーにサーバーが表示されません。

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      }
    }
  }
}

注意点：Windsurf のリモートコネクター形式では、url ではなく serverUrl を使います。 上記の stdio 設定形式は Claude Desktop と同じです。

Cline（VS Code 拡張機能）

Cline の設定パネル →「MCP Servers」→ 貼り付けます。

{
  "mcpServers": {
    "meertrack": {
      "command": "npx",
      "args": ["-y", "@meertrack/mcp"],
      "env": {
        "MEERTRACK_API_KEY": "mt_live_..."
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

---

リモートインストール：Team／Enterprise ＋ claude.ai Web

すべてのリモートクライアントは同じ URL を参照します。

https://mcp.meertrack.com/mcp

次の 2 つの認証方式に対応しています。

• OAuth 2.1（推奨） — 仕様に準拠した MCP クライアントは、/.well-known/oauth-protected-resource/mcp（RFC 9728 §3.1。ルートを確認するクライアント向けに、/.well-known/oauth-protected-resource でも提供）で認可サーバーを検出し、 https://meertrack.com/oauth/register で動的クライアント登録を行い、PKCE で保護された認可 → トークンの フロー全体を実行します。ユーザーは「接続」をクリックし、meertrack.com でサインインして、同意画面で「許可」をクリックすれば完了です。 キーを扱う必要はありません。アクセストークンは有効期間 1 時間の JWT です （RS256、aud=https://mcp.meertrack.com/mcp）。リフレッシュトークンは OAuth 2.1 §4.3.1 に従ってローテーションされます。
• Authorization: Bearer mt_live_… — カスタムコネクター、 CLI スクリプト、OAuth ディスカバリーにまだ対応していないクライアントでは、静的 API キーを貼り付けてください。

どちらの方式でも同じワークスペースに接続します。クライアントが対応している方式を選んでください。

Claude Desktop（Team／Enterprise のみ：「カスタムコネクターを追加」）

設定 → コネクター → カスタムコネクターを追加 → 上記の URL を貼り付けます。 ベアラートークンは貼り付けないでください。トークン欄は空のままにして「追加」をクリックします。 Claude Desktop がログインと同意のために meertrack.com をブラウザーで開きます。「許可」をクリックすると、コネクターに 8 つのツールが自動的に表示されます。

「カスタムコネクターを追加」ボタンは Pro では表示されません。代わりに、上記の stdio 方式を使用してください。

Claude.ai Web（コネクター）

Web アプリのコネクターパネルで、上記と同じ手順を行います。

Cursor（リモート MCP）

{
  "mcpServers": {
    "meertrack": {
      "url": "https://mcp.meertrack.com/mcp",
      "headers": {
        "Authorization": "Bearer mt_live_..."
      }
    }
  }
}

ChatGPT MCP コネクター

ChatGPT の「MCP を追加」ダイアログに URL とベアラーを貼り付けます。注：現在、ChatGPT のベアラー対応は限定的です。OAuth の完全な互換性は Phase 11 で追跡されています。

n8n／Zapier／…その他の Streamable HTTP クライアント

• エンドポイント：https://mcp.meertrack.com/mcp
• メソッド：POST
• ヘッダー：Authorization: Bearer mt_live_…、Accept: application/json, text/event-stream、MCP-Protocol-Version: 2025-11-25

---

8 つのツール

すべて読み取り専用で、すべて snake_case です。コレクションの取得には list_ プレフィックスを使用し、 行の詳細取得には get_ を使用します（単一 ID または ID のバッチ）。すべてのリスト応答には pagination.next_cursor と pagination.has_more が含まれます。エージェントは次のページを取得するため、 next_cursor を cursor として渡す必要があります。

ドメイン	ツール	呼び出し先	注記
ID	whoami	GET /me	ワークスペース、サブスクリプション、レート制限のスナップショットを確認します。最初に呼び出してください。
競合他社	list_competitors	GET /competitors	エージェントがソーシャル情報やページ情報を取得するために追加のラウンドトリップを行わずに済むよう、デフォルトで expand=full を指定します。
競合他社	get_competitor	GET /competitors/{id}	プロフィールと、追跡対象の各セクション（ブログ、料金、求人、広告など）の最近の項目を、セクションごとの上限付きで返します。
アクティビティ	list_activities	GET /activity	主要な「公開されたもの」フィードです。ツール結果のサイズ制限を超えないよう、デフォルトの limit=50 を使用します。
アクティビティ	get_activity_items	GET /activity/items	バッチで詳細を取得します。1～100 個の行 ID の完全なペイロードを返し、解決できなかった ID は not_found に返します。
ダイジェスト	list_digests	GET /digests	カーソルでページ分割された週次ダイジェストです。アクティビティとは異なり、total フィールドはありません。
ダイジェスト	list_latest_digests	GET /digests/latest	パラメーターなしで、今週の出来事を一度に取得します。
ダイジェスト	get_digest	GET /digests/{id}	競合他社 1 社 × 期間 1 つの完全な概要とテーマを返します。

入力、出力、エラーコードの詳細は各ツールの説明に記載されており、 MCP クライアント内に表示されます。

3 つのプロンプト

Claude Desktop／Cursor／Claude Code／プロンプトに対応したあらゆる MCP クライアントで使えるスラッシュコマンドです。それぞれがツール呼び出しを連鎖させ、ワークフローを完了します。

プロンプト	引数	連鎖する処理
/weekly_recap	なし	list_latest_digests → 競合他社ごとの要約＋ハイライト
/competitor_deep_dive	competitor_name	list_competitors → get_competitor → list_activities（過去 30 日間）
/whats_new	days?（デフォルト 7）	now - N days からの list_activities を競合他社ごとに分類

呼び出し例

• /weekly_recap
• /competitor_deep_dive competitor_name="Acme"
• /whats_new days="14"

ユースケース別（週次チェックイン、機能仕様の調査、価格比較、取締役会資料の準備）に分類した、コピーしてすぐ使えるユーザープロンプトを 12 個掲載している examples/prompts.md をご覧ください。

---

トラブルシューティング

上流 API がエラーを返すと、MCP ツールの応答にはエラーテキスト内に上流の code が表示されます。以下を参考にしてください。

上流の code	意味	対処方法
unauthorized	キーが無効、取り消し済み、または有効期限切れです	Settings → API Keys で新しいキーを発行し、設定を更新してください
competitor_inactive	このワークスペースで競合他社がアーカイブされています	ダッシュボードで競合他社を再有効化してください
forbidden_competitor	渡した id はこのワークスペースにありません	list_competitors を呼び出して、有効な ID を確認してください
rate_limited	1 分あたり 60 リクエストの上限に達しました	エラーメッセージに記載されたリセット時刻まで待つか、もう一方のクライアント用に 2 つ目のキーを発行してください
not_found	このワークスペースに該当する行がありません	ID が間違っているか、別のワークスペースに属しています
invalid_parameter / invalid_cursor	入力値が正しくありません	エラーメッセージを確認してください。カーソルには有効期限があるため、最初からリストを取得し直してください

その他のよくある問題

• Claude Desktop が設定を読み込まない → ウィンドウを閉じるだけでなく、アプリを終了して再起動してください。設定は起動時に読み込まれます。
• command not found: npx → Node ≥ 20 をインストールしてください。MCP では engines.node が固定されています。
• リモート URL が WWW-Authenticate: Bearer とともに 401 を返す → bearer が不足しているか、形式が正しくないか、mt_live_ で始まっていません。
• キーを更新すると解消する 401 が発生する → bearer は問題ありません。MCP からの仕様に準拠した「認証してください」という応答です。Authorization ヘッダーを送信してください。
• 同じキーを使って stdio と remote の両方を実行する → 両方で 1 分あたり 60 リクエストの上限を共有します。クライアントごとに別々のキーを発行してください。

---

セマンティックバージョニング

MCP ツールのスキーマは公開 API 契約の一部であり、エージェントはこれをキャッシュします。そのため、次のようにバージョニングします。

• MAJOR：ツールを削除する場合、または既存ツールの入出力スキーマに互換性のない変更を加える場合（必須引数の追加、フィールド名の変更、列挙値の削除）。
• MINOR：新しいツール、新しい省略可能な引数、または新しいプロンプトを追加する場合。
• PATCH：バグ修正、説明の改善、スキーマに影響しない内部リファクタリング。

リリース履歴については CHANGELOG.md を、メンテナー向けの公開手順については docs/RELEASING.md をご覧ください。

セキュリティとプライバシー

• プライバシーポリシー：https://meertrack.com/privacy
• SECURITY.md：開示ポリシー（[email protected]）、対象範囲。
• docs/PRIVACY.md：MCP レイヤーはステートレスです。bearer はリクエストごとに転送され、何も永続化されません。
• docs/ARCHITECTURE.md：リクエストフロー図。
• docs/OBSERVABILITY.md：ログに記録される内容と bearer トークンのマスキング方法。

ライセンス

MIT.