Singular MCP – ヘルプセンター

概要

Singular MCP とは何ですか?

MCP (Model Context Protocol) は、Singular のデータを ChatGPT や Claude などの LLM クライアントに渡すためのフレームワークです。これにより、LLM が本来備えている強力な分析・可視化機能と、Singular から取得したデータを組み合わせることができます。

どのように動作しますか?

LLM を Singular MCP に接続します (下記の手順を参照)
これで LLM が Singular のデータを扱えるようになります。処理の流れは次のとおりです:
- LLM が関連するプロンプトを受け取ると、そのプロンプトを Singular MCP に転送します。
- Singular MCP はプロンプトを Singular への API クエリに変換し、結果を生成します。
- 返された結果は、LLM がデータを理解し、より適切に分析できるようにする補足コンテキストとともに、ユーザーの LLM に送り返されます。
- LLM は、ユーザーが指示したプロンプトに応じてデータをさらに分析できます。

現在サポートされている LLM はどれですか?

ChatGPT
Claude および Claude Code (有料版)
Cursor
Visual Studio Copilot
その他、MCP サーバーに対応するすべてのクライアント (連携をご希望の場合はサポートまでお問い合わせください)

現在サポートされているデータはどれですか?

Singular MCP は、Singular のメインレポートで参照できるすべてのデータを返すことができます。これには、SDK または S2S から取得した集計トラッカーデータと、ネットワークから取得したコストデータの両方が含まれます。
SKAN データは近日対応予定です

プロンプトの例を教えてください

パフォーマンスが最も高いキャンペーンはどれですか?
過去 30 日間でパフォーマンスが最も高いキャンペーンを棒グラフで表示してください
過去 90 日間のアプリ、ソース、インストール、D7 ROI を表で表示してください

セットアップ方法

ChatGPT - Singular MCP を ChatGPT でセットアップする方法

Singular の GPT ページにアクセスしますこちら - 次の画面が表示されます:
まずは何か質問してみてください。ChatGPT が自動的に Singular MCP へのサインインを求めます:
Singular アカウントにログインします:
完了すると ChatGPT に戻り、接続の確認画面が表示されます。「Confirm」をクリックしてください:
Singular MCP へのクエリを常に許可するには、「Privacy settings」に移動し、MCP ドメインを「Always allow」に変更します:
これでマーケティングデータについて自由に質問できます:

ChatGPT - 開発者モード (ベータ)

ChatGPT には、専用の GPT アプリではなくメインインターフェース上で MCP を接続できる開発者モードというベータ版のオプションもあります。

ほとんどのユーザーには、上記の標準セットアップを推奨します。上級ユーザーは以下の手順に従ってください。

まず、ChatGPT の開発者モードを有効にする必要があります。「+」ボタン、「Use connectors」、「Add sources」、「Connect more」を順にクリックします:
Connectors 画面で下にスクロールして「Advanced settings」に移動し、「Developer mode」を有効にします:
Connectors 画面に戻ると「Create」ボタンをクリックできるようになり、次の URL で Singular の MCP を設定できます:
https://mcp.singular.net/mcp-server/mcp
保存すると、ChatGPT が Singular のログインページに移動します:
ChatGPT に戻ると「Singular is now connected」という通知が表示されます。次に、開発者モードのままであることを確認し、再度「+」ボタンをクリックして「Developer Mode」、「Add sources」を選択し、以下のように Singular のコネクタをオンにします:
さっそく試してみましょう。マーケティングデータについて何か質問し、ChatGPT が Singular のツールを使用しようとしたら「Confirm」をクリックします:

Claude - Singular MCP を Claude / Claude Code でセットアップする方法

Claude のインターフェースで、左側のナビゲーションペインにある Customize [ツールボックスアイコン] をクリックします。
次をクリックします: Connectors
Connectors [中央のナビゲーションペイン] で、ペイン右上の プラス記号アイコン [+] をクリックします。
次をクリックします: Add custom connector .
コネクタのポップアップが表示されます。
コネクタのポップアップウィンドウで:
- 名前を入力します。例: Singular (これが後で Claude の UI に表示される名前になります)
- Integration URL は次のとおりです: https://mcp.singular.net/mcp-server/mcp
これで Singular の連携が一覧に表示されます。

注: 連携項目に「Connect」ボタンが表示されない場合は、30 秒ほど待つか、Claude を再読み込みしてください。
Connect ボタンをクリックします:

注 : Connect をクリックした後に Claude から「Invalid authorization」エラーが返された場合、ブラウザで Claude にログインしていない可能性があります。まず次の URL にログインしてから https://claude.ai/ もう一度 Connect をクリックしてください。
Singular アカウントにログインします
接続が完了しました。有効な連携の一覧に Singular の接続が表示されます
Singular の連携をクリックすると、その連携が接続されている API を確認できます。get_report が Singular の API です
Claude のチャットインターフェースでプロンプトを入力します。
Claude が外部連携を使用することを許可します
Claude Code を使用する場合、UI で追加した MCP が自動的に設定されます。ターミナルで次のコマンドを実行して確認してください:
```
claude mcp list
```
あとはターミナルで claude を実行し、データについて自由に質問してください:

Cursor - Singular MCP を Cursor でセットアップする方法

リモート MCP に対応した最新バージョンの Cursor を使用していることを確認してください。次の URL からダウンロードまたは更新できます: https://cursor.com/home
Cursor の MCP ディレクトリにある Singular のページにアクセスし、「Add to cursor」をクリックします:
https://cursor.directory/mcp/singular
または、Cursor の設定で「Tools & Integrations」に移動し、「New MCP Server」をクリックして、開いた mcp.json ファイルを次のように編集して手動で追加することもできます:
```
{
  "mcpServers": {
    "singular-mcp": {
      "url": "https://mcp.singular.net/mcp-server/mcp",
      "transport": "http",
      "auth": {
        "type": "oauth",
        "loginUrl": "https://app2.singular.net/login"
      }
    }
  }
}
```
Singular の MCP を追加すると Tools & Integrations セクションに戻り、新しいツールとして表示されます。次に「Needs login」リンクをクリックして認証フローを開始します:
Singular アカウントにログインします:
完了すると Claude の IDE に戻り、Singular のツールが有効になっていることを確認できます:
最後に、Cursor の AI ペイン (チャットインターフェース) を開き、「Agent」モードが選択されていることを確認したうえで、マーケティングデータについて自由に質問してください:

Gemini CLI - Singular MCP を Gemini CLI でセットアップする方法

次の手順に従って、最新バージョンの Gemini-CLI がインストールされていることを確認してください: https://github.com/google-gemini/gemini-cli

Singular の MCP を追加するには、~/.gemini/settings.json ファイルに次の内容を追加します:

{
  "mcpServers": {
    "singular-mcp": {
      "httpUrl": "https://mcp.singular.net/mcp-server/mcp",
      "oauth": {
        "enabled": true,
        "authorizationUrl": "https://mcp.singular.net/oauth_server/authorize",
        "tokenUrl": "https://mcp.singular.net/oauth_server/token",
        "clientId": "Gemini",
        "clientSecret": null,
        "scopes": [
          "mcp:read"
        ]
      }
    }
  }
}

Singular の MCP を追加したら、ターミナルで「gemini」を実行して gemini-cli を起動し、次のコマンドを実行します: /mcp auth singular-mcp
Singular にログインし、Gemini CLI に戻って認証が完了していることを確認します:
完了したら、マーケティングデータについて自由に質問し、Gemini が Singular のツールを呼び出すことを許可してください:

Visual Studio Code (Copilot) - Singular MCP を VS Code でセットアップする方法

VS Code のバージョン 1.101 以降を使用していることを確認してください。次の URL からダウンロードまたは更新できます:
https://code.visualstudio.com/updates/
有効な GitHub Copilot のサブスクリプションが必要です。また、GitHub の組織管理者がワークスペースで「MCP servers」機能を有効にする必要があります (GitHub Copilot 設定の「Policies」内にあります):
Visual Studio Code IDE の設定を開き、Features 内の Chat 設定に移動して、MCP が有効になっていることを確認します:
VS Code のコマンドパレット (Shift+Command+P) で「MCP: Add Server」を選択し、「HTTP」オプションを選んで、次の MCP URL を入力します:
https://mcp.singular.net/mcp-server/mcp

完了すると、VS Code が認証プロセスを開始します。
Singular アカウントにログインします:
完了すると VS Code IDE に戻り、Extensions メニューに Singular の MCP がインストールされていることを確認できます:
最後に、VS Code Copilot のチャットインターフェースを開き、「Agent」モードがオンになっていることを確認したうえで、マーケティングデータについて自由に質問してください:

よくある質問

どの LLM またはモデルを使用すべきですか?

LLM にはそれぞれ強みがあります。複数の選択肢を試し、ご自身の質問に最も適したものを見つけることをおすすめします。

MCP が返すデータ量に制限はありますか?

はい。LLM クライアントには、MCP がレスポンスで返せるデータ量に制限があります。
たとえば ChatGPT は問題を防ぐためクエリごとに最大 5 万文字までに制限されており、Claude は最大 10 万文字までサポートしています。

Singular MCP で利用できるフィールドを確認または変更できますか?

はい。デフォルトでは、Singular MCP はお客様のアカウントに関連する最も一般的な指標とディメンションを返します。ただし場合によっては、デフォルトの一覧に含まれない特定のフィールドが不足していることがあります。
こうしたケースに備えて、Singular MCP には関連フィールドを確認・更新するための便利なツールが用意されています:
- get_supported_fields - 現在 MCP で利用できるすべてのフィールドを返します
- update_supported_fields - MCP に追加のフィールドを追加または削除します
たとえば、返されたデータに「ABC」というフィールドが見つからない場合は、次のように試してください:
- 「サポートされているフィールドをすべて表示して」 - 一覧全体を確認し、ABC が別の名前で利用できるかどうかを確認します
- 「'ABC' をサポート対象フィールドに追加して」 - その名前が Singular に存在する場合、関連フィールドとして追加されます
- 「過去 30 日間の ABC を表示して」 - これで該当する結果が返されます

ChatGPT のエラー: 「Your workspace owner hasn't approved this GPT」

ChatGPT のワークスペースをご利用の場合、アカウントでサードパーティ製 GPT が無効になっている可能性があります。Singular の GPT を利用できるようにするには、管理者に以下のワークスペース GPT 設定を開いて有効になっているか確認してもらってください:
https://chatgpt.com/admin/gpts

プライバシーとデータの利用

MCP 経由で渡されたデータはトレーニングに使用されますか?

いいえ。デフォルトでは、当社の MCP に渡されたデータが Singular によるモデルの最適化やトレーニングに使用されることはありません 。Singular は、お客様のコンテキストデータがお客様の環境内に分離されたまま保持され、お客様自身のクエリへの応答にのみ使用されることを保証します。

MCP はユーザーレベルのデータにアクセスできますか?

いいえ。現在 MCP がアクセスできるのは、Singular のメインレポートページに表示される集計データのみです。

Singular MCP では権限が適用されますか?

はい。MCP は、Singular MCP の連携を LLM と接続する際に使用したユーザーと同じデータアクセス権限を持ちます。

コンテキストデータは暗号化されますか?

はい。すべてのコンテキストデータは、業界標準の暗号化プロトコルによって転送中および保存時のいずれも暗号化されます。