Revinho

Revinho MCP サーバー

Revinho は、AI エージェントに Revinho ワークスペースのビジネスインテリジェンスへの読み取り専用アクセスを提供します。Google Analytics 4、Stripe、そして任意で Google Search Console のデータを組み合わせ、何が変わったのか、何が重要なのか、何が収益を生み出しているのか、何が不振なのか、次にどこに注力すべきかを明らかにします。

このリポジトリは、Revinho のホスト型 MCP サーバーの公開情報、接続、サポートのための場所です。本番サーバーは Revinho が運用しており、このリポジトリからデプロイされるものではありません。

• MCP エンドポイント：https://www.revinho.com/api/mcp
• トランスポート：Streamable HTTP
• 認証：ワークスペース単位のベアラートークン
• ドキュメント：revinho.com/docs
• レジストリメタデータ：server.json

提供する機能

サーバーは、目的に特化した6つのツールを提供します。

ツール	用途
get_overview	主要なパフォーマンス、期間比較、トレンド、獲得状況の背景、データの鮮度、確定的なシグナル
get_growth	チャネル、参照元、キャンペーン、国、オーガニック検索クエリ、獲得セグメント
get_funnels	保存済みの GA4 ジャーニーと、ステップごとのファネルパフォーマンス
get_pages	ページのトラフィック、重要なイベント、コンバージョン、検索需要、分類、関連する影響
get_revenue	Stripe を情報源とする売上、MRR、サブスクリプション、顧客、返金、プラン、通貨のメタデータ
get_opportunities	根拠とアトリビューションの出所を示した、確定的な機会の優先順位付け

MCP プロンプトに対応するクライアントは、investigate_business も呼び出せます。このプロンプトは、エージェントを根拠に基づく範囲限定の調査へと導き、利用可能な事実で質問に答えられた時点で終了します。

すべてのツールは読み取り専用で、非破壊的かつ冪等であり、閉じた世界の原則に従います。

接続

1. Revinho にサインインし、エージェントをセットアップを開きます。
2. 名前付きのワークスペーストークンを作成します。トークンは rv_live_ で始まり、一度だけ表示されます。
3. ホスト型エンドポイントとトークンを MCP 対応クライアントに追加します。

一般的な設定：

{
  "mcpServers": {
    "revinho": {
      "type": "streamable-http",
      "url": "https://www.revinho.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rv_live_REPLACE_WITH_YOUR_TOKEN"
      }
    }
  }
}

クライアントによって設定形式は異なります。クライアントがシークレットや環境変数の仕組みに対応している場合は、それを使用してください。トークンをリポジトリにコミットしないでください。

質問の例

• 過去30日間でビジネスにどのような変化がありましたか？
• まず注目すべき獲得チャネルはどれですか？
• MRR の成長は、トラフィックやコンバージョンの変化と同時に起きましたか？
• 購入ファネルのどこで最も多くのユーザーが離脱していますか？
• 需要を集めているものの、商業的な成果が振るわないページはどれですか？
• 現時点で最も確度の高い機会は何ですか？

根拠の範囲

Revinho を使用するエージェントは、以下の製品ルールを守ってください。

• 売上の信頼できる情報源は Stripe です。
• 獲得や行動に紐づく売上には、verified、modeled、associated のいずれかのアトリビューションラベルが保持されます。
• 確定的でない関係は、因果関係ではなく、同時に起きた、または関連していると表現します。
• データの鮮度は、プロバイダーの鮮度フィールドに基づいて判断します。応答の生成時刻は基準にしません。
• 欠損データや一部しかないデータを、暗黙のうちにゼロとして扱いません。
• 機会は、確定的なルールと保存された根拠に基づきます。

トークンの安全性

Revinho API トークンは読み取り専用で、ワークスペース単位に制限され、暗号学的ハッシュとして保存され、失効させることができます。

• エージェントまたは環境ごとに個別のトークンを作成してください。
• トークンはシークレットマネージャーまたは非公開のクライアント設定に保管してください。
• トークンを URL、プロンプト、スクリーンショット、issue、ログ、リポジトリに決して含めないでください。
• トークンが漏えいした可能性がある場合は、直ちに失効させてください。

セキュリティ上の問題の報告については、SECURITY.mdをご覧ください。

サポート

• 製品および接続に関するサポート：[email protected]
• セキュリティ報告：[email protected]
• ドキュメント：revinho.com/docs
• リポジトリの問題：公開可能で機密情報を含まないドキュメントまたは互換性の問題には、GitHub Issuesをご利用ください

ライセンス

このリポジトリ内のドキュメントおよびメタデータは、MIT Licenseの下で公開されています。Revinhoのホステッドサービス、製品コード、名称、およびブランドアセットは、このライセンスの対象ではありません。