Fictura

Fictura MCP 服务

将移动应用的真实付费墙、转化漏斗、实验、归因数据和崩溃信息提供给 AI Agent，让它创建付费墙和引导流程草案，供你审核后再发布。

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 提供相同的服务。

Agent 可以做什么

请求	执行内容
“将 Fictura 添加到这个 Expo 应用，并在合适的位置显示引导流程。”	读取应用的真实 SDK 密钥和 API 基址（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）

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 方案中，Owner 需先在 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 扩展、ChatGPT 桌面应用）

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 更改密钥。

使用本地桥接程序（npx）的 Claude Desktop

对于只能运行本地（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 登录页面；在授权页面中，你可以选择一个应用和访问级别（读取，或读取和编辑草稿）。	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 文档

未登录或未提供密钥时，只能使用三个文档工具：search_docs、list_docs 和 read_doc。其他所有工具都会说明如何连接。

除非创建密钥时勾选 Can edit draft paywalls，否则密钥为只读（此类密钥以 fk_mcpw_ 开头）。AppsFlyer 导入需要使用勾选了 Can connect and import data 的密钥。通过 MCP 访问应用数据需要有效的 Fictura 订阅，并启用 AI 访问权限。

工具

44 个工具和一个提示词。“读取”工具不会进行任何更改。

领域	工具	功能	访问权限
文档	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	获取一位用户的完整历史记录	读取
用户	check_entitlement	检查用户是否已订阅	读取
付费墙与引导流程	list_surfaces	列出付费墙、引导流程和展示位置	读取
付费墙与引导流程	get_surface	获取一个付费墙或引导流程的配置	读取
付费墙与引导流程	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	获取一个实验	读取
获客	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	获取一个错误问题及其堆栈跟踪	读取
错误	get_error_issue_brief	获取问题摘要和修复提示词	读取
错误	update_error_issue	更改错误问题	写入，前提是应用允许
错误	get_trace	获取一条分布式跟踪	读取
AppsFlyer 导入	get_appsflyer_import_status	获取 AppsFlyer 导入状态	读取
AppsFlyer 导入	start_appsflyer_import	开始导入 AppsFlyer 数据	写入，需要导入密钥
AppsFlyer 导入	get_appsflyer_attribution_summary	汇总已导入的 AppsFlyer 归因数据	读取

提示词：integrate_fictura_sdk（集成 Fictura SDK）会引导 Agent 使用应用的真实凭据，将 @fictura/sdk 接入 Expo / React Native 应用。

安全

• 应用来自你的登录或密钥，而非 Agent。 没有工具会接收应用 ID，因此 Agent 无法通过传入参数读取其他应用的数据。登录后只能访问你在授权屏幕上选择的那个应用。
• 草稿不会上线。 付费墙和引导流程工具只能创建和编辑草稿。保存已上线的付费墙或流程会被拒绝；上线操作必须在 Fictura 控制面板中点击完成。每次保存都会创建一个新版本，你可以回滚；历史记录会标记为 mcp: <note>。
• 编辑器由你掌控。 editor_set_doc 会更改你通过一次性代码配对的 Studio 编辑器画布。它不会保存；你可以看到更改、撤销更改，并自行保存。
• 其他写入操作需要主动启用。 update_error_issue 只有在你于应用的 Issues 设置中启用 允许 MCP 密钥更改问题 后才能使用。start_appsflyer_import 需要使用通过 可以连接并导入数据 创建的密钥。
• 撤销立即生效。 被撤销或无效的密钥会在下一次请求时被拒绝并返回错误，绝不会静默降级。
• 不要将密钥放入代码。 MCP 密钥（fk_mcp_...）可以读取收入和用户数据：请将其存储在环境变量或客户端的密钥存储中，切勿放入代码库。get_app_setup 返回的 SDK 密钥（gk_...）则不同：它可公开发布，放在应用中是安全的。

如需报告漏洞，请参阅 SECURITY.md。

此代码库

此代码库包含托管服务的公开列表文件。服务本身运行在 Fictura；此处不包含服务端代码。

路径	内容
server.json	在官方 MCP 注册表中的条目，标识为 co.fictura/mcp
.claude-plugin/marketplace.json、plugins/fictura/	Claude Code 插件市场和插件
.cursor-plugin/plugin.json、mcp.json	Cursor 插件
gemini-extension.json	Gemini CLI 扩展
openai/	ChatGPT 和 Codex 插件包；使用 scripts/build-openai-zip.sh 构建上传 ZIP
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