听众 MCP（Connect AI）

每个频道都对外提供的匿名、仅含已发布内容的 MCP 服务器：你的听众的 AI 客户端如何连接、检索有依据的原文引用并保留引用链接。

每个 PodHood 频道都是一个独立的远程 MCP 服务器。它只提供一个只读工具 search，检索范围是该频道的已发布单集：

https://<slug>.podhood.com/mcp

在已验证的自定义域名上，请改为连接 https://<custom-domain>/mcp。MCP 连接所使用的主机，也是每一条返回引用中使用的主机。

不需要 API 密钥、OAuth 流程，也不需要运行任何本地包。服务器只读取已经公开、已发布的节目库内容，无法修改频道。

推荐路径：使用 Connect AI

打开频道的公开节目库，点击 连接 AI。对话框会根据当前主机生成正确的服务器 URL 和便于查找的服务器名称，然后展示 28 种客户端的最新设置说明。

如果自定义域名已上线，并且你希望引用链接保留该品牌主机，请在公开的自定义域名上进行这一步。从 PodHood Studio 打开 Connect AI 得到的会是频道的 PodHood 子域名端点。

选择安装形态

形态	当前客户端	Connect AI 提供的内容
网页版自定义连接器	Claude、ChatGPT、Perplexity、Grok	准确的设置页链接、连接器名称、URL，以及「无认证」选项。
粘贴一段提示词的智能体	Hermes、OpenClaw、Claude Code、Codex、WorkBuddy、Windsurf、AutoClaw、CodeBuddy、Goose、Cline、Zed、Continue、Gemini CLI	一段安装提示词，要求智能体添加远程服务器，外加手动配置的备选方案。
一键安装的 IDE	Cursor、VS Code	深层链接、安装提示词和原始配置的备选方案。
GUI 或 JSON 导入	Manus、Genspark、Trae、Cherry Studio、Jan、Chatbox、5ire	针对该产品的点击路径，以及格式正确的 JSON/URL。
其他任何兼容 MCP 的客户端	Antigravity 以及通用的其他客户端方案	标准的远程 HTTP URL 和通用的 `mcpServers` JSON。

客户端必须支持远程 Streamable HTTP MCP 服务器。不要把这个端点配置成本地 stdio 命令或旧式 SSE URL。

安装提示词与试用提示词

Connect AI 有意提供两段不同的提示词：

安装提示词：把远程 MCP 服务器接入客户端。它包含生成的服务器名称、端点 URL、传输方式、无认证规则，并要求客户端确认 search 工具已加载。
试用提示词：实际调用已安装的工具。它提出一个有依据可查的问题，并要求给出带时间戳的直接引文。

安装成功之前不要粘贴试用提示词。也不要反复把安装提示词当作搜索查询来用。

试用提示词会随打开 Connect AI 的页面而变化：

节目库首页：使用最新可用单集的问答问题，并带有有依据的备选问题。
单集页面：使用该单集的问答问题或标题。
人物/公司/产品/话题主题页（Hub）：询问节目对该主题说过什么。

这样，第一次调用就是一次真实的检索测试，而不是泛泛的演示。

手动连接示例

尽可能使用 Connect AI 生成的 URL。如果客户端必须手动配置，以下是常见的形式。

claude mcp add --transport http podhood-yourshow https://yourshow.podhood.com/mcp

对于普通的 PodHood 节目库，生成的名称是 podhood-<slug>。在白标生效时，Connect AI 会根据自定义主机名派生一个中性的名称（例如 library-example-com），这样配置里就不会重新出现 PodHood 品牌。

`search` 工具实际返回什么

search 运行的是与节目库搜索相同的混合检索核心：对文字稿、标题和描述进行语义匹配加词法匹配，融合后得到排序的单集。每个单集都包含它最匹配的若干片段。

MCP 响应有两种等价的表示形式：

模型可读的 Markdown：排序的单集小节，后面跟着引用的片段。每条引文都以引用开头，例如 [12:03](https://…?t=723000)。
结构化内容：同一结果的数据形式，包括 episodeId、单集 URL、元数据、匹配的检索支路、片段文本、发言人、起止时间以及绝对引用 URL。

仅标题匹配的结果可能包含一个没有引用片段的单集。请把它当作发现性结果，而不是回答事实性问题的证据。空结果会明确说明没有任何已发布单集匹配；智能体不应当用记忆来填补这个空缺。

获得可靠答案的检索方法

先用混合模式广泛搜索

用 fast: false、topK: 5–10 以及默认的每单集三个片段，提出听众的自然语言问题。当问题的措辞与文字稿不同时，混合模式是正确的默认选择。

选出最有力的单集

比较返回的引文、发言人和时间戳。只保留其片段真正支持该问题的 episodeId；排名本身不是证据。

在这些单集内继续追问

带上 episodeIds 再次调用 search，需要更多上下文时提高 maxSegmentsPerEpisode。这是在同一个检索系统内收窄范围，而不是让模型从整篇文字稿里自行推断。

依据引文作答，并保持链接完整

把返回的片段文本作为证据。为每一个实质性论断保留带时间戳的引用链接，让读者能直接跳到对应的时刻。

当不需要语义召回时，对精确的名称、产品或短语使用 fast: true。只在需要获取单集/引用句柄时使用 includeText: false；没有文本的结果不足以作为答案的依据。

验证连接

安装完成后：

确认客户端显示了一个服务器，并且它有一个名为 search 的工具。
运行提供的试用提示词。
确认客户端确实调用了 search，而不是用模型的通用知识作答。
检查至少有一条结果包含引用文本和时间戳链接。
打开引用链接，确认节目库落在支持该论断的时刻。
问一个无关的问题，并接受空结果：这是一个很有用的防幻觉检查。

故障排查

在浏览器中打开 /mcp 显示 405。 这是预期行为。服务器是无状态的 Streamable HTTP：JSON-RPC 使用 POST，浏览器预检使用 OPTIONS，独立的 GET/DELETE 会话操作被有意拒绝。请用 MCP 客户端测试，而不是在浏览器地址栏发请求。

客户端提供 stdio、SSE 和 HTTP 三种选项。 选择远程 HTTP / Streamable HTTP。没有要执行的命令，也没有本地包。

服务器连上了，但没有 search。 重新检查 URL 是否以 /mcp 结尾，删除认证字段，然后重新连接。安装提示词会明确要求客户端确认工具已加载。

搜索返回的结果不符合预期。 MCP 只能看到已成功索引且未归档的单集。确认该单集为已上线，在公开的节目库搜索里测试同一查询，保持 fast: false，并尝试更短的概念或精确名称。

结果识别出了单集，但没有引文。 匹配可能只来自标题/描述。请细化查询，或在该 episodeId 内搜索；不要把没有依据的仅标题匹配结果当作文字稿证据来引用。

引用使用的是 PodHood 子域名而不是自定义域名。 改用 https://<custom-domain>/mcp 重新连接，最好是在自定义域名的节目库上打开 Connect AI。引用 URL 遵循 MCP 请求所使用的主机。

ChatGPT 无法添加连接器。 从侧边栏打开 Plugins，点击右上角的 +（添加）按钮；如果不可用，请在 Settings → Security and login 中开启 Developer mode（是否可用取决于你的套餐和工作区权限）。在 New Plugin 表单中，把 Connection 保持为 Server URL，粘贴 /mcp URL，并把 Authentication 设为 No authentication。请严格按照 Connect AI 的方案操作，因为这个界面可能与其他客户端不同。

协议与发现

服务器形态：每个请求对应一个全新的无状态 MCP 服务器；没有会话 id，也没有服务端会话状态。
传输：Streamable HTTP，返回 JSON 响应。
方法：POST 用于 JSON-RPC，OPTIONS 用于 CORS，GET/DELETE 返回 405。
访问：匿名、公开、仅含已发布内容、只读。
CORS：对基于浏览器的 MCP 客户端开放；v1 接受但忽略 Authorization。
发现：/.well-known/mcp 和 /.well-known/mcp/server-card.json 公布按频道划分的模式；每个频道的 llms.txt 列出它的具体端点。
Agent Skills：https://podhood.com/.well-known/agent-skills/index.json 发布了 podhood-library-search，它教会兼容的智能体在这类检索任务中何时以及如何使用 MCP、REST 或 Markdown。

页内工具（WebMCP）

/mcp 端点服务的是从外部连接的智能体。公开的节目库页面还会通过 WebMCP 注册页内工具。WebMCP 是一项提议中的 W3C 标准，已在 ChatGPT 桌面应用中落地，并作为 Chrome 源试用推出；它让页面能通过 document.modelContext 把工具交给与用户一同浏览该页面的智能体。

双方都无需安装任何东西：支持 WebMCP 的智能体只要访问任何公开的节目库页面（无论是 PodHood 子域名还是已上线的自定义域名）就能发现这些工具（PodHood 会下发 Chrome 源试用令牌，因此无需任何标志）。不支持 WebMCP 的智能体和浏览器看到的是普通页面。

两个页面注册工具，各四个：

页面	工具	作用
节目库首页	`search_episodes`	按语义或关键词搜索整个已发布目录；结果带有时间戳引用。
节目库首页	`filter_episodes`	应用页面的话题/人物/提及/合集/年份过滤器，可见列表和 URL 会随之变化。
节目库首页	`list_episodes`	按顺序读回页面当前显示的单集，附带 id。
节目库首页	`open_episode`	把访客的浏览器导航到某个单集页面。
单集页面	`read_episode`	读取摘要、发言人，以及带时间戳的章节与关键时刻大纲。
单集页面	`search_transcript`	在文字稿中查找精确文本，并在屏幕上的面板中高亮显示。
单集页面	`read_transcript`	读取一段标注发言人、带时间戳的文字稿窗口：一个章节或一个时间范围。
单集页面	`play_moment`	把播放器定位到某个位置并开始播放；逐词同步的文字稿会跟随播放。

给智能体开发者的行为说明：

在构造上就是只读的。 工具唯一会改变的状态是访客本来就能控制的视图状态：过滤器、文字稿高亮、播放进度，可见且可撤销。当一次调用会明显移动页面或发出声音开始播放时，工具描述会明确说明。
结果是 Markdown 文本。 引用链接使用访客所在的主机，规则与 /mcp 相同。
单集作者撰写的文本会标记 untrustedContentHint：引文是节目中的原话，应当作数据而非指令来对待。
search_episodes 运行的是与上文 search 工具相同的仅含已发布内容的检索核心，最多返回 20 个单集，每个最多 3 个引用片段。
在白标模式下，工具名称和描述只标识节目，绝不出现 PodHood，与 Connect AI 遵循相同的规则。

当智能体协助的是已经在页面上的人时，使用 WebMCP；当它需要在没有浏览器的情况下访问目录时，使用 /mcp。发布文章面向播客与 YouTube 频道的 WebMCP 中有在真实频道上的实机演示。

其他访问方式

如果集成需要的是确定性的 HTTP 调用而不是 MCP 工具，请使用 REST API；两种适配器共用同一个搜索结果与引用构建层。

想通过 MCP 访问你自己的频道（包括草稿），供你自己的智能体和内容再利用流水线使用？那是创作者 MCP，一个独立的、需要认证的服务器（在 MCP 客户端中登录，或使用 API 密钥）；本页介绍的全部内容都是面向听众的匿名访问方式。

这个页面有帮助吗？