Fictura について
FicturaのMCPサーバーは、モバイルアプリの設定、分析、ペイウォール、実験、獲得データ、エラー情報をAIエージェントに提供します。ExpoおよびReact Nativeのチーム向けで、公開前に確認できるペイウォールやオンボーディングのドラフトを作成できます。
主な機能
- 01アプリ設定と連携状況を取得
- 02ファネル、コホート、ユーザーデータを確認
- 03ペイウォールとオンボーディングのドラフトを作成
- 04実験と獲得レポートを確認
- 05アプリのエラーとスタックトレースを調査
活用シーン
- 01ファネルの離脱やコホートの変化を調査
- 02Studioで確認用のペイウォールドラフトを作成
- 03リリースのクラッシュを見つけてトレースを確認
- 04キャンペーンと実験の実績を確認
MCP 対応
ホステッドのStreamable HTTP MCPサーバーは、Ficturaのドキュメント、アプリデータ、分析、ドラフト編集、獲得、実験、エラー関連のツールをMCPクライアントに公開します。サインインまたはMCPキーが必要で、操作範囲は許可レベルによって異なります。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.fictura.co/mcpclaude mcp add --transport http co-fictura https://mcp.fictura.co/mcp{"mcpServers":{"co-fictura":{"type":"http","url":"https://mcp.fictura.co/mcp"}}}Cursor で開く{"servers":{"co-fictura":{"type":"http","url":"https://mcp.fictura.co/mcp"}}}VS Code で開く{"mcpServers":{"co-fictura":{"type":"http","url":"https://mcp.fictura.co/mcp"}}}{"mcpServers":{"co-fictura":{"serverUrl":"https://mcp.fictura.co/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://mcp.fictura.co/mcp認証が必要ツール
詳細
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)。
接続
ワンクリック
どちらのボタンも 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)
- Customize → Connectors を開き、+ Add、次に Add custom connector を選択します。
- 名前に
Ficturaを入力し、https://mcp.fictura.co/mcpを貼り付けて Continue を選択します。 - 検出されたサインイン設定をそのまま使用し、Add を選択してから、Fictura に接続してサインインします。代わりに MCP キーを使用するには、No sign in を選び、Request headers に
X-API-Keyとしてキーを追加します。
Team および Enterprise プランでは、まずオーナーが Organization settings → Connectors でコネクターを追加し、その後、各メンバーが接続します。
ChatGPT
- chatgpt.com/plugins にアクセスし、+、次に Add custom MCP server を選択します。
https://mcp.fictura.co/mcpを入力し、認証方法として OAuth を選択します。- 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_docs | Fictura のドキュメントを検索します | サインイン不要 |
| ドキュメント | list_docs | Fictura のドキュメントページを一覧表示します | サインイン不要 |
| ドキュメント | read_doc | Fictura のドキュメントページを読み取ります | サインイン不要 |
| セットアップ | get_app_setup | このアプリの Fictura 認証情報とエンドポイントを取得します | 読み取り |
| セットアップ | get_setup_status | 統合と機能のステータスを取得します | 読み取り |
| セットアップ | list_store_products | App Store のサブスクリプション商品を一覧表示します | 読み取り |
| セットアップ | get_link_infrastructure | ディープリンクとトラッキングドメインの設定を取得します | 読み取り |
| セットアップ | get_push_config | プッシュ通知の設定を取得します | 読み取り |
| 分析 | get_analytics | ファネル、概要、またはコホート分析を取得します | 読み取り |
| 分析 | get_tracking_plan | イベントのトラッキング計画を取得します | 読み取り |
| ユーザー | list_users | ユーザーを一覧表示します | 読み取り |
| ユーザー | get_user | 1 人のユーザーの全履歴を取得します | 読み取り |
| ユーザー | check_entitlement | ユーザーがサブスクリプションに登録しているか確認します | 読み取り |
| ペイウォールとオンボーディング | list_surfaces | ペイウォール、オンボーディングフロー、配置を一覧表示します | 読み取り |
| ペイウォールとオンボーディング | get_surface | 1 つのペイウォールまたはオンボーディングフローの設定を取得します | 読み取り |
| ペイウォールとオンボーディング | list_templates | 組み込みのペイウォールとオンボーディングのテンプレートを一覧表示します | 読み取り |
| ペイウォールとオンボーディング | get_paywall_doc | Studio ペイウォールのドキュメントを取得します | 読み取り |
| ペイウォールとオンボーディング | validate_paywall_doc | 保存せずにペイウォールドキュメントを検証します | 読み取り |
| ペイウォールとオンボーディング | save_paywall_doc | DRAFT ペイウォールのドキュメントを保存します | 下書きの編集 |
| ペイウォールとオンボーディング | create_paywall_draft | 新しい DRAFT Studio ペイウォールを作成します | 下書きの編集 |
| ペイウォールとオンボーディング | get_onboarding_doc | オンボーディングフローのドキュメントを取得します | 読み取り |
| ペイウォールとオンボーディング | validate_onboarding_doc | 保存せずにオンボーディングドキュメントを検証します | 読み取り |
| ペイウォールとオンボーディング | save_onboarding_doc | DRAFT オンボーディングフローのドキュメントを保存します | 下書きの編集 |
| ペイウォールとオンボーディング | create_onboarding_draft | 新しい DRAFT オンボーディングフローを作成します | 下書きの編集 |
| Studio エディター | pair_editor | 開いている Studio エディターとペアリングします | 読み取り |
| Studio エディター | editor_get_doc | ペアリングしたエディターで開いているドキュメントを読み取ります | 読み取り |
| Studio エディター | editor_set_doc | ペアリングしたエディターのキャンバスにドキュメントを配置します(未保存) | 下書きの編集 |
| Studio エディター | unpair_editor | エディターとのペアリングを解除します | 読み取り |
| 実験 | list_experiments | 実験を一覧表示します | 読み取り |
| 実験 | get_experiment | 1 つの実験を取得します | 読み取り |
| 獲得 | get_attribution_report | アトリビューション、インストール、KPI のレポートを取得します | 読み取り |
| 獲得 | get_acquisition_report | 有料ユーザー獲得のパフォーマンスを取得します | 読み取り |
| 獲得 | list_campaigns | 実施中の広告キャンペーンを一覧表示します | 読み取り |
| 獲得 | list_creators | クリエイターとそのパフォーマンスを一覧表示します | 読み取り |
| ストア | get_store_analytics | App Store と Google Play の分析を取得します(Appfigures) | 読み取り |
| エラー | list_error_issues | エラーの課題を一覧表示します | 読み取り |
| エラー | search_error_issues | エラーの課題を検索します | 読み取り |
| エラー | get_error_issue | スタックトレース付きで 1 つのエラーの課題を取得します | 読み取り |
| エラー | get_error_issue_brief | 課題の概要と修正用プロンプトを取得します | 読み取り |
| エラー | update_error_issue | エラーの課題を変更します | アプリが許可する場合は書き込み |
| エラー | get_trace | 1 つの分散トレースを取得します | 読み取り |
| AppsFlyer インポート | get_appsflyer_import_status | AppsFlyer インポートのステータスを取得します | 読み取り |
| AppsFlyer インポート | start_appsflyer_import | AppsFlyer のインポートを開始します | 書き込み、インポートキー |
| 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.json | co.fictura/mcp としての公式 MCP Registryへの登録 |
.claude-plugin/marketplace.json、plugins/fictura/ | Claude Code のプラグインマーケットプレイスとプラグイン |
.cursor-plugin/plugin.json、mcp.json | Cursor プラグイン |
gemini-extension.json | Gemini CLI 拡張機能 |
openai/ | ChatGPT と Codex のプラグインバンドル。アップロード用 ZIP は scripts/build-openai-zip.sh でビルドします |
assets/ | アイコン(SVG、および 48、128、256、400、512 px の PNG) |
リンク
- ドキュメント:https://docs.fictura.co/connections/outgoing/mcp-server
- ウェブサイト:https://fictura.co
- プライバシーポリシー:https://fictura.co/privacy
- 利用規約:https://fictura.co/terms
- サポート:https://fictura.co/contact または [email protected]
ライセンス
MIT © Apex Byte Technologies
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。