创作者 MCP
把你自己的 AI 智能体连接到你的频道：覆盖每一种单集状态，草稿也包括在内。登录即可连接，或使用 API 密钥。
听众 MCP 服务的是听众的智能体：匿名、单个频道、只含已发布单集。创作者 MCP 则是这枚硬币的另一面：它服务的是你。它是平台顶级域上的一个端点，像你的 Studio 一样读取你所属的每一个频道：所有单集状态，草稿也包括在内。
https://podhood.com/mcp全平台只有一条规则：每个主机的 /mcp 就是它的 MCP。频道主机回答该频道的已发布内容；顶级域则回答已认证用户的内容。
连接之后，智能体看到的与你的 Studio 完全一致：你所属的每一个频道，包括草稿和未发布的剪辑。这样的完整访问范围正是它的价值所在，也是只把它交给你信任的智能体的原因。OAuth 连接会在你断开客户端时结束；API 密钥可以在 Studio → 设置 → API 密钥 中即时撤销。
通过登录连接（OAuth）
在 Claude、ChatGPT 或任何支持远程服务器的 MCP 客户端中，把 https://podhood.com/mcp 添加为连接器即可：不需要密钥，不需要配置。客户端会在第一次请求时发现 PodHood 的 OAuth 流程并打开浏览器窗口，你登录后批准访问（creator:read，即你的频道，含草稿）。授权按客户端分别进行；只要连接保持活跃，令牌会自动续期。
引导式的版本就在你的 Studio 里：Studio → MCP 提供按客户端划分的配置方案（Claude、ChatGPT、Claude Code、Cursor 等），连接器深层链接和配置块都已填好。
使用 API 密钥连接
对于通过文件配置的客户端，或者以 MCP 客户端身份运行的脚本，改用你的 API 密钥，放在 x-api-key 请求头中或作为 Bearer 令牌发送：
{
"mcpServers": {
"podhood": {
"type": "http",
"url": "https://podhood.com/mcp",
"headers": { "x-api-key": "podhood_…" }
}
}
}两种凭证解析为同一个身份、遵循同一套规则，选客户端支持的那种即可。传输方式是远程 Streamable HTTP，与听众服务器完全相同：不是本地 stdio 命令，也不是旧式 SSE。
五个工具
| 工具 | 返回内容 |
|---|---|
list_channels | 你的连接可读取的频道，附带 slug 和每个频道的 apiAccess 判定 |
list_episodes | 频道目录的一页，包含所有状态；每一行都带有 mediaUrl，可用于构造来源深层链接 |
search | Studio 的混合搜索，含草稿，返回带时间戳的原文片段 |
get_chapters | 章节及其分类的关键时刻，标题都是自成一体、可引用的论断 |
get_transcript | 标注发言人、带时间戳的片段，按 startMs/endMs 截取窗口 |
响应体积在设计上就有上限：list_episodes 分页返回，get_transcript 每次调用最多 200 个片段。读取长单集时，请把 get_chapters 返回的某个章节的 startMs/endMs 传进去，一次读一章。智能体靠逐步收窄来深挖，而不是把几兆字节一股脑塞进上下文。
典型会话
list_channels：获取 slug，跳过标记为apiAccess: false的频道（该频道所有者使用的是 Free 套餐）。- 用 slug 调用
list_episodes：挑一个单集，记下它的id和mediaUrl。 get_chapters：拿到编辑骨架，每个关键时刻的标题都是现成的引言。- 用某一章的时间窗口调用
get_transcript：获得逐字、标注发言人的原文引用。 - 组装输出：引文 + 发言人 + 来源深层链接（
mediaUrl+&t=<seconds>s）。
每次调用都遵循与 REST API 相同的成员资格与套餐规则：两种传输方式共用同一个授权核心，永远不会出现不一致。拒绝访问时会以可读的工具错误返回，而不是传输层故障。