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

# IDE 集成

> 通过 MCP 在 Cursor、Claude Code、Warp、Windsurf 和 VS Code 中使用 Theo。

Theo 通过 **模型上下文协议（Model Context Protocol，MCP）** 在所有主流代理式 IDE 中运行。本指南是一屏概览——权威参考文档位于专门的 [MCP 服务器](/mcp/overview) 章节。

## 快速开始

```bash theme={null}
npm install -g @hitheo/sdk
export THEO_API_KEY=theo_sk_...
theo init
```

`theo init` 会自动检测你的 IDE 并写入正确的 MCP 配置。如需手写配置或了解各 IDE 的具体路径，请参阅 [MCP / Install](/mcp/install)。

## 可用工具

配置完成后，你的 IDE 代理即可访问以下工具：

| 工具 | 说明 |
| - | - |
| `theo_complete` | 通用 AI 补全——自动路由到最佳引擎 |
| `theo_code` | 代码生成——Theo Code 引擎，支持长篇输出 |
| `theo_research` | 带引用的深度研究 |
| `theo_image` | 图像生成——Theo Create 引擎 |
| `theo_document` | 文档生成（PDF、DOCX、PPTX、XLSX、CSV） |
| `theo_skill_list` | 浏览技能市场 |
| `theo_skill_install` | 安装特定领域的技能 |
| `theo_status` | 检查健康状态和引擎可用性 |

每个工具的完整模式和示例参见 [MCP / Tools](/mcp/tools)；三个 `theo://` 只读资源的说明参见 [MCP / Resources](/mcp/resources)。

## 后续步骤

* **[MCP 概览](/mcp/overview)** —— MCP 是什么，请求流程如何运作。
* **[安装](/mcp/install)** —— 各 IDE 的详细安装步骤。
* **[项目配置](/mcp/project-config)** —— 按仓库固定角色、技能或内联工具。
* **[故障排查](/mcp/troubleshooting)** —— 解决最常见的配置问题。


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