文档中心
你需要的一切，仅此而已。
文档延续了代码库一贯的严谨：先讲契约，再看示例，最后是排障指南。每一个命令、事件和 MCP 工具都收录于此。
一分钟即可跑起来
一条命令完成安装。
# Install the CLI (optional)
$ pip install telepace-cli
# Or use the MCP directly in Claude Code
$ claude mcp add telepace https://mcp.telepace.io
# Create your first campaign
$ telepace campaigns create \
--title "Why do users abandon onboarding?" \
--goal "Understand the first-run friction" \
--channel web_text \
--target 25
✓ campaign_id: 4f2b…9c1
✓ share_url: https://telepace.io/r/4f2b9c1
✓ next_actions:
· dispatch invites via email
· watch progress: telepace campaigns progress 4f2b9c1快速开始
60 秒内
创建一项调研，分享链接，静待第一份回复到来。
15 分钟内
将 MCP 服务接入 Claude Code，让你的智能体自主完成调研工作。
一小时内
完成完整的生产部署——基于 Postgres 的事件存储、Redis 与 Fly.io。
核心概念
调研项目
一次调研的完整生命周期：草稿 → 已发布 → 已结束，附带不可篡改的事件历史。
访谈
单个受访者完成大纲的过程，支持文本、语音、电话或邮件形式。
洞察
从访谈记录中聚类出的主题，并附有代表性的原文引用。
执行框架
在命令与智能体之间进行策略校验的分发器。
集成
MCP
5 个有状态工具，兼容任意 MCP 宿主。
REST API
OpenAPI 架构文件位于 /openapi.json，采用 Bearer 鉴权。
Notion
将洞察单向推送至指定的数据库。
Linear
按主题分组，为每条洞察创建对应的问题（issue）。
Webhooks
覆盖我们 20 余种事件类型，均使用 HMAC 签名。
参考文档
命令结构定义
CreateCampaign、RefineOutline、StartCampaign……
事件结构定义
20 余种仅追加写入的事件类型，均带有 schema_version。
MCP 工具结构定义
每个工具对应的输入 / 输出 Pydantic 模型。