程式化訪問與自動化

概述

不使用介面來使用 Whisperer 有三種方式：面向 AI 客戶端的 MCP 伺服器、用於日常自動化的已連線服務，以及把內容遷往別處的匯出。Whisperer 不提供通用的公開 REST API——/v1/ 下的地址是我們自家應用與後端之間的私有通道，不作相容性承諾，隨時可能變更。

這是有意劃定的邊界，而不是遺漏。已公開的 API 必須多年可用；MCP 提供同樣的訪問能力，並且自帶版本協商、同意頁面和權限撤銷。

使用場景

  • 想讓 AI 助手讀取會議並處理任務——用 MCP。
  • 想要一個重複動作（「新會議 → 表格裡加一行」）——用 Zapier。
  • 想把內容本身放進別的工具——用匯出。

操作步驟

  1. AI 客戶端透過 MCP 連線：MCP：連線 Claude、ChatGPT 和 Cursor。這是受支援的程式化途徑，也是唯一享有穩定性承諾的途徑。
  2. 自動化：在帳戶中連線 Zapier、Notion、Slack 或 HubSpot，然後在該服務裡搭建流程。
  3. 一次性遷移：在會議頁面匯出為 Markdown、SRT、VTT 或 JSON。
  4. 需要機器可讀的產品資訊時——例如想讓 AI 助手回答關於 Whisperer 本身的問題——把它指向 https://whisperer.one/llms.txt 或完整語料 https://whisperer.one/llms-full.txt。兩者均為公開，無需認證。

公開的內容

地址 是什麼
https://whisperer.one/mcp 面向外部 AI 客戶端的 MCP 伺服器
https://whisperer.one/.well-known/oauth-protected-resource 客戶端從這裡得知如何認證
https://whisperer.one/.well-known/oauth-authorization-server OAuth 端點與支援的權限範圍
https://whisperer.one/llms.txt 面向 AI 系統的產品索引
https://whisperer.one/llms-full.txt 全部公開文件匯於一個檔案
https://whisperer.one/docs/en/<頁面>.md 任意英文文件頁面的純 Markdown 版本

常見錯誤

  • 基於 /v1/ 開發。 這些地址屬於內部：對爬蟲關閉，生產環境關閉了 schema，且會在不預告的情況下變更。
  • 尋找 API 金鑰。 沒有，因為沒有公開的 REST API。外部訪問使用的是經 MCP 同意流程簽發的 bearer 令牌。
  • 期待 Webhook。 出站自動化透過 Zapier 和已連線服務完成，我們不提供自有 Webhook。

最佳實踐

  • 從後設資料文件讀取 OAuth 端點，而不要寫死在程式碼裡：它們公開在那裡，正是為了能夠遷移而不破壞客戶端。
  • 每個整合單獨建立一個連線，撤銷其中一個不會影響其他。

相關文章