Cursor · Claude · Codex

将 Orauria连接到你的聊天客户端

创建 sk- API Key,把 Orauria 加为 MCP 服务器,然后在 Cursor、Claude 或 Codex 中聊天 — 图片、视频与 LLM 工具从 Orauria 钱包扣费。

  • 支持 Cursor、Claude Code / Desktop、Codex
  • 用个人中心的 sk- API Key 鉴权
  • 价格与 Studio 相同 — 从 Orauria 钱包扣费

点击「添加到 Cursor」后,把 Authorization 中的 sk-YOUR_ORAURIA_API_KEY 换成个人中心的密钥。

Cursor · Claude · Codex

你

先查一下余额,再生成一张柔和日光的产品海报。

MCP 工具

get_wallet → generate_image

结果

余额充足 · 图片 URL 就绪 · 已从钱包扣费

你留在聊天客户端。Orauria 运行工具并扣除积分。

Cursor · Claude · Codex

如何连接

从 API Key 到在 Agent 中聊天,三步完成。

  1. 01

    创建 API Key

    打开个人中心 → API keys,创建密钥并复制 sk-…。仅显示一次。

  2. 02

    把 MCP 加到客户端

    用下方配置连接 Cursor、Claude 或 Codex。

  3. 03

    聊天并调用工具

    让 Agent 聊天、生成或查钱包。积分从 Orauria 余额扣除。

你可以做什么

与 Studio 相同的能力,通过 MCP 从本地聊天客户端调用。

  • 生成图片

    从 Agent 向模型发提示。费用按 Studio。

  • 生成视频

    启动视频任务,等待完成后打开结果 URL。

  • LLM 聊天

    通过 MCP 使用 Orauria 聊天模型。按 token 计费。

按客户端连接

选择 Cursor、Claude 或 Codex — 共用同一把 sk- API Key。

Cursor

一键安装,或把 JSON 粘贴到 MCP 设置。

添加到 Cursor
  1. 1

    创建 Orauria API Key

    登录后打开个人中心 → API keys,创建并复制 sk-…。请妥善保管。

  2. 2

    打开 Cursor MCP 设置

    Cursor Settings → MCP。使用本页「添加到 Cursor」,或创建 .cursor/mcp.json。

  3. 3

    替换占位密钥

    把真实的 sk-… 填入 Authorization Bearer。URL 为当前站点 + /api/mcp。

  4. 4

    刷新 MCP 并试一下

    启用 orauria 服务器,然后让 Agent 列出模型或生成图片。

Cursor MCP 配置

.cursor/mcp.json

{
  "mcpServers": {
    "orauria": {
      "url": "http://orauria.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-YOUR_ORAURIA_API_KEY"
      }
    }
  }
}

Claude

Claude Code 用 .claude.json;Claude Desktop 用 mcp-remote。

  1. 1

    创建 Orauria API Key

    从个人中心 → API keys 复制 sk-…。

  2. 2

    Claude Code

    将 HTTP MCP 条目合并进 ~/.claude.json,然后重启 Claude Code。

  3. 3

    Claude Desktop

    用带 Bearer sk-… 的 mcp-remote 作为 stdio 桥接,然后重启 Claude Desktop。

Claude Code 配置

.claude.json

{
  "mcpServers": {
    "orauria": {
      "type": "http",
      "url": "http://orauria.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-YOUR_ORAURIA_API_KEY"
      }
    }
  }
}

Claude Desktop(mcp-remote)

mcp-remote

npx -y mcp-remote http://orauria.com/api/mcp --header "Authorization: Bearer sk-YOUR_ORAURIA_API_KEY"

Codex

在 ~/.codex/config.toml 配置 model_providers(OpenAI Responses API)— 优先于 MCP。

  1. 1

    创建 Orauria API Key

    从个人中心 → API keys 复制 sk-…(需有钱包余额)。

  2. 2

    编辑 ~/.codex/config.toml

    设置 model_provider = orauria,base_url = {site}/api/v1,wire_api = responses。

  3. 3

    把 sk- 填入 experimental_bearer_token

    将 sk-YOUR_ORAURIA_API_KEY 换成真实密钥。本地: http://localhost:3000/api/v1

  4. 4

    运行 Codex 并试用

    Codex 经 Orauria 调用 /responses — 有用量时从钱包扣费。

Codex config.toml(推荐)

~/.codex/config.toml

model = "tt-5.6-sol"
model_reasoning_effort = "high"
model_provider = "orauria"

[model_providers.orauria]
name = "Orauria"
base_url = "http://orauria.com/api/v1"
experimental_bearer_token = "sk-YOUR_ORAURIA_API_KEY"
wire_api = "responses"

Codex CLI

codex mcp add

codex mcp add orauria --url http://orauria.com/api/mcp --bearer-token-env-var ORAURIA_API_KEY

Codex 环境变量

.zshrc / .bashrc

export ORAURIA_API_KEY='sk-YOUR_ORAURIA_API_KEY'

将 sk-YOUR_ORAURIA_API_KEY 替换为个人中心的 sk-…。密钥只保存在本地客户端配置中 — Orauria 不会要求你粘贴到本页。

Agent 可调用的工具

每次调用使用你的 API Key,并按 Studio 对应价格计费。

  • generate_image

    根据提示与模型生成图片,返回结果 URL。

  • generate_video

    启动视频任务,轮询直到结果 URL 就绪。

  • chat

    与 Orauria LLM 聊天,按 token 计费。

  • list_models

    查看可用的图片、视频与聊天模型。

  • get_wallet

    生成前检查剩余积分。

  • get_task

    轮询图片或视频任务直至完成。

常见问题

通过 MCP 使用会扣积分吗?+

会。MCP 只是连接层。图片、视频与聊天使用与 Studio 相同的钱包与价格。余额不足会返回错误。

该用哪把 API Key?+

使用个人中心 → API keys 的 sk-…。旧的 ora_live_… 仍可用,但新密钥是 sk-…。

在哪里获取 API Key?+

登录后到个人中心 → API keys。完整密钥只显示一次。把 sk-… 填入 MCP Authorization(或 Codex 的 ORAURIA_API_KEY)。

可以同时用 Cursor、Claude、Codex 吗?+

可以。同一把 sk-… 与 /api/mcp 端点适用于各客户端。若要分开限额,可在个人中心创建更多密钥。

用 Orauria 钱包连接你的聊天客户端

创建 sk- API Key,在 Cursor、Claude 或 Codex 中添加 MCP,然后让 Agent 干活。