> ## 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——一次調用，覆蓋所有模型，完整流水線。

<Card title="什麼是 Theo？" icon="info" href="/introduction/what-is-theo">
  認識 Theo——一個有個性的 AI 編排引擎。意圖分類、多引擎路由、技能和工具執行，全部在一次 API 調用中完成。誕生於木星，為開發者而生。
</Card>

## 開始使用

<CardGroup cols={2}>
  <Card title="獲取你的 API 密鑰" icon="key" href="/quickstart/get-api-key">
    註冊並在 30 秒內創建一個 API 密鑰。
  </Card>

  <Card title="第一次補全請求" icon="terminal" href="/quickstart/first-completion">
    使用 curl 發起你的第一次 API 調用。
  </Card>

  <Card title="安裝 SDK" icon="package" href="/quickstart/install-sdk">
    為 TypeScript 項目安裝 @hitheo/sdk。
  </Card>

  <Card title="你好，世界" icon="code" href="/quickstart/hello-world">
    用 5 分鐘構建一個可運行的示例。
  </Card>
</CardGroup>

## Explore

<CardGroup cols={3}>
  <Card title="API 參考總覽" icon="book" href="/api-reference/overview">
    覆蓋所有端點的 REST API 文檔。
  </Card>

  <Card title="安裝與設置" icon="box" href="/sdk-reference/installation">
    TypeScript SDK 的方法與類型。
  </Card>

  <Card title="什麼是技能？" icon="puzzle" href="/skills/overview">
    構建併發布領域專業知識包。
  </Card>

  <Card title="構建 E.V.I." icon="bot" href="/guides/build-an-evi">
    通過自定義角色將 Theo 嵌入你的產品。
  </Card>

  <Card title="IDE 集成" icon="laptop" href="/guides/ide-integration">
    在 Cursor、Claude Code、Warp 等工具中使用 Theo。
  </Card>

  <Card title="MCP 服務器概覽" icon="plug" href="/mcp/overview">
    @hitheo/mcp 服務器，及其 8 個工具和 3 個資源。
  </Card>

  <Card title="CLI 概覽" icon="terminal" href="/cli-reference/overview">
    theo init、status、complete、skill publish。
  </Card>
</CardGroup>

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

<Tabs>
  <Tab title="Cursor">
    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
    ```
  </Tab>

  <Tab title="Claude Code">
    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
    ```
  </Tab>

  <Tab title="Warp">
    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
    ```
  </Tab>

  <Tab title="Windsurf">
    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
    ```
  </Tab>

  <Tab title="VS Code">
    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
    ```
  </Tab>

  <Tab title="All IDEs">
    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.
  </Tab>
</Tabs>

Restart your IDE after adding the config.


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