Grovs

Grovs上でディープリンク、分析、アプリ設定を管理するためのMCPサーバーです。
Claude Code、Cursor、Windsurf、およびMCP互換のあらゆるクライアントで動作します。

ウェブサイト · ドキュメント · 課題

---

Grovsとは？

Grovsは、モバイルアプリ向けのオープンソースでプライバシーを最優先するグロースプラットフォームです。Branch.ioやAppsFlyerに代わるセルフホスト可能な選択肢です。次の機能を提供します。

• ディープリンク — iOS、Android、ウェブ全体で、ユーザーを適切なコンテンツに誘導する単一のリンクです。ディファードディープリンクはインストールの過程を通じて維持されるため、ユーザーは初回起動時に適切な画面に移動できます。
• アトリビューション — 決定論的なファーストパーティのインストールおよびイベントアトリビューションです。フィンガープリンティングは行わず、広告ネットワークとのデータ共有もありません。
• 収益分析 — アプリ内購入、サブスクリプション、カスタム収益イベントを、インストールにつながったキャンペーンに紐付けます。
• キャンペーン — リンクをグループ化してパフォーマンスを追跡し、チャネルごとに結果を比較できます。

EUでホストされ、SDKはオープンソースで、本番環境では1日あたり2,000万人以上のアクティブユーザーに利用されています。セルフホストについては、バックエンドのリポジトリをご覧ください。

このMCPサーバーとは？

これは、AIアシスタントが自然言語を使ってGrovsプラットフォームを管理できるMCP（Model Context Protocol）サーバーです。エディターを離れることなく、ディープリンクの作成、分析の確認、リダイレクトの設定、キャンペーンの実行ができます。

クイックスタート

Claude Code

/plugin marketplace add grovs-io/mcp
/plugin install grovs@grovs

MCPサーバーと、ClaudeにGrovsの使い方を教えるスキルをインストールします。初回利用時にはOAuth認証のためのブラウザーウィンドウが開きます。APIキーは不要です。

Cursor

Settings > MCPを開き、新しいサーバーを追加します。

{
  "mcpServers": {
    "grovs": {
      "url": "https://mcp.grovs.io/mcp"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.jsonに追加します。

{
  "mcpServers": {
    "grovs": {
      "serverUrl": "https://mcp.grovs.io/mcp"
    }
  }
}

VS Code（GitHub Copilot）

.vscode/mcp.jsonに追加します。

{
  "servers": {
    "grovs": {
      "type": "http",
      "url": "https://mcp.grovs.io/mcp"
    }
  }
}

ChatGPT Desktop

Settings > MCP Servers > Add Serverを開き、次の値を入力します。

https://mcp.grovs.io/mcp

セルフホスト

独自のGrovsバックエンドを実行している場合は、MCPサーバーをローカルで実行し、クライアントの接続先を設定します。

git clone https://github.com/grovs-io/mcp.git
cd mcp
npm install && npm run build
npm start

または、Dockerを使用します。

docker build -t grovs-mcp .
docker run -p 8080:8080 grovs-mcp

その後、上記のいずれかのクライアント設定で、サーバーURLとしてhttp://localhost:8080/mcpを使用します。

すべてのクライアントでは初回利用時にOAuthフローが開始され、Grovsアカウントで認証するためのブラウザーウィンドウが開きます。

設定

変数	デフォルト	説明
PORT	8080	サーバーのポート
GROVS_API_URL	https://mcp.grovs.io	GrovsバックエンドのURL（セルフホスト時に上書き）
PUBLIC_URL	http://localhost:8080	このMCPサーバーの公開URL（OAuthコールバックに使用）

ローカル開発では、.env.exampleを.envにコピーします。

ツール

ツール	説明
get_status	アカウント情報、インスタンス、プロジェクト、ドメイン
get_usage	インスタンスの使用状況メトリクスとサブスクリプションの状態
create_project	本番用プロジェクトとテスト用プロジェクトを含む新しいインスタンスを作成
create_link	メタデータ、タグ、カスタムデータを含むディープリンクを作成
get_link	パスを指定してリンクの詳細をすべて取得
update_link	リンクのメタデータ、タグ、リダイレクトを更新
archive_link	リンクを無効化（元に戻せません）
search_links	ページネーションとフィルターを使用してリンクを検索・一覧表示
get_analytics_overview	プロジェクトレベルのメトリクス：ビュー数、インストール数、オープン数、収益
get_link_analytics	リンクごとの日次メトリクス
get_top_links	ビュー数で順位付けしたパフォーマンス上位のリンク
create_campaign	関連するリンクをグループ化するキャンペーンを作成
list_campaigns	集計メトリクスとともにキャンペーンを一覧表示
archive_campaign	キャンペーンをアーカイブし、そのリンクを無効化
configure_redirects	プラットフォームごとのリダイレクト動作を設定（App Store、Play Store、Web）
configure_sdk	iOS／Android SDK の設定（バンドル ID、チーム ID など）

アーキテクチャ

MCP Client (Claude Code, Cursor, etc.)
    │
    │  MCP protocol over HTTP
    ▼
Express app (src/app.ts)
    │
    ├── OAuth flow (/authorize, /callback, /register)
    │
    └── MCP endpoint (/mcp)
            │
            ├── Tool registration (src/server.ts)
            │       Zod schema validation + runWithAuth error boundary
            │
            ├── Handlers (src/tools/handlers.ts)
            │       Business logic, plain functions, throw on error
            │
            ├── Formatters (src/tools/formatters.ts)
            │       Convert API JSON to human-readable text
            │
            └── API client (src/api-client.ts)
                    HTTP calls to Grovs backend

開発

npm run dev          # start with auto-reload
npm run build        # compile TypeScript
npm test             # run tests (186 tests)
npm run test:watch   # run tests in watch mode
npm run lint         # ESLint
npm run format       # Prettier

プロジェクト構成と PR のガイドラインについては、CONTRIBUTING.md をご覧ください。

SDK

プラットフォーム	リポジトリ
iOS	grovs-io/grovs-ios
Android	grovs-io/grovs-android
React Native	grovs-io/grovs-react-native
Flutter	grovs-io/grovs-flutter

ライセンス

MIT