> ## 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.