关于 AgentaOS
AgentaOS 是面向 AI Agent 产品的商家记录服务,可管理收款、订阅和发票,并由 AgentaOS 作为法定卖方处理 VAT、销售税等事务。它提供 CLI、SDK、MCP 服务及可嵌入的结账界面。
主要功能
- 01创建产品与结账链接
- 02管理订阅、试用和折扣码
- 03处理 VAT、税款与发票
- 04通过银行卡或欧元银行转账收款
- 05提供嵌入式结账界面
适用场景
- 01为 AI Agent 产品设置付费结账
- 02为产品开通订阅与试用
- 03在网站中嵌入结账流程
- 04通过 AI 编码 Agent 配置账单
MCP 相关
AgentaOS 提供 MCP 服务,包含与 CLI 相同操作的 31 个工具。Claude Code 插件和托管 MCP 服务可供 AI 助手连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.agentaos.ai/mcpclaude mcp add --transport http agentaos-agentaos https://mcp.agentaos.ai/mcp{"mcpServers":{"agentaos-agentaos":{"type":"http","url":"https://mcp.agentaos.ai/mcp"}}}在 Cursor 中打开{"servers":{"agentaos-agentaos":{"type":"http","url":"https://mcp.agentaos.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"agentaos-agentaos":{"type":"http","url":"https://mcp.agentaos.ai/mcp"}}}{"mcpServers":{"agentaos-agentaos":{"serverUrl":"https://mcp.agentaos.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
AgentaOS
将用户转化为付费客户
AgentaOS 是 AI Agent 的名义商户:你的 Agent(Claude、ChatGPT、Cursor)负责设置产品、结账链接和订阅,而 AgentaOS 是法律上的销售方,因此 VAT、销售税、发票和拒付都由我们负责。这意味着什么。
AgentaOS 的功能
AgentaOS 以自己的名义销售你的产品,作为名义商户。每笔销售中,AgentaOS 都会:
- 通过银行卡收款;欧元销售也支持银行转账。
- 收取适用于买家的 VAT。
- 开具发票并发送收据。
- 将款项支付到你的银行账户。稳定币付款目前处于公开预览阶段。
同一个账户还可让你使用:
- 支持试用、方案变更和额度的订阅。
- 折扣码,包括仅用于追踪推荐来源的折扣码。
- 发票、收据和客户列表。
- 可嵌入自有页面的结账页面。
- 平台功能,可为客户的业务提供计费服务(私有预览)。
你的账户初始为测试模式。验证你的企业后,即可收取真实付款。
开始销售
在 app.agentaos.ai 注册,或从终端开始:
npm install -g agentaos
agenta login
agenta products create --name "Pro" -a 29 -c EUR --subscription --interval month
最后一条命令会输出产品的买家链接。你可以随处分享此链接:每位打开链接的买家都会进入结账页面。
如需从自己的服务器发起结账,请使用 SDK:
npm install @agentaos/pay
import { AgentaOS } from '@agentaos/pay';
const agentaos = new AgentaOS(process.env.AGENTAOS_API_KEY!);
const checkout = await agentaos.checkouts.create({
amount: 49,
currency: 'EUR',
description: 'Pro plan',
successUrl: 'https://example.com/welcome',
});
// Send the buyer to checkout.checkoutUrl
快速入门将引导你从注册到完成首笔付费销售。
使用 AI 编码 Agent 设置计费
Claude Code 插件会为你的编码 Agent 提供 AgentaOS 工具,以及集成模式指南:
claude plugin marketplace add AgentaOS/agentaos
claude plugin install agentaos@agentaos
在 Claude Code 中输入 /mcp,选择 agentaos,然后选择 Authenticate。你可以在浏览器中批准连接,无需粘贴密钥。
其他 MCP 客户端可从 agentaos 包运行 MCP 服务。它提供 31 个工具,涵盖与 CLI 相同的操作。请参阅 MCP 设置。
在页面中嵌入结账页面
嵌入式结账页面可直接显示在产品页面中,也可作为覆盖层显示。银行卡、银行转账、试用、折扣码和 VAT 的处理方式与托管式结账页面相同。
<script src="https://app.agentaos.ai/v1/agentaos.js"></script>
<div id="checkout"></div>
<script>
AgentaOS.checkout.open({
link: 'https://app.agentaos.ai/pay/<your-product-link>',
target: '#checkout',
});
</script>
请先在 设置 → 开发者 → 已批准的网站 中添加你的网站。请参阅嵌入式结账。
软件包
| 软件包 | 说明 | 文档 |
|---|---|---|
@agentaos/pay | 供服务器使用的 TypeScript SDK:结账、产品、订阅、折扣码、客户、发票、Webhook | SDK 概览 |
agentaos | agenta CLI 和 MCP 服务,每项操作对应一条命令 | CLI 安装 |
@agentaos/checkout | 供浏览器使用的嵌入式结账,支持 React。目前尚未发布到 npm:请使用上方的 script 标签 | 嵌入式结账 |
plugins/agentaos | Claude Code 插件 | MCP 设置 |
packages/mcp-remote | 托管于 mcp.agentaos.ai 的 MCP 服务,供通过网络连接的助手使用 | MCP 设置 |
如需通过一个账户为其他企业处理账单,请参阅构建平台。
示例
examples/paywall-demo 是一个小型 Express 应用,用户登录后即可使用付费的 Pro 方案。它会创建结账、确认付款、验证 Webhook 并检查访问权限。
本仓库中的其他内容
Agent 钱包软件包(core、signer、schemes、chains 和 mpc-wasm)是由 AI Agent 操作的链上钱包,采用阈值签名,确保没有任何一方持有完整密钥。Agent 钱包目前处于私人预览阶段。请参阅 Agent 钱包和论文。
贡献
git clone https://github.com/AgentaOS/agentaos.git && cd agentaos
pnpm install && pnpm build && pnpm test
请参阅 CONTRIBUTING.md。如 SECURITY.md 所述,请将安全问题报告至 [email protected]。
许可证
Apache-2.0。请参阅 LICENSE。
版权所有 2025-2026 Aristokrates OÜ
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。