mcpField
F
Fictura

Fictura

リモート
docs.fictura.coビジネス・マーケティング01 日前に更新
リポジトリ公式サイト

Fictura について

FicturaのMCPサーバーは、モバイルアプリの設定、分析、ペイウォール、実験、獲得データ、エラー情報をAIエージェントに提供します。ExpoおよびReact Nativeのチーム向けで、公開前に確認できるペイウォールやオンボーディングのドラフトを作成できます。

主な機能

  1. 01アプリ設定と連携状況を取得
  2. 02ファネル、コホート、ユーザーデータを確認
  3. 03ペイウォールとオンボーディングのドラフトを作成
  4. 04実験と獲得レポートを確認
  5. 05アプリのエラーとスタックトレースを調査

活用シーン

  1. 01ファネルの離脱やコホートの変化を調査
  2. 02Studioで確認用のペイウォールドラフトを作成
  3. 03リリースのクラッシュを見つけてトレースを確認
  4. 04キャンペーンと実験の実績を確認

MCP 対応

ホステッドのStreamable HTTP MCPサーバーは、Ficturaのドキュメント、アプリデータ、分析、ドラフト編集、獲得、実験、エラー関連のツールをMCPクライアントに公開します。サインインまたはMCPキーが必要で、操作範囲は許可レベルによって異なります。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.fictura.co/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://mcp.fictura.co/mcp認証が必要
パッケージ
npm@fictura/mcp0.1.2

ツール

詳細

Fictura

Fictura MCP サーバー

AI エージェントにモバイルアプリの実際のペイウォール、ファネル、実験、アトリビューション、クラッシュを提供し、公開前に確認できるペイウォールやオンボーディングの下書きを作成させましょう。

Fictura は、Expo および React Native アプリ向けのグロースプラットフォームです。Studio エディターで作成するペイウォールとオンボーディングフロー、サブスクリプション分析とファネル、A/B テスト、アトリビューションと広告費、ディープリンク、App Store と Google Play の分析、スタックトレース付きのエラー追跡を提供します。このサーバーを使えば、Claude、ChatGPT、Codex、Cursor、VS Code、Windsurf、Gemini CLI、その他あらゆる MCP クライアントから、これらすべてを利用できます。

https://mcp.fictura.co/mcp

ステートフルなセッションを必要としない Streamable HTTP と JSON レスポンスに対応しています。https://api.fictura.co/mcp からも同じサーバーを利用できます。

エージェントにできること

質問動作
「この Expo アプリに Fictura を追加して、適切な配置でオンボーディングフローを表示してください。」アプリの実際の SDK キーと API ベース URL(get_app_setup)、ドキュメント(read_doc)、既存の配置(list_surfaces)を読み取り、プレースホルダーなしでインテグレーションを記述します。
「先週、トライアルから有料への移行率が下がったのはなぜですか?ファネルのどこでユーザーが離脱するのか見せてください。」ステップごとの離脱数を含むファネルを取得し、コホートを比較します(get_analytics)。
「最新リリースで最も多いクラッシュを修正してください。」問題を見つけ、ソースマップされたスタック、パンくずリスト、修正プロンプトを読み取り(list_error_issues、get_error_issue_brief)、コードを編集します。
「テンプレートから年額プランのペイウォールを下書きして、Studio で確認できるようにしてください。」実際のテンプレートを選び(list_templates)、下書きを作成します(create_paywall_draft)。ダッシュボードで公開するかどうかは、あなたが決められます。

その他:「今月、どのキャンペーンで費用を回収できましたか?」(get_acquisition_report)、「どの実験が優勢で、どの程度確かな結果ですか?」(list_experiments)、「ユニバーサルリンクは正しく設定されていますか?」(get_link_infrastructure)。

接続

ワンクリック

Cursor に追加 VS Code にインストール

どちらのボタンも URL のみを追加します。エディターに求められたら、Fictura アカウントでサインインしてください。お使いの環境でボタンが動作しない場合は、次のリンクを直接開いてください。

cursor://anysphere.cursor-deeplink/mcp/install?name=fictura&config=eyJ1cmwiOiJodHRwczovL21jcC5maWN0dXJhLmNvL21jcCJ9
vscode:mcp/install?%7B%22name%22%3A%22fictura%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.fictura.co%2Fmcp%22%7D
Claude(claude.ai、Claude Desktop、Cowork)
  1. Customize → Connectors を開き、+ Add、次に Add custom connector を選択します。
  2. 名前に Fictura を入力し、https://mcp.fictura.co/mcp を貼り付けて Continue を選択します。
  3. 検出されたサインイン設定をそのまま使用し、Add を選択してから、Fictura に接続してサインインします。代わりに MCP キーを使用するには、No sign in を選び、Request headers に X-API-Key としてキーを追加します。

Team および Enterprise プランでは、まずオーナーが Organization settings → Connectors でコネクターを追加し、その後、各メンバーが接続します。

ChatGPT
  1. chatgpt.com/plugins にアクセスし、+、次に Add custom MCP server を選択します。
  2. https://mcp.fictura.co/mcp を入力し、認証方法として OAuth を選択します。
  3. Create as a plugin を選択し、Fictura にサインインします。

アカウントまたはワークスペースのポリシーで、カスタム MCP サーバーの利用が許可されている必要があります。

Claude Code

このリポジトリからプラグインをインストールします。サーバーと、インテグレーションコードを書く前にアプリの実際の設定を Claude に読み込ませるスキルが追加されます。

claude plugin marketplace add Apex-Byte-Technologies/fictura-mcp
claude plugin install fictura@fictura

サーバーのみを追加する場合:

claude mcp add --transport http fictura https://mcp.fictura.co/mcp

次に /mcp を実行し、fictura を選択してサインインします。代わりに MCP キーを使用するには:

claude mcp add --transport http fictura https://mcp.fictura.co/mcp \
  --header "X-API-Key: $FICTURA_MCP_KEY"
Codex (CLI, IDE extension, ChatGPT desktop app)
codex mcp add fictura --url https://mcp.fictura.co/mcp
codex mcp login fictura

サインインの代わりに MCP キーを使う場合は、キーを環境変数に保存します。

export FICTURA_MCP_KEY=fk_mcp_...
codex mcp add fictura --url https://mcp.fictura.co/mcp --bearer-token-env-var FICTURA_MCP_KEY

同じ設定を ~/.codex/config.toml に記述する場合:

[mcp_servers.fictura]
url = "https://mcp.fictura.co/mcp"
bearer_token_env_var = "FICTURA_MCP_KEY"
Cursor

上のボタンを使うか、.cursor/mcp.json(プロジェクト)または ~/.cursor/mcp.json(グローバル)に以下を追加します。

{
  "mcpServers": {
    "fictura": {
      "url": "https://mcp.fictura.co/mcp"
    }
  }
}

MCP キーを使う場合は、fictura エントリーに "headers": { "X-API-Key": "${env:FICTURA_MCP_KEY}" } を追加します。

VS Code

上のボタンを使って Fictura にサインインします。代わりに MCP キーを使うには、.vscode/mcp.json に以下を追加します。VS Code はキーを一度だけ尋ね、安全に保存します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fictura-mcp-key",
      "description": "Fictura MCP key (fk_mcp_...)",
      "password": true
    }
  ],
  "servers": {
    "fictura": {
      "type": "http",
      "url": "https://mcp.fictura.co/mcp",
      "headers": { "X-API-Key": "${input:fictura-mcp-key}" }
    }
  }
}
Windsurf

Cascade パネルの ... メニューを開き、Open MCP config file を選択して、以下を追加します。

{
  "mcpServers": {
    "fictura": {
      "serverUrl": "https://mcp.fictura.co/mcp",
      "headers": { "X-API-Key": "${env:FICTURA_MCP_KEY}" }
    }
  }
}
Gemini CLI
gemini extensions install https://github.com/Apex-Byte-Technologies/fictura-mcp

インストーラーでは MCP キーを任意で入力でき、キーはシステムのキーチェーンに保存されます。後から変更するには gemini extensions config fictura を実行します。

Claude Desktop with a local bridge (npx)

ローカル(stdio)サーバーのみを実行できるクライアントでは、@fictura/mcp パッケージがホスト型サーバーへのブリッジとして機能します。Claude Desktop で Settings → Developer → Edit Config を開き、以下を追加します。

{
  "mcpServers": {
    "fictura": {
      "command": "npx",
      "args": ["-y", "@fictura/mcp"],
      "env": { "FICTURA_MCP_KEY": "fk_mcp_..." }
    }
  }
}

ブリッジは FICTURA_MCP_KEY と、任意で FICTURA_API_BASE(デフォルトは https://api.fictura.co)を読み込みます。Claude Desktop は上記のカスタムコネクターにも対応しており、ローカルへのインストールは不要です。

認証

オプション方法最適な用途
Fictura にサインイン(OAuth 2.1)URL のみを追加します。クライアントが Fictura のサインイン画面を開きます。同意画面で1 つのアプリとアクセスレベル(読み取り、または読み取りと下書きの編集)を選択します。Claude、ChatGPT、Claude Code、Codex、Cursor、VS Code
MCP キーFictura ダッシュボードの Setup → Coding agents (MCP) で作成します。Authorization: Bearer fk_mcp_... または X-API-Key: fk_mcp_... として送信します。CI、スクリプト、MCP のサインインに対応していないクライアント
なしサインインせずに接続します。アカウントを作成する前に Fictura のドキュメントを読む場合

サインインせず、キーも使わない場合に利用できるのは、ドキュメント関連の 3 つのツール search_docs、list_docs、read_doc のみです。それ以外のツールは、接続方法を案内します。

キーは、作成時に Can edit draft paywalls を選択しない限り読み取り専用です(この設定で作成したキーは fk_mcpw_ で始まります)。AppsFlyer のインポートには、Can connect and import data を有効にして作成したキーが必要です。MCP 経由でアプリのデータにアクセスするには、AI アクセスが利用可能な Fictura の有効なサブスクリプションが必要です。

ツール

44 個のツールと 1 個のプロンプトがあります。「読み取り」ツールは何も変更しません。

領域ツール機能アクセス
ドキュメントsearch_docsFictura のドキュメントを検索しますサインイン不要
ドキュメントlist_docsFictura のドキュメントページを一覧表示しますサインイン不要
ドキュメントread_docFictura のドキュメントページを読み取りますサインイン不要
セットアップget_app_setupこのアプリの Fictura 認証情報とエンドポイントを取得します読み取り
セットアップget_setup_status統合と機能のステータスを取得します読み取り
セットアップlist_store_productsApp Store のサブスクリプション商品を一覧表示します読み取り
セットアップget_link_infrastructureディープリンクとトラッキングドメインの設定を取得します読み取り
セットアップget_push_configプッシュ通知の設定を取得します読み取り
分析get_analyticsファネル、概要、またはコホート分析を取得します読み取り
分析get_tracking_planイベントのトラッキング計画を取得します読み取り
ユーザーlist_usersユーザーを一覧表示します読み取り
ユーザーget_user1 人のユーザーの全履歴を取得します読み取り
ユーザーcheck_entitlementユーザーがサブスクリプションに登録しているか確認します読み取り
ペイウォールとオンボーディングlist_surfacesペイウォール、オンボーディングフロー、配置を一覧表示します読み取り
ペイウォールとオンボーディングget_surface1 つのペイウォールまたはオンボーディングフローの設定を取得します読み取り
ペイウォールとオンボーディングlist_templates組み込みのペイウォールとオンボーディングのテンプレートを一覧表示します読み取り
ペイウォールとオンボーディングget_paywall_docStudio ペイウォールのドキュメントを取得します読み取り
ペイウォールとオンボーディングvalidate_paywall_doc保存せずにペイウォールドキュメントを検証します読み取り
ペイウォールとオンボーディングsave_paywall_docDRAFT ペイウォールのドキュメントを保存します下書きの編集
ペイウォールとオンボーディングcreate_paywall_draft新しい DRAFT Studio ペイウォールを作成します下書きの編集
ペイウォールとオンボーディングget_onboarding_docオンボーディングフローのドキュメントを取得します読み取り
ペイウォールとオンボーディングvalidate_onboarding_doc保存せずにオンボーディングドキュメントを検証します読み取り
ペイウォールとオンボーディングsave_onboarding_docDRAFT オンボーディングフローのドキュメントを保存します下書きの編集
ペイウォールとオンボーディングcreate_onboarding_draft新しい DRAFT オンボーディングフローを作成します下書きの編集
Studio エディターpair_editor開いている Studio エディターとペアリングします読み取り
Studio エディターeditor_get_docペアリングしたエディターで開いているドキュメントを読み取ります読み取り
Studio エディターeditor_set_docペアリングしたエディターのキャンバスにドキュメントを配置します(未保存)下書きの編集
Studio エディターunpair_editorエディターとのペアリングを解除します読み取り
実験list_experiments実験を一覧表示します読み取り
実験get_experiment1 つの実験を取得します読み取り
獲得get_attribution_reportアトリビューション、インストール、KPI のレポートを取得します読み取り
獲得get_acquisition_report有料ユーザー獲得のパフォーマンスを取得します読み取り
獲得list_campaigns実施中の広告キャンペーンを一覧表示します読み取り
獲得list_creatorsクリエイターとそのパフォーマンスを一覧表示します読み取り
ストアget_store_analyticsApp Store と Google Play の分析を取得します(Appfigures)読み取り
エラーlist_error_issuesエラーの課題を一覧表示します読み取り
エラーsearch_error_issuesエラーの課題を検索します読み取り
エラーget_error_issueスタックトレース付きで 1 つのエラーの課題を取得します読み取り
エラーget_error_issue_brief課題の概要と修正用プロンプトを取得します読み取り
エラーupdate_error_issueエラーの課題を変更しますアプリが許可する場合は書き込み
エラーget_trace1 つの分散トレースを取得します読み取り
AppsFlyer インポートget_appsflyer_import_statusAppsFlyer インポートのステータスを取得します読み取り
AppsFlyer インポートstart_appsflyer_importAppsFlyer のインポートを開始します書き込み、インポートキー
AppsFlyer インポートget_appsflyer_attribution_summaryインポートした AppsFlyer アトリビューションを要約します読み取り

プロンプト:integrate_fictura_sdk(Fictura SDK を統合する)は、アプリの実際の認証情報を使用して Expo / React Native アプリに @fictura/sdk を組み込む手順をエージェントに案内します。

セキュリティ

  • アプリはサインインまたはキーによって決まり、エージェントによって決まることはありません。 どのツールもアプリ ID を受け取らないため、エージェントが別のアプリのデータを読み取る引数を渡すことはできません。サインインでアクセスできるのは、同意画面で選択した 1 つのアプリだけです。
  • 下書きが公開されることはありません。 ペイウォールとオンボーディングのツールが作成・編集するのは下書きだけです。公開中のペイウォールやフローの保存は拒否され、公開操作は Fictura ダッシュボードでクリックして行います。保存するたびに新しいバージョンが作成され、ロールバックできます。履歴には mcp: <note> と記録されます。
  • エディターの操作権は常にユーザーにあります。 editor_set_doc は、ワンタイムコードでペアリングした Studio エディターのキャンバスを変更します。保存は行われないため、変更を確認して元に戻すことも、自分で保存することもできます。
  • その他の書き込みはオプトイン方式です。 update_error_issue は、アプリの Issues 設定で Let MCP keys change issues を有効にした後にのみ機能します。start_appsflyer_import には、Can connect and import data を有効にして作成したキーが必要です。
  • 取り消しは即時に反映されます。 取り消されたキーまたは無効なキーは、次のリクエストでエラーとなり拒否されます。ひそかに権限が引き下げられることはありません。
  • キーをコードに含めないでください。 MCP キー(fk_mcp_...)は収益データとユーザーデータを読み取れるため、環境変数またはクライアントのシークレットストレージに保管し、リポジトリには絶対に含めないでください。get_app_setup が返す SDK キー(gk_...)は別のもので、公開可能なため、アプリに含めても安全です。

脆弱性は SECURITY.md の説明に従って報告してください。

このリポジトリについて

このリポジトリには、ホスト型サーバーの公開リスティングファイルが含まれています。サーバー自体は Fictura で稼働しており、ここにはサーバーコードはありません。

パス内容
server.jsonco.fictura/mcp としての公式 MCP Registryへの登録
.claude-plugin/marketplace.json、plugins/fictura/Claude Code のプラグインマーケットプレイスとプラグイン
.cursor-plugin/plugin.json、mcp.jsonCursor プラグイン
gemini-extension.jsonGemini CLI 拡張機能
openai/ChatGPT と Codex のプラグインバンドル。アップロード用 ZIP は scripts/build-openai-zip.sh でビルドします
assets/アイコン(SVG、および 48、128、256、400、512 px の PNG)

リンク

ライセンス

MIT © Apex Byte Technologies

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。