mcp-acedatacloud

AceDataCloudMCP

一个 Model Context Protocol (MCP) 服务，可通过 平台管理 API 管理您的 AceDataCloud 账户。

您可以查看余额、查询用量和支出、管理 API 密钥、列出服务、创建并支付充值订单、管理平台令牌、列出模型，以及使用账户权限编辑和发布博客或公告——直接通过 Claude、VS Code、Studio 或任何兼容 MCP 的客户端操作。

这是管理／控制台 API（platform.acedata.cloud），与调用 api.acedata.cloud 的数据生成 MCP 服务（Suno、Midjourney 等）不同。

工具参考

默认精选目录在按账户权限筛选前会展示 347 个工具，其中包括 acedatacloud_get_usage_guide。 完整的兼容性注册表保留 519 个工具。 发现工具按业务任务分组，而不是每个 REST 端点对应一个工具。

默认不展示	数量
备用的完整替换更新	20
客户端渲染、遥测或协议辅助工具	19
重复的原生路由	129
优先使用面向任务的目录读取器	4

类别

类别	公共	账户	工作区	管理员
账户与 API 密钥	0	11	0	1
目录与文档	20	2	0	0
应用与部署	0	13	0	4
用量与账单	1	41	0	28
站点与品牌	1	0	38	0
社区与钱包	1	31	0	12
内容与公告	4	0	23	0
邮件营销与分析	0	0	0	37
访问控制与自动化	0	5	13	20
支付授权	0	10	0	0
管理与风险控制	0	0	0	29
文件与实用工具	0	1	0	0

工作区工具涵盖委托编辑以及站点／Webhook 管理。 管理员工具要求获得相应的精确权限授予，不能仅凭管理员标签使用。

账户与 API 密钥

工具	描述	受众	所需权限
acedatacloud_create_credential	创建 API 凭证。	账户	credentials:write
acedatacloud_create_platform_token	创建管理令牌。	账户	authenticated
acedatacloud_delete_credential	撤销 API 凭证。	账户	credentials:write
acedatacloud_delete_platform_token	撤销管理令牌。	账户	authenticated
acedatacloud_get_credential	获取一个凭证，密钥会被遮蔽。	账户	credentials:read
acedatacloud_get_platform_tokens_id	获取平台令牌 ID。适用后端账户权限和所有权检查。	账户	authenticated
acedatacloud_get_user_info	当前已认证账户的个人资料。	账户	authenticated
acedatacloud_list_credentials	列出 API 凭证，密钥会被遮蔽。	账户	credentials:read
acedatacloud_list_credentials_detail	列出凭证。适用后端账户权限和所有权检查。	管理员	credentials:read, credentials:write:any
acedatacloud_list_platform_tokens	列出管理令牌，令牌值会被遮蔽。	账户	authenticated
acedatacloud_rotate_credential	轮换凭证，并仅披露一次密钥。	账户	authenticated
acedatacloud_update_credential	更新凭证限制和 API 范围。	账户	credentials:write

目录与文档

工具	描述	受众	所需权限
acedatacloud_create_datasets_download	创建数据集下载。适用后端账户权限和所有权检查。	账户	authenticated
acedatacloud_get_api_spec	根据路径获取单个 API 的 OpenAPI 定义。	公开	public
acedatacloud_get_apis_id	获取 API ID。适用后端账户权限和所有权检查。	公开	public
acedatacloud_get_apis_usage	获取 API 使用情况。适用后端账户权限和所有权检查。	公开	public
acedatacloud_get_datasets_id	获取数据集 ID。适用后端账户权限和所有权检查。	公开	public
acedatacloud_get_doc	根据 UUID 获取一个文档页面。	公开	public
acedatacloud_get_documents_openapi.json	获取 documents openapi.json。适用后端账户权限和所有权检查。	公开	public
acedatacloud_get_integrations_id	获取集成 ID。适用后端账户权限和所有权检查。	公开	public
acedatacloud_get_model	根据 ID 或名称查找模型。	公开	public
acedatacloud_get_pricing	获取一项服务的展示价格。	公开	public
acedatacloud_get_public_usage_packages	获取服务的公开 Usage 套餐额度和价格，用于将 Credit 换算为 USD。	公开	public
acedatacloud_get_service	根据 UUID 或别名获取一项服务。	公开	public
acedatacloud_get_services_apis	获取服务 API。适用后端账户权限和所有权检查。	公开	public
acedatacloud_get_services_proxies	获取服务代理。适用后端账户权限和所有权检查。	公开	public
acedatacloud_list_apis	列出 API 端点和计费元数据。	公开	public
acedatacloud_list_datasets	列出可下载的数据集。	公开	public
acedatacloud_list_docs	浏览文档页面。	公开	public
acedatacloud_list_integrations	列出平台集成。	公开	public
acedatacloud_list_model_catalog	列出详细的模型元数据和价格。	公开	public
acedatacloud_list_models	列出兼容 OpenAI 的聊天模型。	账户	authenticated
acedatacloud_list_services	列出或搜索可用服务。	公开	public
acedatacloud_search_docs	搜索公开文档。	公开	public

应用与部署

工具	描述	适用对象	所需权限
acedatacloud_control_deployment	启动已停止的部署。	账户	applications:write
acedatacloud_create_application	创建应用订阅。	账户	applications:write
acedatacloud_create_applications_sponsor	创建应用赞助。适用后端账户权限和所有权检查。	管理员	applications:write:any
acedatacloud_create_applications_update_disabled	创建应用更新禁用设置。适用后端账户权限和所有权检查。	管理员	applications:write:any
acedatacloud_create_applications_update_remaining_amount	创建应用更新剩余金额设置。适用后端账户权限和所有权检查。	管理员	credits:write:any
acedatacloud_deploy_application	启动或重新部署应用工作负载。	账户	applications:write
acedatacloud_get_application	获取单个应用及服务详情。	账户	applications:read
acedatacloud_get_applications_recharge_card_eligibility	获取应用充值卡资格信息。适用后端账户权限和所有权检查。	账户	authenticated
acedatacloud_get_balance	汇总剩余 Credits。	账户	applications:read
acedatacloud_get_deployment_events	获取部署调度事件。	账户	applications:read
acedatacloud_get_deployment_logs	获取有范围限制的部署日志。	账户	applications:read
acedatacloud_get_deployment_status	获取实时部署状态。	账户	applications:read
acedatacloud_list_applications	列出账户订阅。	账户	applications:read
acedatacloud_list_applications_detail	列出应用。适用后端账户权限和所有权检查。	管理员	applications:read, applications:read:any
acedatacloud_save_deployment_config	保存部署配置草稿。	账户	applications:write
acedatacloud_teardown_deployment	销毁工作负载并删除其应用。	账户	applications:write
acedatacloud_update_application_balance_policy	更新全局余额回退策略。	账户	applications:write

用量与计费

工具	描述	受众	所需权限
acedatacloud_apply_invoice	申请发票。	account	authenticated
acedatacloud_cancel_invoice	取消发票。	account	authenticated
acedatacloud_confirm_auto_recharge_setup	确认已保存的银行卡设置。	account	auto-recharge:write
acedatacloud_create_auto_recharge	创建自动充值。	account	auto-recharge:write
acedatacloud_create_auto_recharge_configs_cancel_setup	创建自动充值配置取消设置。适用后端账户权限和所有权检查。	account	auto-recharge:write
acedatacloud_create_card_fingerprints_action_name	创建银行卡指纹操作名称。适用后端账户权限和所有权检查。	admin	orders:write:any
acedatacloud_create_invoices_admin_file	创建发票管理文件。适用后端账户权限和所有权检查。	admin	invoices:write:any
acedatacloud_create_invoices_admin_upload_link	创建发票管理上传链接。适用后端账户权限和所有权检查。	admin	invoices:write:any
acedatacloud_create_order	创建充值订单。	account	orders:write
acedatacloud_create_order_discounts	创建订单折扣。适用后端账户权限和所有权检查。	admin	order-discounts:write:any
acedatacloud_create_orders_admin_create	创建订单管理创建项。适用后端账户权限和所有权检查。	admin	orders:write:any
acedatacloud_create_orders_distribution	创建订单分配。适用后端账户权限和所有权检查。	admin	distribution:write:any
acedatacloud_create_orders_finish	创建订单完成项。适用后端账户权限和所有权检查。	admin	orders:write:any
acedatacloud_create_orders_refund	创建订单退款。适用后端账户权限和所有权检查。	admin	orders:refund:any
acedatacloud_create_orders_update_details	创建订单详情更新项。适用后端账户权限和所有权检查。	admin	orders:write:any
acedatacloud_create_orders_update_price	创建订单价格更新项。适用后端账户权限和所有权检查。	admin	orders:write:any
acedatacloud_create_recharge_cards_admin_issue	创建充值卡管理发放项。适用后端账户权限和所有权检查。	admin	recharge-cards:write:any
acedatacloud_create_recharge_cards_allocations	创建充值卡分配项。适用后端账户权限和所有权检查。	account	applications:write
acedatacloud_create_recharge_cards_allocations_claim	创建充值卡分配认领项。适用后端账户权限和所有权检查。	account	applications:write
acedatacloud_create_recharge_cards_allocations_close	创建充值卡分配关闭项。适用后端账户权限和所有权检查。	account	applications:write
acedatacloud_create_recharge_cards_recipients_resolve	创建充值卡接收者解析项。适用后端账户权限和所有权检查。	account	applications:write
acedatacloud_create_recharge_cards_redeem	创建充值卡兑换项。适用后端账户权限和所有权检查。	account	recharge-cards:redeem
acedatacloud_delete_auto_recharge	删除自动充值。	account	auto-recharge:write
acedatacloud_delete_order_discounts_id	删除订单折扣 ID。适用后端账户权限和所有权检查。	admin	order-discounts:write:any
acedatacloud_disable_auto_recharge	停用自动充值。	account	auto-recharge:write
acedatacloud_export_orders	导出范围受限的订单 CSV。	account	orders:read
acedatacloud_export_usage	导出范围受限的用量 CSV。	account	usage:read
acedatacloud_get_auto_recharge	获取自动充值信息。	account	auto-recharge:read
acedatacloud_get_invoice	获取一张发票。	account	authenticated
acedatacloud_get_invoice_download	获取已签名的发票 URL。	account	authenticated
acedatacloud_get_invoices_admin_download	获取发票管理下载项。适用后端账户权限和所有权检查。	admin	invoices:read:any
acedatacloud_get_invoices_admin_id	获取发票管理 ID。适用后端账户权限和所有权检查。	admin	invoices:read:any
acedatacloud_get_invoices_admin_stats	获取发票管理统计数据。适用后端账户权限和所有权检查。	admin	invoices:read:any
acedatacloud_get_order	获取一个订单。	account	orders:read
acedatacloud_get_order_discounts_id	获取订单折扣 ID。适用后端账户权限和所有权检查。	admin	order-discounts:read:any
acedatacloud_get_order_invoice	获取订单当前有效的发票。	account	authenticated
acedatacloud_get_order_summary	汇总调用者的订单。	account	orders:read
acedatacloud_get_orders_admin_context	获取订单管理上下文。适用后端账户权限和所有权检查。	admin	orders:read:any
acedatacloud_get_orders_payment_options	获取订单支付选项。适用后端账户权限和所有权检查。	account	orders:read
acedatacloud_get_orders_revenue_summary	获取订单收入汇总。适用后端账户权限和所有权检查。	admin	revenue:read
acedatacloud_get_orders_revenue_trend	获取订单收入趋势。适用后端账户权限和所有权检查。	admin	revenue:read
acedatacloud_get_proxy_usage	获取代理用量详情。	account	usage:read
acedatacloud_get_recharge_cards_allocations_id	获取充值卡分配 ID。适用后端账户权限和所有权检查。	account	applications:read
acedatacloud_get_recharge_cards_allocations_token	获取充值卡分配令牌。适用后端账户权限和所有权检查。	public	applications:read
acedatacloud_get_recharge_cards_allocations_wallet	获取充值卡分配钱包。适用后端账户权限和所有权检查。	account	applications:read
acedatacloud_get_usage	获取 API 用量详情。	account	usage:read
acedatacloud_list_admin_invoices	列出所有账户的发票。	admin	invoices:read:any
acedatacloud_list_auto_recharges	列出自动充值配置。	account	auto-recharge:read
acedatacloud_list_billing_profiles	列出账单资料。	account	authenticated
acedatacloud_list_invoices	列出发票。	account	authenticated
acedatacloud_list_order_discounts	列出订单折扣。适用后端账户权限和所有权检查。	admin	order-discounts:read:any
acedatacloud_list_orders	列出充值订单。	account	orders:read
acedatacloud_list_orders_detail	列出订单。适用后端账户权限和所有权检查。	admin	orders:read, orders:read:any
acedatacloud_list_proxy_usage	列出代理用量。	account	usage:read
acedatacloud_list_recharge_cards_admin	列出充值卡管理项。适用后端账户权限和所有权检查。	admin	recharge-cards:read:any
acedatacloud_list_recharge_cards_allocations	列出充值卡分配项。适用后端账户权限和所有权检查。	account	applications:read
acedatacloud_list_usage	列出近期 API 用量记录。	account	usage:read
acedatacloud_list_usage_apis	列出用量 API。适用后端账户权限和所有权检查。	admin	usage:read, usage:read:any
acedatacloud_list_usage_proxies	列出用量代理。适用后端账户权限和所有权检查。	admin	usage:read, usage:read:any
acedatacloud_list_usage_status_codes	列出用量状态码。	account	usage:read
acedatacloud_pay_order	创建订单支付会话。	account	authenticated
acedatacloud_preview_invoice	预览发票金额。	account	authenticated
acedatacloud_quote_auto_recharge	获取自动充值报价。	account	auto-recharge:read
acedatacloud_refresh_order	刷新支付状态。	account	orders:write
acedatacloud_setup_auto_recharge	创建银行卡设置状态。	account	auto-recharge:write
acedatacloud_update_auto_recharge	更新自动充值。	account	auto-recharge:write
acedatacloud_update_invoices_admin_id	更新发票管理 ID。适用后端账户权限和所有权检查。	admin	invoices:write:any
acedatacloud_update_order_discounts_id	更新订单折扣 ID。适用后端账户权限和所有权检查。	admin	order-discounts:write:any
acedatacloud_update_recharge_cards_admin_id	更新充值卡管理 ID。适用后端账户权限和所有权检查。	admin	recharge-cards:write:any
acedatacloud_usage_summary	按 API 汇总 API 支出。	account	usage:read

Sites & branding

工具	描述	受众	所需权限
acedatacloud_create_site_banner	创建站点横幅	工作区	sites:write
acedatacloud_create_site_capability_override	创建站点能力覆盖项	工作区	sites:write
acedatacloud_create_site_document_override	创建站点文档覆盖项	工作区	sites:write
acedatacloud_create_site_domain	创建站点域名	工作区	sites:write
acedatacloud_create_site_home_sections	创建站点首页版块。适用后端账户权限和所有权检查。	工作区	sites:write
acedatacloud_create_site_service_override	创建站点服务覆盖项	工作区	sites:write
acedatacloud_create_sites	创建站点。适用后端账户权限和所有权检查。	工作区	sites:write
acedatacloud_delete_site_banner	删除站点横幅	工作区	sites:write
acedatacloud_delete_site_capability_override	删除站点能力覆盖项	工作区	sites:write
acedatacloud_delete_site_document_override	删除站点文档覆盖项	工作区	sites:write
acedatacloud_delete_site_domain	删除站点域名	工作区	sites:write
acedatacloud_delete_site_home_sections_id	删除站点首页版块 ID。适用后端账户权限和所有权检查。	工作区	sites:write
acedatacloud_delete_site_service_override	删除站点服务覆盖项	工作区	sites:write
acedatacloud_delete_sites_id	删除站点 ID。适用后端账户权限和所有权检查。	工作区	sites:write
acedatacloud_get_site	获取站点详情	工作区	sites:read
acedatacloud_get_site_banner	获取站点横幅详情	工作区	sites:read
acedatacloud_get_site_capability_override	获取站点能力详情	工作区	sites:read
acedatacloud_get_site_document_override	获取站点文档详情	工作区	sites:read
acedatacloud_get_site_domain	获取站点域名详情	工作区	sites:read
acedatacloud_get_site_home_sections_id	获取站点首页版块 ID。适用后端账户权限和所有权检查。	工作区	sites:read
acedatacloud_get_site_service_override	获取站点服务详情	工作区	sites:read
acedatacloud_initialize_site	初始化站点	工作区	sites:write
acedatacloud_list_site_banners	列出站点横幅	工作区	sites:read
acedatacloud_list_site_capability_overrides	列出站点能力覆盖项	工作区	sites:read
acedatacloud_list_site_document_overrides	列出站点文档覆盖项	工作区	sites:read
acedatacloud_list_site_domains	列出站点域名	工作区	sites:read
acedatacloud_list_site_home_sections	列出站点首页版块。适用后端账户权限和所有权检查。	工作区	sites:read
acedatacloud_list_site_home_sections_public	列出公开的站点首页版块。适用后端账户权限和所有权检查。	公开	公开
acedatacloud_list_site_service_overrides	列出站点服务覆盖项	工作区	sites:read
acedatacloud_list_sites	列出站点	工作区	sites:read
acedatacloud_set_site_menu_translation	设置站点菜单翻译	工作区	sites:write
acedatacloud_update_site	更新站点	工作区	sites:write
acedatacloud_update_site_banner	更新站点横幅	工作区	sites:write
acedatacloud_update_site_capability_override	更新站点能力覆盖项	工作区	sites:write
acedatacloud_update_site_document_override	更新站点文档覆盖项	工作区	sites:write
acedatacloud_update_site_domain	更新站点域名	工作区	sites:write
acedatacloud_update_site_home_sections_id	更新站点首页版块 ID。适用后端账户权限和所有权检查。	工作区	sites:write
acedatacloud_update_site_service_override	更新站点服务覆盖项	工作区	sites:write
acedatacloud_verify_site_domain	验证站点域名	工作区	sites:write

Community & wallet

工具	描述	受众	所需权限
acedatacloud_confirm_wallet_challenge	确认 Coin Wallet	账户	已通过身份验证
acedatacloud_create_coin_wallet_calculator	创建 Coin Wallet 计算器。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_create_coin_wallet_unbind	创建 Coin Wallet 解绑。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_create_distribution_redemptions_redeem	创建分销兑换。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_create_distribution_statuses_update_level	创建分销状态等级更新。适用后端账户权限和所有权检查。	管理员	distribution:write:any
acedatacloud_create_distribution_statuses_update_reward	创建分销状态奖励更新。适用后端账户权限和所有权检查。	管理员	distribution:write:any
acedatacloud_create_surveys_admin_templates	创建问卷管理模板。适用后端账户权限和所有权检查。	管理员	surveys:write
acedatacloud_create_wallet_challenge	Coin Wallet 验证挑战	账户	已通过身份验证
acedatacloud_delete_surveys_admin_templates_id	删除问卷管理模板 ID。适用后端账户权限和所有权检查。	管理员	surveys:write
acedatacloud_disable_translation	禁用翻译	账户	已通过身份验证
acedatacloud_enable_translation	启用翻译	账户	已通过身份验证
acedatacloud_get_coin_infos_id	获取 Coin 信息 ID。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_get_coin_policies_id	获取 Coin 策略 ID。适用后端账户权限和所有权检查。	公开	公开
acedatacloud_get_content_reports_admin_id	获取内容举报管理 ID。适用后端账户权限和所有权检查。	管理员	content-reports:read
acedatacloud_get_distribution_histories_id	获取分销历史记录 ID。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_get_distribution_rank	分销排名	账户	已通过身份验证
acedatacloud_get_distribution_redemptions_preview	获取分销兑换预览。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_get_distribution_statuses_id	获取分销状态 ID。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_get_distribution_trend	分销趋势	账户	已通过身份验证
acedatacloud_get_platform_distribution_rank	分销平台排名	账户	已通过身份验证
acedatacloud_get_survey	问卷详情	账户	已通过身份验证
acedatacloud_get_survey_response	问卷回答	账户	已通过身份验证
acedatacloud_get_surveys_admin_templates_id	获取问卷管理模板 ID。适用后端账户权限和所有权检查。	管理员	surveys:read
acedatacloud_get_translation_capabilities	翻译功能	账户	已通过身份验证
acedatacloud_get_wallet_summary	Coin Wallet 摘要	账户	已通过身份验证
acedatacloud_initialize_distribution	初始化分销	账户	已通过身份验证
acedatacloud_list_coin_info	Coin 信息	账户	已通过身份验证
acedatacloud_list_coin_policies	列出 Coin 策略。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_list_content_reports_admin	列出内容举报管理项。适用后端账户权限和所有权检查。	管理员	content-reports:read
acedatacloud_list_distribution_levels	分销等级	账户	已通过身份验证
acedatacloud_list_distribution_redemptions	列出分销兑换。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_list_distribution_statuses	列出分销状态。适用后端账户权限和所有权检查。	管理员	distribution:read:any
acedatacloud_list_distributions	获取推荐状态。	账户	已通过身份验证
acedatacloud_list_email_preferences	偏好设置列表	账户	已通过身份验证
acedatacloud_list_surveys	问卷列表	账户	已通过身份验证
acedatacloud_list_surveys_admin_responses	列出问卷管理回答。适用后端账户权限和所有权检查。	管理员	surveys:read
acedatacloud_list_surveys_admin_templates	列出问卷管理模板。适用后端账户权限和所有权检查。	管理员	surveys:read
acedatacloud_refresh_coin_info	刷新 Coin 信息	账户	已通过身份验证
acedatacloud_report_content	创建举报	账户	已通过身份验证
acedatacloud_submit_survey	提交问卷	账户	已通过身份验证
acedatacloud_update_coin_wallet_visibility	更新 Coin Wallet 可见性。适用后端账户权限和所有权检查。	账户	已通过身份验证
acedatacloud_update_content_reports_admin_id	更新内容举报管理 ID。适用后端账户权限和所有权检查。	管理员	content-reports:write
acedatacloud_update_email_preference	更新偏好设置	账户	已通过身份验证
acedatacloud_update_surveys_admin_templates_id	更新问卷管理模板 ID。适用后端账户权限和所有权检查。	管理员	surveys:write

内容与公告

工具	描述	受众	所需权限
acedatacloud_add_blog_comment	添加审核评论；需要 blog:read，以及 blog:write 或 blog:publish。	工作区	blog:read
acedatacloud_approve_blog_post	使用与创作者不同的账户批准已提交的版本。	工作区	blog:read, blog:publish
acedatacloud_create_announcement	发布平台公告。	工作区	announcements:write
acedatacloud_create_announcements_admin_polish	创建公告管理润色内容。后端会检查账户权限和所有权。	工作区	announcements:write
acedatacloud_create_announcements_admin_translate	创建公告管理翻译内容。后端会检查账户权限和所有权。	工作区	announcements:write
acedatacloud_create_blog_draft	保存未发布的博客草稿。	工作区	blog:write
acedatacloud_delete_announcements_admin_id	删除公告管理 ID。后端会检查账户权限和所有权。	工作区	announcements:write
acedatacloud_delete_blog_post	删除博客及其译文。	工作区	blog:write
acedatacloud_get_announcements_admin_id	获取公告管理 ID。后端会检查账户权限和所有权。	工作区	announcements:read
acedatacloud_get_blog_draft	读取完整的可编辑博客源文。	工作区	blog:read
acedatacloud_get_blog_post	阅读本地化的已发布博客文章。	公开	公开
acedatacloud_list_announcements	列出已发布的公告。	公开	公开
acedatacloud_list_announcements_admin	列出公告管理项。后端会检查账户权限和所有权。	工作区	announcements:read
acedatacloud_list_blog_comments	阅读私有审核讨论串及回复。	工作区	blog:read
acedatacloud_list_blog_drafts	列出博客草稿和已发布的编辑记录。	工作区	blog:read
acedatacloud_list_blog_posts	列出已发布的博客文章。	公开	公开
acedatacloud_list_showcases	列出展示项目。后端会检查账户权限和所有权。	公开	公开
acedatacloud_publish_blog_post	立即发布已批准的草稿，或安排其公开时间。	工作区	blog:write, blog:publish
acedatacloud_reject_blog_post	使用摘要或现有的未解决审核评论拒绝已提交的版本。	工作区	blog:read, blog:publish
acedatacloud_reply_blog_comment	回复审核评论；需要 blog:read，以及 blog:write 或 blog:publish。	工作区	blog:read
acedatacloud_resolve_blog_comment	解决或重新打开审核讨论串；需要 blog:read，以及 blog:write 或 blog:publish。	工作区	blog:read
acedatacloud_submit_blog_post	提交草稿或被拒绝的文章以供审核。	工作区	blog:write
acedatacloud_unpublish_blog_post	将公开的博客文章恢复为草稿。	工作区	blog:write, blog:publish
acedatacloud_update_announcements_admin_id	更新公告管理 ID。后端会检查账户权限和所有权。	工作区	announcements:write
acedatacloud_update_blog_post	编辑草稿源文；修改公开内容前请先取消发布。	工作区	blog:write
acedatacloud_withdraw_blog_approval	在发布前撤回批准。	工作区	blog:read, blog:publish
acedatacloud_withdraw_blog_submission	撤回待审核请求。	工作区	blog:write

电子邮件营销与分析

工具	描述	受众	所需权限
acedatacloud_create_email_audiences_candidates	创建电子邮件受众候选项。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_create_email_audiences_resolve	创建电子邮件受众解析结果。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_create_email_campaigns	创建电子邮件营销活动。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_create_email_control	创建电子邮件控制项。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_create_email_provider_health	创建电子邮件服务提供商健康状态。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_create_email_suppressions	创建电子邮件抑制项。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_create_email_suppressions_deactivate	创建电子邮件抑制项停用操作。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_delete_email_campaigns_id	删除电子邮件营销活动 ID。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_get_email_audiences_profiles_user_id	获取电子邮件受众资料用户 ID。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_email_audiences_summary	获取电子邮件受众摘要。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_email_campaigns_audience_candidates	获取电子邮件营销活动受众候选项。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_email_campaigns_id	获取电子邮件营销活动 ID。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_email_campaigns_preview	获取电子邮件营销活动预览。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_email_campaigns_report	获取电子邮件营销活动报告。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_email_overview	获取电子邮件概览。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_email_provider_health	获取电子邮件服务提供商健康状态。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_get_marketing_attribution_active_users	获取营销归因活跃用户。适用后端账户权限和所有权检查。	管理员	marketing-attribution:read
acedatacloud_get_marketing_attribution_analytics	获取营销归因分析数据。适用后端账户权限和所有权检查。	管理员	marketing-attribution:read
acedatacloud_get_marketing_attribution_summary	获取营销归因摘要。适用后端账户权限和所有权检查。	管理员	marketing-attribution:read
acedatacloud_list_email_campaigns	列出电子邮件营销活动。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_list_email_campaigns_recipients	列出电子邮件营销活动收件人。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_list_email_events	列出电子邮件事件。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_list_email_subscriptions	列出电子邮件订阅。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_list_email_suppressions	列出电子邮件抑制项。适用后端账户权限和所有权检查。	管理员	email-marketing:read
acedatacloud_run_email_campaigns_activate	执行电子邮件营销活动激活操作。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_run_email_campaigns_cancel	执行电子邮件营销活动取消操作。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_run_email_campaigns_create_carryover	执行电子邮件营销活动创建结转项操作。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_run_email_campaigns_pause	执行电子邮件营销活动暂停操作。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_run_email_campaigns_prepare	执行电子邮件营销活动准备操作。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_run_email_campaigns_prepare_carryover	执行电子邮件营销活动准备结转项操作。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_run_email_campaigns_preview_audience	执行电子邮件营销活动受众预览操作。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_run_email_campaigns_release_next_wave	执行电子邮件营销活动发布下一波次操作。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_run_email_campaigns_resume	执行电子邮件营销活动恢复操作。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_run_email_campaigns_retry_failed	执行电子邮件营销活动重试失败项操作。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_run_email_campaigns_revise	执行电子邮件营销活动修订操作。适用后端账户权限和所有权检查。	管理员	email-marketing:write
acedatacloud_run_email_campaigns_send	执行电子邮件营销活动发送操作。适用后端账户权限和所有权检查。	管理员	email-marketing:send
acedatacloud_update_email_campaigns_id	更新电子邮件营销活动 ID。适用后端账户权限和所有权检查。	管理员	email-marketing:write

Access control & automation

工具	描述	受众	所需权限
acedatacloud_cancel_access_request	取消访问请求	账户	已认证
acedatacloud_create_access_grants	创建访问授权。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_create_access_grants_grandfather	创建访问授权宽限项。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_create_access_policies	创建访问策略。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_create_access_request	创建访问请求	账户	已认证
acedatacloud_create_access_requests_approve	批准访问请求创建操作。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_create_access_requests_reject	拒绝访问请求创建操作。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_create_api_request_access_eligibility	创建 API 请求访问资格。后端账户权限和所有权检查适用。	账户	已认证
acedatacloud_create_feature_flags	创建功能标志。后端账户权限和所有权检查适用。	管理员	feature-flags:write
acedatacloud_create_webhook_subscriptions	创建 Webhook 订阅。后端账户权限和所有权检查适用。	工作区	webhooks:write
acedatacloud_create_webhooks	创建 Webhook。后端账户权限和所有权检查适用。	工作区	webhooks:write
acedatacloud_create_webhooks_test	创建 Webhook 测试。后端账户权限和所有权检查适用。	工作区	webhooks:write
acedatacloud_delete_access_grants_id	删除访问授权 ID。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_delete_access_policies_id	删除访问策略 ID。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_delete_feature_flags_id	删除功能标志 ID。后端账户权限和所有权检查适用。	管理员	feature-flags:write
acedatacloud_delete_webhook_subscriptions_id	删除 Webhook 订阅 ID。后端账户权限和所有权检查适用。	工作区	webhooks:write
acedatacloud_delete_webhooks_id	删除 Webhook ID。后端账户权限和所有权检查适用。	工作区	webhooks:write
acedatacloud_get_access_grants_id	获取访问授权 ID。后端账户权限和所有权检查适用。	管理员	access-control:read
acedatacloud_get_access_policies_id	获取访问策略 ID。后端账户权限和所有权检查适用。	管理员	access-control:read
acedatacloud_get_access_request	获取访问请求详情	账户	已认证
acedatacloud_get_feature_flags_evaluate	获取功能标志评估结果。后端账户权限和所有权检查适用。	管理员	feature-flags:read
acedatacloud_get_feature_flags_id	获取功能标志 ID。后端账户权限和所有权检查适用。	管理员	feature-flags:read
acedatacloud_get_feature_flags_scorecard	获取功能标志评分卡。后端账户权限和所有权检查适用。	管理员	feature-flags:read
acedatacloud_get_webhook_subscriptions_id	获取 Webhook 订阅 ID。后端账户权限和所有权检查适用。	工作区	webhooks:read
acedatacloud_get_webhooks_headers_name	获取 Webhook 请求头名称。后端账户权限和所有权检查适用。	工作区	webhooks:reveal
acedatacloud_get_webhooks_id	获取 Webhook ID。后端账户权限和所有权检查适用。	工作区	webhooks:read
acedatacloud_list_access_grants	列出访问授权。后端账户权限和所有权检查适用。	管理员	access-control:read
acedatacloud_list_access_policies	列出访问策略。后端账户权限和所有权检查适用。	管理员	access-control:read
acedatacloud_list_access_requests	列出访问请求	账户	已认证
acedatacloud_list_feature_flags	列出功能标志。后端账户权限和所有权检查适用。	管理员	feature-flags:read
acedatacloud_list_webhook_subscriptions	列出 Webhook 订阅。后端账户权限和所有权检查适用。	工作区	webhooks:read
acedatacloud_list_webhooks	列出 Webhook。后端账户权限和所有权检查适用。	工作区	webhooks:read
acedatacloud_list_webhooks_events	列出 Webhook 事件。后端账户权限和所有权检查适用。	工作区	webhooks:read
acedatacloud_update_access_grants_id	更新访问授权 ID。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_update_access_policies_id	更新访问策略 ID。后端账户权限和所有权检查适用。	管理员	access-control:write
acedatacloud_update_feature_flags_id	更新功能标志 ID。后端账户权限和所有权检查适用。	管理员	feature-flags:write
acedatacloud_update_webhook_subscriptions_id	更新 Webhook 订阅 ID。后端账户权限和所有权检查适用。	工作区	webhooks:write
acedatacloud_update_webhooks_id	更新 Webhook ID。后端账户权限和所有权检查适用。	工作区	webhooks:write

支付授权

工具	描述	受众	所需权限
acedatacloud_confirm_x402_authorization	X402 确认	账户	已认证
acedatacloud_confirm_x402_revocation	X402 撤销	账户	已认证
acedatacloud_create_x402_payment_authorization_revoke_setup	创建 x402 支付授权撤销设置。适用后端账户权限和所有权检查。	账户	coin:write
acedatacloud_create_x402_transaction_prepare	创建 x402 交易准备。适用后端账户权限和所有权检查。	账户	coin:write
acedatacloud_create_x402_transaction_status	创建 x402 交易状态。适用后端账户权限和所有权检查。	账户	coin:write
acedatacloud_create_x402_transaction_submit	创建 x402 交易提交。适用后端账户权限和所有权检查。	账户	coin:write
acedatacloud_disable_x402_authorization	X402 停用	账户	已认证
acedatacloud_enable_x402_authorization	X402 启用	账户	已认证
acedatacloud_get_x402_authorization	X402 当前状态	账户	已认证
acedatacloud_setup_x402_authorization	X402 设置	账户	已认证

管理与风险

工具	描述	受众	所需权限
acedatacloud_create_configuration_providers	创建配置提供方。适用后端账户权限和所有权检查。	admin	provider-routing:write
acedatacloud_create_configuration_providers_capabilities	创建配置提供方能力。适用后端账户权限和所有权检查。	admin	provider-routing:write
acedatacloud_create_distribution_cases_compensate	创建分发案例补偿。适用后端账户权限和所有权检查。	admin	distribution-risk:write
acedatacloud_create_distribution_cases_revert_compensation	创建分发案例撤销补偿。适用后端账户权限和所有权检查。	admin	distribution-risk:write
acedatacloud_create_distribution_risk_bans	创建分发风险封禁。适用后端账户权限和所有权检查。	admin	distribution-risk:write
acedatacloud_create_distribution_risk_bans_revoke	创建分发风险封禁撤销。适用后端账户权限和所有权检查。	admin	distribution-risk:write
acedatacloud_create_distribution_risk_bypasses	创建分发风险绕过项。适用后端账户权限和所有权检查。	admin	distribution-risk:write
acedatacloud_create_distribution_risk_bypasses_revoke	创建分发风险绕过项撤销。适用后端账户权限和所有权检查。	admin	distribution-risk:write
acedatacloud_create_payment_risk_holds_release	创建付款风险冻结释放。适用后端账户权限和所有权检查。	admin	orders:refund:any
acedatacloud_delete_configuration_capabilities_capability_id	删除配置能力 ID。适用后端账户权限和所有权检查。	admin	provider-routing:write
acedatacloud_delete_configuration_providers_pid	删除配置提供方 PID。适用后端账户权限和所有权检查。	admin	provider-routing:write
acedatacloud_get_admin_users_analytics	获取管理员用户分析数据。适用后端账户权限和所有权检查。	admin	users:read:any
acedatacloud_get_configuration_capabilities_checks	获取配置能力检查结果。适用后端账户权限和所有权检查。	admin	provider-routing:read
acedatacloud_get_configuration_domains	获取配置域。适用后端账户权限和所有权检查。	admin	provider-routing:read
acedatacloud_get_configuration_models_model	获取配置模型。适用后端账户权限和所有权检查。	admin	provider-routing:read
acedatacloud_get_configuration_providers_checks	获取配置提供方检查结果。适用后端账户权限和所有权检查。	admin	provider-routing:read
acedatacloud_get_configuration_providers_pid	获取配置提供方 PID。适用后端账户权限和所有权检查。	admin	provider-routing:read
acedatacloud_get_configuration_summary	获取配置摘要。适用后端账户权限和所有权检查。	admin	provider-routing:read
acedatacloud_get_distribution_cases_compensation_preview	获取分发案例补偿预览。适用后端账户权限和所有权检查。	admin	distribution-risk:read
acedatacloud_get_distribution_cases_id	获取分发案例 ID。适用后端账户权限和所有权检查。	admin	distribution-risk:read
acedatacloud_get_distribution_risk_bans_id	获取分发风险封禁 ID。适用后端账户权限和所有权检查。	admin	distribution-risk:read
acedatacloud_get_distribution_risk_bypasses_id	获取分发风险绕过项 ID。适用后端账户权限和所有权检查。	admin	distribution-risk:read
acedatacloud_list_configuration_models	列出管理模型路由和健康状态卡片，包括状态、活跃提供方、延迟、检查统计信息和提供方覆盖范围。支持 q、status 和 provider 筛选。	admin	provider-routing:read
acedatacloud_list_configuration_providers	列出配置提供方。适用后端账户权限和所有权检查。	admin	provider-routing:read
acedatacloud_list_distribution_risk_bans	列出分发风险封禁。适用后端账户权限和所有权检查。	admin	distribution-risk:read
acedatacloud_list_distribution_risk_bypasses	列出分发风险绕过项。适用后端账户权限和所有权检查。	admin	distribution-risk:read
acedatacloud_list_distribution_risk_histories	列出分发风险历史记录。适用后端账户权限和所有权检查。	admin	distribution-risk:read
acedatacloud_update_configuration_capabilities_capability_id	更新配置能力 ID。适用后端账户权限和所有权检查。	admin	provider-routing:write
acedatacloud_update_configuration_providers_pid	更新配置提供方 PID。适用后端账户权限和所有权检查。	admin	provider-routing:write

文件与实用工具

工具	描述	适用对象	所需权限
acedatacloud_create_files	创建文件。适用后端账户权限和所有权检查。	账户	已通过身份验证

调用写入/管理工具时，如果未设置 confirm=true，会返回经过脱敏的试运行预览，且不会发出 HTTP 请求。

查找开票失败的发票

使用 acedatacloud_list_invoices(status="Failed") 查找开票失败且属于调用者的发票。决定是否重新申请或联系支持人员前，请先阅读返回的 failure_reason。Failed 是读取筛选条件，不是管理员更新状态的选项。

银行转账付款

对于属于调用者的订单，请先调用 acedatacloud_get_orders_payment_options(id=...)，查看可用的转账方式和金额门槛。个人账户和企业账户均可使用 BankTransfer，无需进行企业验证，但国内人民币转账和国际美元转账要求订单金额至少为 USD 300。请使用付款时显示的人民币金额；是否可用还取决于收款渠道配置和套餐资格。

检查订单、金额和付款方式后，仅在确认后调用 acedatacloud_pay_order(order_id=..., pay_way="BankTransfer", confirm=true)。银行转账要求使用经过身份验证的订单所有者身份，不能匿名使用。

发票红冲与重新申请

调用 acedatacloud_get_order_invoice(order_id=...) 读取有效发票。自动红冲申请不会改变发票的 Issued 状态；red_state 用于跟踪进度。提交不代表完成：确认、红字发票开具或归档仍在等待处理时，请勿再次申请。只有在红字发票开具并归档后，原发票才会变为 Voided，订单才符合重新申请条件。使用 acedatacloud_list_invoices(order_id=...) 查看发票历史记录。

红冲失败或结果不确定时，需要财务审核，且不会提前解除发票限制。手动开具的发票必须先在税务/开票系统中作废或红冲，再由财务在平台上确认。

网站首页展示

对于网站版块，向 acedatacloud_create_site_home_sections 或 acedatacloud_update_site_home_sections_id 传入 presentation={"open_external": false} 可禁用外部打开；传入 true 可启用。请先读取当前版块并检查写入预览，然后再调用并设置 confirm=true。网站版块仍在 iframe 中呈现；Markdown 或 HTML 版块不支持 open_external。

创建时省略 presentation 会使用 Backend 默认值，PATCH 时省略则保留当前选项。PATCH 会合并提供的 presentation 键，因此空对象不会清除现有选项。使用 acedatacloud_get_site_home_sections_id 重新读取版块；无需账户凭据，也可以通过 acedatacloud_list_site_home_sections_public 获取可见版块的 presentation。

检查 x402 ACE 回购与销毁

启用该策略后，符合条件的 Base 主网 Circle USDC 和 Solana 主网 USDC 收款会将到账金额的 3% 精确用于购买并销毁 ACE，不会额外向钱包收费。每笔操作或每日 USDC 回购均无固定上限；可用资金、市场报价和链上最终确认时间仍可能影响完成时间。充值只计入一次；之后使用这些 Credits 发起的 API 调用不会再次计入。历史优惠订单和旧策略订单不会自动纳入。

调用 acedatacloud_get_order(order_id=...) 并检查 ace_burn。settlement_network 和 settlement_transaction 标识原始付款，而 execution_network 标识在 Solana 上执行的操作。Pending 或 Processing 不能证明已销毁；只有 Completed 表示已验证的最终证明，其中包括公开的 swap_signature 和 burn_signature 交易标识符。等待最终确认的 Base 付款可能会延迟回购，但不会阻止已入账的 Credits 使用。ace_burn 为 null 并不能证明销毁已完成。钱包／付款签名和授权负载均属机密信息。

诊断 x402 订单失败

读取 acedatacloud_get_order 或 acedatacloud_list_orders，并检查 metadata.x402.last_error / metadata.x402.errors。其中会保留公开的 code、stage、retryable、charged 和 params，公开说明位于 reason，事件时间位于 timestamp。重新读取订单时，会保留 insufficient_token_balance（所选网络上的 USDC 余额不足）和 invalid_signature 等具体代码，而不会将其替换为 payment_failed。

将 charged 视为三态：明确的 false 表示在结算前已被拒绝；缺少该字段表示扣款状态未知，而非未发生扣款。Failed 订单无法原地重试；请先解决钱包问题，再创建新订单。如需支持，请仅提供订单 ID 和公开错误代码，切勿提供完整付款签名、钱包签名、授权负载或原始 facilitator／RPC 诊断信息。

连接到账户 MCP

这是位于 https://mcp.acedata.cloud/mcp 的管理 MCP。它使用的是平台令牌，而非生成 MCP 使用的各服务专用 ACEDATACLOUD_API_TOKEN。请选择以下一种方式：

方式	适用情况	凭据
托管式 OAuth	MCP 客户端支持远程 OAuth	仅添加 URL，然后登录，并在同意屏幕上确认实际的账户权限。DCR 注册的是客户端，而非 API 密钥。
托管式平台令牌	客户端无法完成 OAuth，或需要明确的管理凭据	在客户端的 HTTP 标头中发送 Authorization: Bearer platform-…。
本地 stdio	客户端会启动本地 MCP 进程	安装 mcp-acedatacloud，并为该进程设置 ACEDATACLOUD_PLATFORM_TOKEN。

托管式 OAuth 会复用或创建持久的平台令牌。请在同意屏幕上确认所请求的账户功能；账户当前的后端权限仍决定各项工具的具体权限，OAuth 同意不会授予管理员访问权限。敏感写入操作必须按文档要求完成确认步骤。平台令牌仅在创建时完整返回；请妥善保密。平台令牌文档。

托管 OAuth 客户端

• Claude / Claude Desktop 聊天： 在 Customize → Connectors → Add custom connector 中添加远程自定义连接器，输入 https://mcp.acedata.cloud/mcp，选择登录；如果 Claude 询问如何注册其 OAuth 客户端，请选择 Register automatically。查看授权同意内容。Desktop 本地 JSON 文件采用单独的本地进程机制。Claude 连接器指南。
• Claude Code： claude mcp add --transport http --scope user acedatacloud https://mcp.acedata.cloud/mcp，然后运行 claude mcp login acedatacloud。检查 /mcp。Claude Code 指南。
• Cursor： 将 https://mcp.acedata.cloud/mcp 添加为远程 MCP 服务，并完成浏览器登录。个人配置为 ~/.cursor/mcp.json；项目配置为 <project>/.cursor/mcp.json。Cursor 指南。
• VS Code / Copilot： 运行 MCP: Add Server，选择 HTTP，输入 URL，完成登录，然后检查 MCP: List Servers。VS Code 工作区格式为 <project>/.vscode/mcp.json；较新的可移植格式为 <project>/.mcp.json。VS Code 指南。
• Codex： codex mcp add acedatacloud --url https://mcp.acedata.cloud/mcp，然后运行 codex mcp login acedatacloud。用户设置位于 ~/.codex/config.toml。Codex 官方指南。

仅含 URL 的 Cursor 示例：

{"mcpServers":{"acedatacloud":{"url":"https://mcp.acedata.cloud/mcp"}}}

VS Code 专用工作区示例：

{"servers":{"acedatacloud":{"type":"http","url":"https://mcp.acedata.cloud/mcp"}}}

显式平台令牌

1. 在 Ace Data Cloud → Account Tokens 登录或注册。
2. 点击 Create，然后点击复制按钮复制令牌。令牌以 platform- 开头；它是账户管理凭据，与应用的生成 API 密钥不同。
3. 仅将令牌粘贴到此账户 MCP 的凭据字段中，或为本地 stdio 设置 ACEDATACLOUD_PLATFORM_TOKEN。只有在自行配置 HTTP Authorization 标头时，才添加 Bearer 。
4. 妥善保管令牌；不再需要时，可在 Account Tokens 中将其删除以撤销访问权限。对于支持托管 OAuth 的客户端，也可以改用本指南所述的浏览器登录流程。

对于 Claude Code，添加服务时 shell 会展开令牌，因此请保护已保存的用户配置：

export ACEDATACLOUD_PLATFORM_TOKEN='YOUR_PLATFORM_TOKEN'
claude mcp add --transport http --scope user acedatacloud https://mcp.acedata.cloud/mcp \
  --header "Authorization: Bearer $ACEDATACLOUD_PLATFORM_TOKEN"

对于共享的 Claude Code 项目配置，只将变量引用合并到 <project>/.mcp.json 中；每位用户都需单独设置环境变量：

{
  "mcpServers": {
    "acedatacloud": {
      "type": "http",
      "url": "https://mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${ACEDATACLOUD_PLATFORM_TOKEN}"}
    }
  }
}

Cursor 在 ~/.cursor/mcp.json 或未提交的项目配置中使用 ${env:ACEDATACLOUD_PLATFORM_TOKEN}。在 VS Code 中，MCP: Open User Configuration 支持在 headers 条目中使用经过遮蔽的 ${input:platform-token} 值；请将该输入保留在用户／工作区格式中，而不要放入可移植的 .mcp.json。Cursor 配置 · VS Code 配置。

本地 stdio

python -m pip install mcp-acedatacloud
export ACEDATACLOUD_PLATFORM_TOKEN='YOUR_PLATFORM_TOKEN'
mcp-acedatacloud

Claude Desktop 的本地进程配置可从其开发者设置中打开（macOS 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "acedatacloud": {
      "command": "uvx",
      "args": ["mcp-acedatacloud"],
      "env": {"ACEDATACLOUD_PLATFORM_TOKEN": "YOUR_PLATFORM_TOKEN"}
    }
  }
}

请妥善保管用户级文件。uvx 需要在 PATH 中安装 uv。这是一个本地 MCP 进程，与 Claude 的远程连接器相互独立。

验证权限

MCP 连接正常且显示了工具列表，说明客户端已发现该服务。先读取 acedatacloud_get_user_info 或 acedatacloud_get_balance 等信息，以验证账户上下文。目录工具可能是公开读取工具；能看到它们并不能证明你的平台令牌可以执行账户写入操作。修改数据时请遵循确认流程，并重新读取结果。遇到 401 时，检查令牌类型或 OAuth 会话；遇到 403 时，检查账户实际获得的权限。金额以 Credits 计，不是 USD。

示例提示词

• “用 Markdown 起草一篇中文产品博客，展示给我审核，然后保存。”
• “使用我上传的 HTTPS 视频 URL 保存一篇未发布的视频博客，然后提交同行评审。”
• “提交博客草稿 <id> 进行审核，然后使用另一个账户附上评论，通过或拒绝该草稿。”
• “使用非审核者账户发布通过同行评审的博客草稿 <id>。”
• “将博客 <id> 设为 2026-10-10T09:00:00+08:00 发布。”
• “我还剩多少 Credits？”
• “过去 7 天我在 Suno 上花了多少？”
• “列出我的 API 密钥，并显示哪些密钥设有支出上限。”
• “在应用 <id> 上创建一个名为 ci 的新 API 密钥。” → 预览，然后使用 confirm 运行。
• “为应用 <id> 充值套餐 <id>，并给我 Stripe 支付链接。”

配置

变量	默认值	说明
ACEDATACLOUD_PLATFORM_TOKEN	—	必需。 平台令牌。
PLATFORM_API_BASE_URL	https://platform.acedata.cloud	管理 API 基础 URL。
PLATFORM_REQUEST_TIMEOUT	30	请求超时时间（秒）。
LOG_LEVEL	INFO	日志级别。

开发

pip install -e ".[dev,test,http]"
pytest -m "not integration"      # unit tests
ruff check .                      # lint
mypy core tools                   # type-check
mcp-acedatacloud --transport http --port 8000

说明

• 金额（remaining_amount、used_amount、总额）以 Credits 计，不是 USD。
• 兼容工具 acedatacloud_get_config 会返回 features 和通过 IP 检测到的小写 region（未知时为 null）。它不接受 country 或 region 覆盖值。features 覆盖仍受 Backend 权限限制；前端区域选择仅是本地显示状态，不会覆盖服务端区域。
• 对于仅提供公开联系方式的 Dataset 服务，acedatacloud_get_pricing 会返回公开服务目录中的 pricing_mode 和任何 reference_quote。请保留报价中的货币、金额范围、单位和 status="reference"；这些是指示性报价，不是 Credits 计费规则或可购买的 Usage 套餐。请联系平台确认服务范围和最终价格。如果元数据中没有报价，则不会虚构报价。
• 新创建的凭证／平台令牌只会完整返回一次——请立即保存。
• 凭证轮换 = 删除并重新创建（没有原地轮换端点）。
• 博客草稿默认采用 content_type="article"，且必须提供 Markdown content。发布视频帖子时，请设置 content_type="video" 并提供已上传的 HTTPS video_url；Markdown 内容可选，也可通过 content="" 清空。公开列表支持按 content_type 筛选。更改视频／类型与编辑来源一样会撤销审核通过状态；发布前请提交保存后的版本进行同行审核。
• 博客编辑工具使用 blog:read、blog:write 和 blog:publish 权限。直接授权和权限组无需将账户设为超级用户即可生效。
• 博客分类为 product-updates、tech-sharing（草稿默认分类）、product-recommendations 和 industry-insights，也可使用管理员已定义的现有 slug。旧别名 product、engineering、model-news 和 comparison 仍受支持，并由 Backend 规范化。
• 更改分类会撤销草稿的审核通过状态。分类迁移还会暂停分类已更改的定时帖子；发布或重新安排帖子前，请重新读取草稿并获取新的同行审核。
• 发布博客需要已提交的草稿，并由具有 blog:read 和 blog:publish 权限的其他账户审核通过。驳回时必须说明原因；通过审核时可添加评论。发布者也必须与审核者不同。审核前请读取 review_version；编辑内容会撤销审核通过状态，撤回已发布帖子则会使其恢复为草稿。
• 托管式 OAuth 会动态解析已登录账户的规范权限。授权页面会显示实际权限范围；没有博客授权的账户不会获得任何相关权限。重新连接 OAuth 以查看新授予的权限。现有的长期平台令牌会在每次请求时遵循账户当前权限，包括已撤销的权限。
• 公告工具需要对应的账户权限。
• 新分配的充值卡仅接受 ribbon、blossom、dawn 和 confetti 封面主题；省略 theme_id 时使用 Backend 默认值（ribbon）。创建操作会拒绝旧版主题 ID；现有卡片会保留原有封面。

管理 API 覆盖范围

已纳入版本控制的路由清单 contracts/management_surface.json 覆盖当前 Platform 管理 API。每项业务操作都映射到原生类型化工具；回调、内部／设备协议、网站资源交付，以及后端拒绝的方法均明确列出排除原因。现有账户工具保留按主体范围查询的逻辑。管理工具使用后端规范的权限名称和所有权检查。

托管版 tools/list 会根据当前 Platform 凭据在 /platform-tokens/me/ 中的有效权限进行筛选。请先部署 Backend 主体响应和 Auth 同意变更，再部署此 MCP。文件上传输入和二进制输出均为 Base64 工件，大小上限为 2 MiB；签名下载链接会直接返回。

对于 acedatacloud_create_files，请提供 filename 和 content_base64，检查预览后，再设置 confirm=true 重试以上传。结果中的 file_url 可公开访问：请勿上传机密材料。Backend 会选择唯一的 uploads/<uuid> 路径，并保留安全的文件名扩展名。请提供与实际字节内容相符的 content_type；如果省略该字段或设为 application/octet-stream，Backend 会根据文件名推断。扩展名和 MIME 推断都不会转换文件。返回的 mime 是存储时使用的 MIME 类型。请在其他 API 中重复使用返回的 file_url，不要自行构造 URL，也不要将 CDN 托管视为永久存档。即使 Backend 接受更大的文件，MCP 的 2 MiB 限制仍然适用。

发现与兼容性

默认的 ACEDATACLOUD_TOOL_PROFILE=curated 会公开面向任务的工具，而不是重复生成的 REST 别名、多余的 PUT 变体和 Web 客户端辅助工具（渲染、已读回执、遥测和协议处理）。它保留个人账户、站点、编辑和管理业务工作流。使用指南仅列出当前凭据可见的工具。 每个公开的 API 工具还会在其 MCP _meta 字段中携带 acedatacloud/category 和 acedatacloud/audience 元数据。

现有集成仍可调用已启用的旧版名称、参数和路由；隐藏的别名不会重定向到其他实现。已弃用的 ACE 快照操作已从两种配置中移除，无法调用。显式设置 ACEDATACLOUD_TOOL_PROFILE=full，即可用于兼容性发现或诊断。但这只会恢复发现能力：权限、所有权检查、机密信息脱敏以及 confirm=true 要求仍然适用。

只有具备相应 :any 权限时，跨账户集合工具才会保持可发现。个人账户工具会继续将查询限定在已认证主体范围内。无关的管理权限不会将账户查询提升为跨账户查询。

要先使用 Backend 运行时、再使用 MCP 运行时刷新生成的接口：

<backend-python> scripts/export_platform_management.py --backend <PlatformBackend> --output /tmp/platform-routes.json
python scripts/compile_platform_management.py --input /tmp/platform-routes.json --backend <PlatformBackend>

两个脚本都位于 monorepo 根目录。导出器使用合成配置，不会读取生产环境的 .env，也不会执行端点处理程序。

文档

文档

许可证

MIT — 详见 LICENSE。