> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orriven.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 orriven 上使用 Agent

> AI Agent 集成架构：用于组织与开发资源管理的 MCP 服务，以及用于活动业务数据操作的 Developer API。

AI Agent 与自动化工具可以通过两种接口与 orriven 集成。两者采用不同的授权机制与操作作用域：

| 维度        | MCP 服务                                     | Developer API（开放 API）                              |
| --------- | ------------------------------------------ | -------------------------------------------------- |
| **身份与授权** | 基于 OAuth 2.1 的委托用户授权                       | 基于 API 密钥（`osk_…`）的服务凭据                            |
| **涵盖范围**  | 开发者与管理资源：API 密钥、Webhook、请求日志、指标监控、组织与业务单元  | 活动业务数据：活动、票种、报名、兑换码、订单、签到与参展商                      |
| **认证流程**  | 浏览器授权确认（每个客户端一次）                           | HTTP Bearer 令牌                                     |
| **依赖安装**  | 标准 HTTPS 端点（`https://api.orriven.com/mcp`） | 标准 REST HTTPS 端点（`https://openapi.orriven.com/v1`） |
| **审计记录**  | 授权用户账号，标注 *经由 MCP*                         | 所使用的 API 密钥标识                                      |

<Info>
  **协同工作流**：先[连接 MCP 服务](/zh/agent/connect)，通过 `create_api_key` 为目标业务单元生成 Secret 密钥，随后在 Agent 运行环境中配置该密钥以调用 [Developer API](/zh/developers/overview) 执行活动业务数据操作。
</Info>

## MCP 服务

```text theme={null}
https://api.orriven.com/mcp
```

MCP 服务基于 Streamable HTTP 与 OAuth 2.1 实现了 Model Context Protocol 规范，兼容 Claude.ai 连接器、Claude Code、Cursor 以及基于官方 MCP SDK 构建的客户端。

完成客户端注册与授权后，客户端将获得短效访问令牌并在使用期间自动续期。所有工具调用严格继承授权用户在对应组织与业务单元内的角色权限。

* [连接 Agent](/zh/agent/connect) — Claude.ai、Claude Code 及标准 MCP 客户端的配置指南。
* [工具参考](/zh/agent/tools) — 工具定义、输入参数与返回值规范。
* [示例工作流](/zh/agent/recipes) — 密钥分发、Webhook 排障及安全应急响应等常见任务。
* [安全与授权](/zh/agent/security) — 授权范围、令牌生命周期与审计日志规范。

<Tip>
  **要让代理搭活动站？** 安装 [orriven skills](https://github.com/orriven/skills)——Claude Code 里 `/plugin marketplace add orriven/skills`，或 `npx skills add orriven/skills`——代理便知道如何连接、把项目绑到业务单元、用 Next.js 对着 API 与托管页面搭出完整站点，并做端到端校验。
</Tip>

## Developer API（开放 API）

涉及活动业务数据的自动化任务（如查询余票容量、审批参会申请、批量登记等），统一通过 Developer API 发起请求：向 `https://openapi.orriven.com/v1` 发送请求并携带 `Authorization: Bearer osk_…`。

完整资源模型与接口定义请参阅 [Developer API 概览](/zh/developers/overview) 以及 `/openapi.json` 提供的 OpenAPI 规范。

<Note>
  MCP 服务专注于平台配置与凭据管理。活动业务数据操作统一由 REST Developer API 提供，以确保接口规范与业务逻辑的一致性。
</Note>