> ## 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.
# Theo 文档
> AI 编排 API——一次调用，覆盖所有模型，完整流水线。
认识 Theo——一个有个性的 AI 编排引擎。意图分类、多引擎路由、技能和工具执行，全部在一次 API 调用中完成。诞生于木星，为开发者而生。
## 开始使用
注册并在 30 秒内创建一个 API 密钥。
使用 curl 发起你的第一次 API 调用。
为 TypeScript 项目安装 @hitheo/sdk。
用 5 分钟构建一个可运行的示例。
## Explore
覆盖所有端点的 REST API 文档。
TypeScript SDK 的方法与类型。
构建并发布领域专业知识包。
通过自定义角色将 Theo 嵌入你的产品。
在 Cursor、Claude Code、Warp 等工具中使用 Theo。
@hitheo/mcp 服务器，及其 8 个工具和 3 个资源。
theo init、status、complete、skill publish。
## Set Up in Your IDE
First, set your API key as an environment variable:
```bash theme={null}
export THEO_API_KEY=theo_sk_...
```
Then pick your IDE:
Add to `.cursor/mcp.json` in your project root:
```json theme={null}
{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
```
Or run:
```bash theme={null}
theo mcp install --ide cursor
```
Run this in your terminal:
```bash theme={null}
claude mcp add theo npx -y @hitheo/mcp
```
Or run:
```bash theme={null}
theo mcp install --ide claude-code
```
Add to `.warp/mcp.json` in your project root:
```json theme={null}
{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
```
Or run:
```bash theme={null}
theo mcp install --ide warp
```
Add to `~/.codeium/windsurf/mcp_config.json`:
```json theme={null}
{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
```
Or run:
```bash theme={null}
theo mcp install --ide windsurf
```
Add to `.vscode/mcp.json` in your project root:
```json theme={null}
{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
```
Or run:
```bash theme={null}
theo mcp install --ide vscode
```
Auto-detect and configure all installed IDEs at once:
```bash theme={null}
npm install -g @hitheo/sdk
theo init
```
This detects Cursor, Claude Code, Warp, Windsurf, and VS Code, writes the correct config for each, and creates a `theo.config.json` for project-level settings.
Restart your IDE after adding the config.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.