DataFast MCP

MCP を使い始める

AIアシスタントをDataFastに接続して、トラフィック、収益、カスタム目標について質問したり、承認したウェブサイトの運用を管理したりできます。APIアクセス権を持つDataFastアカウントが必要です。

接続方法を選ぶ

いずれか1つの方法を選択してください。どちらもStreamable HTTPを使用してDataFastと通信します。

• OAuthでサインイン — CodexやClaude Codeなど、OAuthサインインを提供するクライアントに推奨されます。DataFast上でウェブサイトと権限を選択します。クライアントが接続トークンを自動的に処理します。APIキーを作成したりコピーしたりする必要はありません。
• APIトークンを使用 — Bearerトークンを要求するクライアント向けです。DataFastでスコープ付きアカウントトークンを作成し、クライアントの設定に追加します。

どちらの方法でも同じDataFastツールを利用できます。OAuth権限では、アナリティクス、ウェブサイト管理、アカウント操作、認証情報管理を個別に承認できます。各方法でサポートされている内容については、ツールリファレンスを参照してください。

OAuthで接続する

1. クライアントにDataFastを追加する

以下のURLでリモートMCPサーバーを追加し、OAuthまたはサインインを選択します。

https://datafa.st/api/mcp

Codexの場合、サーバーを追加してブラウザでのサインインを完了します：

codex mcp add datafast --url https://datafa.st/api/mcp

後で再度サインインするには、codex mcp login datafastを実行します。クライアントメタデータドキュメントと動的登録の両方がサポートされており、ネイティブのループバックコールバックも含まれます。DataFastがすでにBearerトークンで設定されている場合は、OAuthに切り替える前に、クライアントのDataFast設定からその認証情報を削除してください。

Claude Codeの場合、サーバーを追加してから、Claude Code内で/mcpを開き、DataFastを認証します：

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. サインインしてアクセスを承認する

1. datafa.stで既存のDataFastアカウントにサインインします。
2. このクライアントがアクセスできるウェブサイトを選択します。
3. 要求された権限を確認します。読み取り権限はデフォルトで選択されています。クライアントに変更を実行させたい場合のみ書き込みを有効にします。
4. アクセスを許可を選択してクライアントに戻ります。

DataFastはその接続に対してクライアントにアクセストークンを発行します。クライアントはそれを保存し、接続が有効な間は自動的に更新します。DataFastのパスワード、ダッシュボードセッション、既存のAPIキーはクライアントと共有されません。

3. 試してみる

DataFastを有効にして会話を開始し、次のように尋ねます：

利用可能なウェブサイトを一覧表示し、過去7日間の私のウェブサイトの訪問者数と収益を表示してください。

続行する前にウェブサイトと日付範囲を確認してください。プランと権限は引き続き適用されます。

接続の管理または取り消しは、設定 → API / MCP → 接続済みアプリで行います。DataFastが再度アクセス承認を求めたとき、または別のウェブサイトや権限を共有したいときに再接続します。

APIトークンで接続する

クライアントがAPIキーまたはBearerトークンを要求する場合は、この方法を使用します。MCPでは、dft_で始まるアカウントアクセストークンから始めます。

1. アカウントトークンを作成する

1. アカウント設定 → API / MCPを開きます。
2. 新しいアクセストークンで、アクセスを制限する場合は特定のウェブサイトを選択し、ワークフローに必要な場合はすべてのウェブサイトを選択します。
3. 必要な権限のみを選択します。アナリティクス接続の場合は、ウェブサイト → 読み取りとアナリティクス → 読み取りから始め、他のすべての権限は無効にします。
4. トークンにわかりやすい名前を付け、トークンを作成を選択して、dft_値をコピーします。これは一度だけ表示されます。

2. クライアントにトークンを追加する

https://datafa.st/api/mcpを使用し、トークンをAuthorization: Bearer …ヘッダーとして送信します。クライアントの認証情報設定または環境変数に保存し、ソース管理やチャットメッセージの外に置きます。

Codex: DATAFAST_TOKEN環境変数としてトークンを利用可能にしてから、次を実行します：

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: dft_xxxをトークンに置き換えます：

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: mcp.jsonにこのエントリを追加します。Cursorの環境でDATAFAST_TOKENを利用可能にします。Cursorは接続時に環境変数を展開します。

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

その他のクライアント: リモートMCP設定にサーバーURLとBearerトークンを入力します。ローカルのstdioサーバーのみをサポートするクライアントには、mcp-remoteなどのブリッジが必要です。

3. 試してアクセスを管理する

クライアントに利用可能なウェブサイトを一覧表示させ、次に1つのウェブサイトの過去7日間の訪問者数と収益を要求します。

トークンの管理は、アカウント設定 → API / MCPのアクセストークンで行います。権限の編集で実行できることを変更し、ロールでシークレットを置き換え、削除で取り消します。トークンをロールした後は、クライアントの値を更新します。

すでにdf_ウェブサイトAPIキーをお持ちですか？一般的なMCPエンドポイントはそれらも受け入れ、アクセスはそのウェブサイトに紐付けられます。サポートされている操作については、API認証を確認してください。また、上記の特定のウェブサイトを使用して、アカウントトークンを1つのウェブサイトに制限することもできます。

アクセスがどのように制限されるか

どちらの方法でも、クライアントにシークレット認証情報が付与されます。OAuthは、同意後にその認証情報の発行と更新を自動化します。APIトークンは、自分で作成して設定する認証情報です。

DataFastはサーバー上で、認証情報、許可されたアクション、ウェブサイトアクセス、現在のメンバーシップ、該当するアカウントまたはプランの制限をチェックします。ツールリクエスト内のウェブサイトIDはチェックの対象であり、アクセスの証明ではありません。たとえば、ウェブサイトAの読み取りを承認されたOAuth接続は、ウェブサイトBを読み取ったり、ウェブサイトAを編集したりすることはできません。

OAuth接続は承認されたウェブサイトのみにアクセスします。承認されたOAuthツールを通じて作成されたウェブサイトはその接続に追加されます。他の場所で追加されたウェブサイトは自動的に共有されません。OAuthトークンは1時間で期限切れになり、発行から最大30日間自動更新され、最大90日後に新しい同意が必要になります。ダッシュボードで作成されたアカウントトークンは、ロールまたは削除するまで有効であり、アカウントのアクセス権と権限に従います。OAuthを通じて発行されたAPIキーとアカウントトークンも、元の接続が有効であることに依存します。

OAuthトークンは、発行されたMCPエンドポイントでのみ機能します。公開REST APIに貼り付けたり、DataFastダッシュボードへのサインインに使用したりすることはできません。アカウントトークンは、サポートされているREST APIエンドポイントでも機能します。

安全性

• 限定的なアクセスから始める。 クライアントには必要なウェブサイトと権限のみを付与します。アカウント操作、認証情報管理、完全な訪問者詳細には、デフォルトでオフになっている個別のOAuth権限が必要です。
• 変更を確認する。 OAuth書き込みツールには確認と再試行キーが必要です。APIトークンツールでは、データの削除や認証情報の発行などの機密操作に確認が必要です。これらのチェックはクライアントの確認UIを補完するものであり、信頼できるクライアントを選択することの代わりにはなりません。
• 認証情報を秘密に保つ。 どちらの方法もBearerトークンを使用します。有効なトークンを取得した人は、期限切れまたは取り消しまで許可されたアクセスを使用できます。認証情報をURL、ソース管理、チャットメッセージに絶対に入れないでください。
• 必要なときに切断する。 OAuth接続を取り消すと、後続のリクエストと更新がブロックされます。すでに実行中のリクエストは完了する可能性があり、他のアプリと共有されたデータは取り消しによって削除されません。
• ダッシュボード専用の操作はダッシュボードに留まる。 MCPはウェブサイトを削除したり、決済プロバイダーを接続/切断したりすることはできません。