Maqui Analytics

Maqui Analytics MCP サーバー

地域の事業者や代理店向けの、Instagram、広告、ウェブトラフィック、SEO、レビューを網羅するマーケティング分析用 MCP です。

サーバー URL： https://app.somosmaqui.com/api/mcp

---

質問できること

Maqui を AI アシスタントに接続すれば、ダッシュボードを見たりタブを切り替えたりすることなく、自然な言葉であらゆるマーケティングチャネルに関する情報を取得できます。

チャネル	質問できること
Instagram	リーチ、エンゲージメント率、人気の投稿、フォロワー数の推移、ハッシュタグのパフォーマンス
Google Ads	キャンペーンやキーワード別の広告費、CTR、CPC、コンバージョン、CPA、ROAS
Meta Ads	Facebook と Instagram の広告費、リーチ、リード、メッセージ、購入
Google Analytics 4	セッション、ユーザー、直帰率、人気ページ、トラフィックソース
Search Console	オーガニッククリック数、表示回数、検索順位、人気の検索クエリとページ
Microsoft Clarity	セッション、エンゲージメント、行動シグナル、人気ページ、トラフィックソース
レビュー	Google Business と Facebook の評価、返信率、最近のレビュー
CRM / リード	ステータスと流入元別のパイプラインリード
POS 売上	チャネル（店内飲食、デリバリー、カウンター）別の Fudo のレストラン売上

プロンプトの例

• 「先月の Instagram のパフォーマンスを、その前の月と比較するとどうでしたか？」
• 「今四半期、最も ROAS が高い Google Ads キャンペーンはどれですか？」
• 「今週、オーガニック検索で人気の検索クエリ上位 5 件を教えてください」
• 「過去 30 日間の星 1 つのレビューをすべて表示してください」
• 「1 月に Meta Ads とオーガニック検索から獲得したリード数を教えてください」

---

対応クライアント

Streamable HTTP と PKCE による OAuth 認証に対応した MCP クライアントを接続します。Maqui は、承認済みのクライアント登録、または承認済みオリジンからの Client ID Metadata Document を受け付けます。認識されていないクライアントやコールバック URL は拒否されます。別のクライアントのサポートについては Maqui にお問い合わせください。

カスタムの Authorization ヘッダーを受け付けるクライアントでは、アカウントごとの API トークンも使用できます。mcp-remote などのローカル stdio ブリッジが、この代替方法に対応しています。

---

認証

公開エンドポイントでは、リソース検出、PKCE S256、明示的な同意に対応した OAuth を利用できます。Maqui アカウントにサインインして、読み取りアクセスを承認してください。OAuth アクセストークンの有効期限は 1 時間です。クライアントが offline_access を要求すると、リフレッシュトークンはローテーションされ、有効期限は 30 日です。再利用すると、トークンファミリーは失効します。以前の OAuth 接続は再接続が必要です。

保護されたリソースのメタデータ：https://app.somosmaqui.com/.well-known/oauth-protected-resource/api/mcp。
認可サーバーのメタデータ：https://app.somosmaqui.com/.well-known/oauth-authorization-server。

既存のベアラー API トークンは、Maqui の管理パネルから引き続き利用できます。各 API トークンは 1 つのアカウントに限定され、有効期限は 1 年で、個別に取り消すことができます。このエンドポイントでは、ツールの検出とデータのクエリのどちらにも有効なトークンが必要です。実際の事業データへのアクセスは Maqui が提供します。

合成デモ

OAuth 同意画面で合成データだけで試すを選択すると、サインインせずに22個すべてのツールを試せます。デモの応答には明示的にマークが付けられ、2026年9月の架空の例が使われます。クライアントの指標を照会することはなく、account_idを変更してもデモトークンで実データにアクセスすることはできません。リクエストした日付範囲は固定のサンプル期間とは別に表示されます。デモではすべてのフィルターが適用されるわけではありません。

ディレクトリのヘルスチェックには、認証済みのMaqui管理者が発行する、別途取り消し可能なデモ用Bearerトークンを使用できます。有効期間は30日です。ダッシュボードで管理 → MCPトークン → Glama用デモトークンを生成を選択してデモの応答を確認し、ディレクトリのテストプロファイルを設定してください。この認証情報はREADMEやリポジトリで公開しないでください。ディレクトリごとに別の認証情報を使用してください。

Glamaコネクターは、2026年10月9日にHealthyであることが確認されました。インデックス登録済みのツールは22個で、管理 → テストプロファイル → API Key → Bearer Authenticationで合成デモを使用しています。このテストプロファイルではデモ用Bearerトークンを使用します。GlamaとのOAuth互換性を確立するものではありません。チェックを有効な状態に保つには、30日間の有効期限が切れる前にデモを更新してください。

直接接続するStreamable HTTP

リモートMCP URLとカスタムヘッダーに対応するクライアント向けです。

{
  "mcpServers": {
    "maqui": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

ローカルstdioブリッジ

ローカルのMCPプロセスを起動するクライアント向けです（Node.jsが必要です）。

{
  "mcpServers": {
    "maqui": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.somosmaqui.com/api/mcp",
        "--header",
        "Authorization:Bearer ${MAQUI_TOKEN}"
      ],
      "env": {
        "MAQUI_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

実際のトークンを公開リポジトリや共有設定例に含めないでください。

---

代理店向け

Maquiは、複数のクライアントを管理するマーケティング代理店向けに構築されています。クライアントアカウントごとにデータセットが分離され、専用のAPIトークンが割り当てられます。アカウント間でデータにアクセスすることはできません。

複数のクライアントを管理している場合は、それぞれのクライアントに、そのデータだけにアクセスできる専用のトークンが割り当てられます。クライアントとの契約が終了したら、管理パネルからそのクライアントのトークンを取り消してください。アクセスは直ちに停止し、他のクライアントのトークンは引き続き使用できます。AIクライアントには複数のインスタンスを設定できます。

{
  "mcpServers": {
    "maqui-cliente-a": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": { "Authorization": "Bearer TOKEN_CLIENTE_A" }
    },
    "maqui-cliente-b": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": { "Authorization": "Bearer TOKEN_CLIENTE_B" }
    }
  }
}

---

Maquiについて

Maquiは、レストラン、小売業、サービス業向けのマーケティング分析プラットフォームです。Instagram、Google Ads、Meta Ads、Google Analytics、Search Console、Google Businessのレビュー、POSシステムから毎日データを同期し、対話型インターフェースを通じてクエリできるようにします。

→ somosmaqui.com