Cursor · Claude · Codex

Kết nối Orauriavới chat client của bạn

Tạo API key sk-, thêm Orauria làm MCP server, rồi chat với Cursor, Claude hoặc Codex — tool ảnh, video và LLM trừ ví Orauria.

  • Chạy trên Cursor, Claude Code / Desktop và Codex
  • Xác thực bằng API key sk- từ trang Tài khoản
  • Giá như Studio — trừ credit ví Orauria

Bấm Thêm vào Cursor, rồi thay sk-YOUR_ORAURIA_API_KEY trong header Authorization bằng key ở trang Tài khoản.

Cursor · Claude · Codex

Bạn

Kiểm tra số dư credit, rồi gen poster sản phẩm ánh sáng ban ngày.

MCP tools

get_wallet → generate_image

Kết quả

Đủ số dư · URL ảnh sẵn · đã trừ ví

Bạn làm việc trong chat client. Orauria chạy tool và trừ credit.

Cursor · Claude · Codex

Cách kết nối

Ba bước từ API key đến chat trong agent.

  1. 01

    Tạo API key

    Vào Tài khoản → API keys, tạo key, copy sk-… Key chỉ hiện một lần.

  2. 02

    Thêm MCP vào client

    Kết nối Cursor, Claude hoặc Codex bằng config bên dưới.

  3. 03

    Chat và gọi tool

    Bảo agent chat, gen hoặc kiểm tra ví. Credit trừ từ số dư Orauria.

Bạn làm được gì

Cùng khả năng Studio, gọi từ chat client local qua MCP.

  • Gen ảnh

    Prompt model từ agent. Giá theo Studio.

  • Gen video

    Tạo job video, đợi xong, mở URL kết quả.

  • Chat LLM

    Dùng model chat Orauria qua MCP. Trừ theo token.

Kết nối theo client

Chọn Cursor, Claude hoặc Codex — cùng một API key sk-.

Cursor

Cài một click, hoặc dán JSON vào MCP settings.

Thêm vào Cursor
  1. 1

    Tạo API key Orauria

    Đăng nhập, mở Tài khoản → API keys, tạo key, copy sk-… Giữ key riêng.

  2. 2

    Mở MCP settings Cursor

    Cursor Settings → MCP. Dùng Thêm vào Cursor trên trang này, hoặc tạo .cursor/mcp.json.

  3. 3

    Thay key placeholder

    Điền sk-… thật vào header Authorization Bearer. URL là site hiện tại cộng /api/mcp.

  4. 4

    Refresh MCP và thử prompt

    Bật server orauria, rồi hỏi agent list models hoặc gen ảnh.

Config MCP Cursor

.cursor/mcp.json

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

Claude

Claude Code qua .claude.json, hoặc Claude Desktop qua mcp-remote.

  1. 1

    Tạo API key Orauria

    Copy sk-… từ Tài khoản → API keys.

  2. 2

    Claude Code

    Gộp entry HTTP MCP vào ~/.claude.json (hoặc config project), rồi restart Claude Code.

  3. 3

    Claude Desktop

    Dùng lệnh mcp-remote làm cầu stdio với Bearer sk-…, rồi restart Claude Desktop.

Config 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

Cấu hình model_providers trong ~/.codex/config.toml (OpenAI Responses API) — ưu tiên hơn MCP.

  1. 1

    Tạo API key Orauria

    Copy sk-… từ Tài khoản → API keys (có số dư ví).

  2. 2

    Sửa ~/.codex/config.toml

    Đặt model_provider = orauria và base_url = {site}/api/v1 với wire_api = responses.

  3. 3

    Dán sk- vào experimental_bearer_token

    Thay sk-YOUR_ORAURIA_API_KEY bằng key thật. Local: http://localhost:3000/api/v1

  4. 4

    Chạy Codex và thử

    Codex gọi /responses qua Orauria — trừ ví khi có usage.

Codex config.toml (khuyến nghị)

~/.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

Biến môi trường Codex

.zshrc / .bashrc

export ORAURIA_API_KEY='sk-YOUR_ORAURIA_API_KEY'

Thay sk-YOUR_ORAURIA_API_KEY bằng key sk-… từ trang Tài khoản. Key nằm trong config client local — Orauria không yêu cầu dán key lên trang này.

Tool agent có thể gọi

Mỗi lần gọi dùng API key của bạn và trừ đúng giá Studio.

  • generate_image

    Tạo ảnh từ prompt và model. Trả URL kết quả.

  • generate_video

    Bắt đầu job video. Poll đến khi có URL.

  • chat

    Chat với LLM Orauria. Trừ theo token.

  • list_models

    Xem model ảnh, video và chat đang mở.

  • get_wallet

    Kiểm tra credit còn lại trước khi gen.

  • get_task

    Poll job ảnh hoặc video đến khi xong.

FAQ

Dùng MCP có trừ credit không?+

Có. MCP chỉ là cổng kết nối. Ảnh, video và chat dùng cùng ví và giá Studio. Thiếu credit thì gọi lỗi.

Dùng API key nào?+

Dùng key sk-… từ Tài khoản → API keys. Key legacy ora_live_… vẫn chạy, nhưng key mới là sk-…

Lấy API key ở đâu?+

Tài khoản → API keys sau khi đăng nhập. Key đầy đủ chỉ hiện một lần. Dán sk-… vào header Authorization MCP (hoặc ORAURIA_API_KEY cho Codex).

Dùng chung Cursor, Claude và Codex được không?+

Được. Cùng key sk-… và endpoint /api/mcp. Tạo thêm key trong Tài khoản nếu muốn hạn mức riêng.

Kết nối chat client với ví Orauria của bạn

Tạo API key sk-, thêm MCP trong Cursor, Claude hoặc Codex, rồi bảo agent làm việc.