MCP 服务器

Aptoide Connect MCP 服务器将您的 AI 助手（Claude、Gemini、ChatGPT 或任何其他 MCP 客户端）直接连接到您的 Aptoide Connect 账户，让您可以用自然语言询问自己的数据，而无需编写 API 调用或在控制台报告中逐页点击：

“我的应用上个月的收入是多少？”
“我的安装量最高的国家是哪个？”
“这笔钱包交易为什么失败了？”

适用对象

任何希望以对话方式查看应用统计、钱包活动、应用内商品目录或 Aptoide Connect 文档的 Aptoide Connect 开发者。典型用例：

“[应用] 过去 30 天的收入是多少？”
“哪些国家为 [应用] 带来的安装量最多？”
“我这个月所有应用的钱包总额是多少？”
“交易 [id] 发生了什么？”
“[应用] 有哪些应用内商品，价格分别是多少？”
“为 [应用] 创建一个新的消耗型商品，我会提供 sku、价格和商店信息。”
“把 [sku] 的价格提高到 EUR 1.99。”
“我的应用内购买无法完成。这是我的 Billing SDK 日志，问题出在哪里？”
“这个端点为什么返回 402？”

前提条件

一个拥有有效订阅的 Aptoide Connect 开发者账户。
一个在开发者控制台的 API 密钥页面生成的 API 密钥。这是唯一涉及的凭据，无需单独注册 MCP。
一个支持带 OAuth 的远程服务器的 MCP 客户端，例如 Claude、Gemini 或 ChatGPT。

连接您的 AI 助手

身份验证仅支持 OAuth。每个 MCP 客户端添加远程服务器的方式各不相同，请查阅客户端文档，了解在何处配置自定义 MCP 服务器或连接器。无论使用哪种客户端，流程都是相同的：

在 MCP 客户端中通过 URL 添加服务器：https://mcp.connect.aptoide.com。

⚠️
请使用不带 /mcp 子路径的原始 URL，https://mcp.connect.aptoide.com/mcp 会返回 404。
客户端会打开浏览器，进入由 Aptoide Connect 托管的授权页面。

将您的 Aptoide Connect API 密钥粘贴到该页面，然后点击授权。
密钥被接受后，客户端会将连接显示为已激活。

🌏

在中国使用 MCP 服务器

如果您从中国大陆连接，可能难以访问 MCP 服务器或完成 OAuth 流程。在这种情况下，请尝试在连接 VPN 的状态下进行连接。

下方的选项卡涵盖了最常见的客户端。任何其他支持带 OAuth 的远程服务器的 MCP 客户端都可以用同样的方式连接，只需在该客户端保存 MCP 服务器设置的位置进行配置。

Claude

在 claude.ai 上打开设置 → 连接器，然后选择添加自定义连接器。
输入 https://mcp.connect.aptoide.com 作为 URL，OAuth 客户端 ID 和密钥留空。
点击连接并完成授权页面。

请参阅 Anthropic 的使用远程 MCP 的自定义连接器指南。

Claude Code

添加服务器：

claude mcp add --transport http aptoide-connect https://mcp.connect.aptoide.com

在会话中运行 /mcp，选择 aptoide-connect，然后选择 Authenticate。

请参阅 Claude Code MCP 文档。

ChatGPT

在设置 → 连接器 → 高级设置中，启用开发者模式（自定义 MCP 连接器必需，付费套餐可用）。
添加一个新连接器，MCP 服务器 URL 为 https://mcp.connect.aptoide.com，身份验证方式为 OAuth。
授权页面打开后完成授权。

请参阅 OpenAI 的 ChatGPT 中的连接器指南。

Codex

较新版本的 Codex 支持带 OAuth 的远程 MCP 服务器：

在 ~/.codex/config.toml 的 mcp_servers 部分添加服务器，URL 为 https://mcp.connect.aptoide.com。
在 CLI 中完成 OAuth 登录。

有关您所用版本的准确配置，请参阅 Codex 文档。

Gemini

Gemini 网页应用目前不支持自定义 MCP 连接器，请使用 Gemini CLI。

Gemini CLI

将服务器添加到 ~/.gemini/settings.json（或项目级的 .gemini/settings.json）：

{
    "mcpServers": {
        "aptoide-connect": {
            "httpUrl": "https://mcp.connect.aptoide.com"
        }
    }
}

在 Gemini CLI 会话中运行 /mcp auth aptoide-connect，并完成打开的授权页面。随时运行 /mcp 可查看所有已配置服务器的连接状态。

请参阅 Gemini CLI MCP 文档。

Qwen

Qwen 网页应用目前不支持自定义 MCP 连接器，请使用 Qwen Code。

Qwen Code

Qwen Code 的配置方式与 Gemini CLI 相同：

将服务器添加到 ~/.qwen/settings.json：

{
    "mcpServers": {
        "aptoide-connect": {
            "httpUrl": "https://mcp.connect.aptoide.com"
        }
    }
}

在会话中进行身份验证并完成授权页面。

Kimi

Kimi 网页应用目前不支持自定义 MCP 连接器，请使用 Kimi Code。

Kimi Code

使用 OAuth 身份验证添加服务器：

kimi mcp add --transport http --auth oauth aptoide-connect https://mcp.connect.aptoide.com

进行身份验证，浏览器会打开授权页面：

kimi mcp auth aptoide-connect

在会话中，/mcp 会显示已连接的服务器及其工具。请参阅 Kimi Code CLI MCP 文档。

DeepSeek

DeepSeek 网页应用目前不支持自定义 MCP 连接器，请使用 DeepSeek Harness。

DeepSeek Harness

DeepSeek Harness（dsh）是 DeepSeek 的开源智能体运行时，通过其 @deepseek-ai/dsh-mcp-client 插件连接远程 MCP 服务器。但该客户端只传递静态请求头，没有自己的 OAuth 流程，而本服务器要求使用 OAuth。在 Harness 支持 OAuth 之前，DeepSeek 的第一方工具无法连接到本服务器。若要将 DeepSeek 模型与本服务器配合使用，请使用支持 OAuth 且允许您选择模型的 MCP 客户端。

可用工具

每个工具对应一个 Aptoide Connect API 端点，并原样返回该端点的响应。

工具	功能	访问权限
`search_documentation`	回答产品问题：某个参数接受什么值、某个限制是多少、某个错误代码是什么含义。	只读
`list_available_applications`	列出账户中的应用、其准确的包名，以及每个应用支持的统计数据。	只读
`get_application_statistics_chart`	单个应用在某个日期范围内的收入、安装量或下载量。	只读
`get_application_statistics_top`	按国家或按合作伙伴对单个应用的收入、安装量或下载量进行排名。	只读
`list_application_statistics_reports`	单个应用的月度性能报告 CSV：下载链接或报告内容本身，适用于单次统计调用无法覆盖的时间段。	只读
`get_wallet_transactions_totals`	某个日期范围内所有应用的钱包金额汇总（收入、贷方、借方）。	只读
`list_wallet_transactions`	各笔钱包交易，包含金额、费用、状态、支付方式和国家。	只读
`get_wallet_transaction_details`	某一笔钱包交易的完整详情。	只读
`list_wallet_transaction_reports`	月度钱包交易报告 CSV：原始数据的下载链接或其内容。	只读
`list_application_consumables`	列出应用的应用内商品，包含 id、sku、状态和价格。	只读
`get_application_consumable`	单个应用内商品的完整详情，包括为其设置的每个价格和语言区域。	只读
`add_application_consumable`	创建新的应用内商品。	写入 — 创建线上商品，且商品无法删除：误创建的商品只能设为 `INACTIVE`，无法移除。
`update_application_consumable`	编辑应用内商品，只有您提供的字段会被更改。不存在的 id 会直接失败，而不会创建任何内容。	写入 — 更改可能正在销售中的线上商品，因此不慎修改价格或语言区域会立即对买家可见。
`analyze_billing_sdk_transaction`	查询一笔 Billing SDK 交易及其关联的购买，解释其状态含义以及下一步该做什么。	只读
`analyze_billing_sdk_logs`	将 Billing SDK 日志输出交给日志分析器处理，以识别其中的流程和错误。请原样粘贴日志，分析器会对原始行进行匹配。	只读

⚠️

标记为写入的工具会对您的线上 Aptoide Connect 数据做出真实更改，其中部分更改无法撤销。请在确认之前审查您的助手即将执行的操作。

隐私

MCP 服务器是 Aptoide Connect API 之上的一个轻量、无状态的层。这对您的数据意味着：

您的 API 密钥永不存储。 它被加密到您的 AI 客户端持有的 OAuth 令牌中，仅在内存中解密以处理每个请求，绝不会写入数据库、记录到日志或暴露给助手。
您的对话永不被查看。 服务器只接收您的助手明确发起的工具调用，绝不会接收其周围的聊天内容。您有意传递给工具的内容（例如 Billing SDK 日志）会被处理以响应该调用。
API 请求与其他 API 流量一样会被记录。 每次工具调用都会成为一次 Aptoide Connect API 请求，其元数据（端点、参数、响应状态、账户）会为配额和服务指标保留 30 天，与直接 API 调用的处理方式相同。
结果到达您的助手之后如何处理，由您的 AI 提供商的隐私政策决定，与您和助手对话中的其他任何内容相同。

有关 Aptoide Connect 处理您数据的总体方式，请参阅隐私政策和条款与条件。

常见问题

AI 助手会看到我的 API 密钥吗？ 不会。密钥只在授权页面通过 HTTPS 输入一次，绝不会出现在聊天中。它被封装在只有 MCP 服务器才能解开的加密令牌中，因此助手和 AI 提供商都不会以可用形式持有它。

如何断开连接或撤销访问权限？ 停用您使用的 API 密钥：在开发者控制台的 API 密钥页面上关闭其启用开关。使用该密钥建立的所有连接会立即停止工作，如需恢复，您可以稍后重新启用该密钥。在客户端一侧移除连接器也可以，但停用密钥才是可靠的保证。

连接后助手能看到什么？ 仅限本页所列工具针对 API 密钥所属账户公开的内容：该账户的应用、其统计数据和报告、钱包活动、应用内商品目录、Billing SDK 交易查询，以及本文档。账户中的其他内容均无法访问：没有针对设置、用户、提交或上述未列出的任何内容的工具，也无法访问任何其他账户。

它能更改我账户中的内容吗？ 可以。它可以创建和编辑应用内商品，这是仅有的写入操作。其他所有操作均为只读，且没有任何删除方式。MCP 客户端会在运行写入工具之前请求您的批准，因此不会有任何静默更改。

为什么收入数字与我的钱包余额不一致？ 收入工具默认使用 amountType: wallet，即扣除增值税和收入分成后您实际到手的金额。amountType: global 是包含增值税的消费者总支出，两者之间的差额随每位买家所在国家而变化。当数字看起来不对时，请先确认引用的是哪一个。

我可以查询多久以前的数据？ 统计数据覆盖最近 6 个月，每次提问最多 120 天。对于更长的时间段，助手会切换到没有时间窗口限制的月度报告。钱包交易可追溯约 24 个月。

为什么我会收到“Active account subscription required”？ API（因此也包括 MCP 服务器）要求您的账户拥有有效的订阅。402 表示订阅缺失或已过期。

有使用限制吗？ 有。每个端点都有按账户计算的每日配额。达到配额时会返回 429，明确告知助手这一情况，配额在 UTC 午夜重置。

需要助手无法回答的帮助？请参阅支持工具，了解 Connectoide、Billing SDK 分析器以及如何直接联系我们的支持团队。

适用对象​

前提条件​

连接您的 AI 助手​

Claude​

Claude Code​

ChatGPT​

Codex​

Gemini​

Gemini CLI​

Qwen​

Qwen Code​

Kimi​

Kimi Code​

DeepSeek​

DeepSeek Harness​

可用工具​

隐私​

常见问题​