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

# 讓智能體為你配置密鑰

> 讓 Claude / Cursor / Warp 通過 MCP 服務器為你配置 Theo API 密鑰 —— 一次調用，無需手動搭建編排器。

你不必打開控制台、手動搭建編排器。在任何已連接 MCP 的 IDE 中(Claude Code、Cursor、Warp、Windsurf),智能體都可以通過一次工具調用,為特定場景創建並配置一個 Theo 密鑰 —— 結果會立即出現在你的 hitheo 控制台中,可直接查看或繼續擴展。

## 最快路徑:"只是寫代碼"

用自然語言向智能體提出請求:

```text theme={null}
Set up a Theo key I can use as my coding model in this IDE.
```

智能體會以 `use_case="coding"` 調用 [`theo_setup_key`](/mcp/tools#theo_setup_key)。Theo 會:

1. 創建一個新的 API 密鑰。
2. 將其固定綁定到一個強代碼引擎,作為**確定性直通**——不做意圖分類、不經過技能或護欄路由,每個請求都直接發往該編碼模型,毫無意外。
3. 返回原始密鑰(僅展示一次)以及控制台鏈接。

將該密鑰複製到你 IDE 的 Theo/OpenAI 兼容端點設置中即可完成。無需畫布,無需節點。

## 使用場景

| `use_case` | 作用 |
| - | - |
| `coding` | 固定綁定一個代碼引擎(確定性直通)。最適合作為 IDE 後端。 |
| `chat` | 固定綁定一個快速聊天引擎。 |
| `raw` | 固定綁定你指定的任意引擎(需提供 `model` 參數)。 |

可以傳入 `model` 來覆蓋任一場景的默認引擎,例如 `use_case="raw", model="anthropic/claude-opus-4.8"`。

## 按負載路由(或任意按模式拆分)

想讓輕量請求走快速引擎、繁重請求走推理引擎嗎?只需描述你的需求,智能體會傳入一個 `routing` 數組 —— Theo 的分類器會將每個請求劃分到某個模式,而該綁定會為該模式固定對應的引擎。無需搭建圖。

```text theme={null}
Set up a Theo coding key where light requests use Arca Velox and heavy ones use Arca Magnus.
```

智能體會調用 [`theo_setup_key`](/mcp/tools#theo_setup_key),參數如下:

```json theme={null}
{
  "routing": [
    { "mode": "fast",  "model": "arca-velox-5.1" },
    { "mode": "think", "model": "arca-magnus-5.1" }
  ]
}
```

模式包括:`fast`、`think`、`code`、`research`、`roast`、`genui`、`data_extraction`。引擎 id 包括 `arca-velox-5.1`、`arca-magnus-5.1`、`anthropic/claude-sonnet-4.6`、`anthropic/claude-opus-4.8`、`anthropic/claude-haiku-4.5`、`google/gemini-2.5-pro`、`openai/gpt-4.1`。

## 自定義邏輯 → 完整的圖

對於用戶用自然語言描述的任意分支/護欄邏輯,智能體可以傳入一個 `graph`(`{ enabled, nodes, edges }`)—— 一份完整的編排器圖,將被原樣應用。節點/邊的結構詳見[畫布圖結構](/guides/evi-canvas)。`graph` 的優先級高於 `routing` 和 `use_case`。

## 配置你已有的密鑰

```text theme={null}
Configure my existing key <uuid> for coding.
```

智能體會調用 [`theo_configure_key`](/mcp/tools#theo_configure_key)。預設相同,應用到你指定的密鑰上。

## 結果會回傳到控制台

兩個工具都會返回如下鏈接:

```text theme={null}
https://www.hitheo.ai/dashboard/orchestrator?key=<id>
```

打開它,編排器界面會直接定位到該密鑰,展示智能體所配置的全部內容。在此基礎上,你可以繼續疊加路由規則、技能、護欄或品牌設置 —— 可視化構建器和智能體操作的是同一份底層配置。

## 前置條件

* MCP 服務器必須使用具備 **`billing`** 權限範圍的密鑰完成身份驗證(創建密鑰所需)。參見[安裝](/mcp/install)。
* 新建的密鑰自帶 `completions`、`skills`、`tools` 權限範圍。

## 另請參閱

* [MCP 工具參考](/mcp/tools) —— `theo_setup_key` / `theo_configure_key` 的完整輸入結構。
* [編排器指南](/guides/orchestrator) —— 該鏈接會打開的控制台界面。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.