支付墙管理服务

自适应mcp

MCP服务器 适应 --直接从Claude Code、Codex或任何兼容MCP的客户端管理付费墙、用户配置文件、订阅、访问级别和分析。

特性

支付墙管理

配置文件管理

访问和交易

分析（导出API）

先决条件

• Python 3.11+
• 紫外线 （推荐）或pip
• 适应 秘密API密钥 （从 自适应仪表板 ->应用程序设置->常规->API密钥）

安装

克劳德代码

添加到您的 ~/.claude.json （全球）或项目 .claude/settings.json:

{
  "mcpServers": {
    "adapty": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/adapty-mcp",
        "run",
        "adapty-mcp"
      ],
      "env": {
        "ADAPTY_SECRET_KEY": "secret_live_YOUR_KEY_HERE"
      }
    }
  }
}

Codex CLI

添加到您的 ~/.codex/config.toml:

[mcp_servers.adapty]
args = ["--directory", "/path/to/adapty-mcp", "run", "adapty-mcp"]
command = "uv"
enabled = true

[mcp_servers.adapty.env]
ADAPTY_SECRET_KEY = "secret_live_YOUR_KEY_HERE"

来源

git clone https://github.com/ByAxe/adapty-mcp.git
cd adapty-mcp
uv sync

用法示例

配置后，这些工具在Claude Code中可用：

列出付费墙：

“显示Adapty中的所有付费墙”

检查用户的订阅：

“查找用户ID abc123的Adapty配置文件”

授予测试访问权限：

“授予用户高级访问权限test@example.com30天”

更新付费墙内容：

“将主付费墙上的标题更改为‘解锁高级版’”

本季度收入：

“显示2026年第一季度的收入分析”

位置映射：

“哪些付费墙分配给了哪些位置？”

测试

针对真实的Adapty API运行测试套件：

ADAPTY_SECRET_KEY="secret_live_YOUR_KEY" uv run pytest tests/ -v

测试涵盖了所有17种工具，包括：

• 对配置文件进行CRUD操作（创建→ read → 更新→ 授予→ 撤销→ 删除）
• 付费墙列表和远程配置往返
• 交易记录
• 所有7个分析端点
• 错误处理（404、验证、输入格式错误）

API覆盖范围

此服务器包装了 服务器端API v2 (api.adapty.io)以及 分析导出API (api-admin.adapty.io):

• 付费墙：list，获取详细信息，更新远程配置
• 档案：创建、读取、更新、删除
• 访问级别：授予、撤销
• 交易：记录订阅和一次性购买
• 分析：收入、群体、转化率、渠道、LTV、留存率
• 安置：读取位置→ 付费墙→ 受众映射

未涵盖（需要Adapty仪表板）

• 创建新的付费墙
• 在付费墙中添加/删除产品
• 管理实习和A/B测试
• 受众和细分管理

配置

许可证

麻省理工学院