快速开始
这份开发者文档介绍 Arenza 目前支持的接入方式：网站 SDK、服务端事件和 MCP Server，也提供 API Key 管理说明及事件接口参考。先看下面的章节目录，再按你的任务选择入口。
文档章节
| 章节 | 支持内容 |
|---|---|
| 01 · API Key | 在 Portal 创建密钥，选择 Read / Write 权限，安全保存、轮换和撤销。 |
| 02 · 网站 SDK | HTML / JavaScript 安装、初始化、交互上报、访客 ID，以及同意管理和停止采集。 |
| 03 · 服务端事件 | Python / Go 示例和辅助代码、已配置事件的发送、访客关联、回执与重试。 |
| 04 · MCP Server | Claude Code、Cursor 等远程 MCP 客户端的 OAuth 连接、只读验证和连接排查。 |
| 05 · 接口参考 | 浏览器与服务端事件的鉴权、字段、响应和错误码；另附浏览器 curl 示例和 JSON Schema。 |
章节编号与左侧目录一致；手机上可展开顶部的“章节目录”。切换中英文会保留当前章节。
按任务开始
- 从网站采集交互：先读 02 · 网站 SDK，使用公开的 Website install ID。不要把秘密 API Key 放进网页。
- 从后端发送业务事件：先读 01 · API Key，再读 03 · 服务端事件。需要 Write 权限、品牌访问权限及已配置的事件。
- 让 AI 客户端连接 Arenza：直接读 04 · MCP Server。MCP 使用 OAuth 登录授权，不使用 Personal Access Token。
补充资料
接入总览保留 HTML、JavaScript、Python、Go 的完整接入示例；线上验证记录说明已验证的路径和范围。
事件接口返回 202 只表示接收或入队，不代表业务成功、归因或计费完成。同一次事件只选一种上报方式。具体限制请看相应章节。