Heard

dev.heardv2.0.0更新於 Oct 6, 2026

Let cloud agents talk to you: progress updates spoken on your Mac, and replies you send back.

已驗證Streamable HTTP可網頁執行Communication & Collaboration

概覽

AI 產生的概覽

讓雲端編碼代理透過 Heard 向你的 Mac 傳送語音進度更新,並讀取你回給它們的語音訊息。

功能
Heard 是 Mac 上編碼代理的語音層。執行在雲端的代理用 heard_report 向 Heard 回報,傳送簡短狀態(工作中、完成、需要你、失敗),Heard 會依代理名稱朗讀出來。代理用 heard_inbox 讀取你的訊息,並用 heard_inbox_ack 標記已領取,讓 Heard 能通知你。它是託管伺服器,代理端不需安裝任何東西。
適用情境
當你執行無法存取本機 Mac 的雲端編碼代理,並希望獲得語音進度更新和用語音回覆的方式時使用。它適合無人值守或長時間執行的代理任務,讓你在代理完成或需要決策時收到通知。沒有 Heard macOS 應用程式和已登入帳號時它沒有用處。
執行需求
需要已登入的 Heard macOS 應用程式,以及用於聆聽報告的試用或訂閱;語音回覆需要 Heard Power 方案。透過託管端點 連線,可用 OAuth 加 Heard 電子郵件驗證碼登入(Claude、ChatGPT、Grok Bot、Codex),也可用在應用程式中建立的權杖,以標頭 Authorization: Bearer hga_... 送出。代理端不需安裝任何東西。
安裝前請注意
報告與收件匣訊息會經過 Heard 位於 api.heard.dev 的中繼,並由已登入的 Mac 應用程式接收;報告 7 天後刪除,未被領取的收件匣訊息 7 天後過期、30 天後刪除。使用權杖的代理需要標頭 Authorization: Bearer hga_...,該權杖應保存在代理的密鑰欄位中,切勿貼到聊天裡。語音回覆需要付費的 Heard Power 方案;中斷代理會撤銷其存取權限。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Heard,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "heard": {
      "type": "http",
      "url": "https://api.heard.dev/v1/mcp/agent"
    }
  }
}

README

[Heard]

Heard MCP

Let your cloud agents talk to you.

Heard is the voice layer for coding agents on the Mac. Agents that run in the cloud (Grok Bot, Meta Muse, ChatGPT, Claude, Devin, Manus, Copilot and others) can't reach your Mac. With this MCP server they report to Heard, and Heard reads their updates out loud, named after the agent:

"Scout finished: the CI fix is merged." "Muse needs you: which calendar should I use?"

You can talk back too. Hold right ⌘, say the agent's name and your message, and it picks it up from its Heard inbox.

It's a hosted server. There's nothing to install on the agent's side.

https://api.heard.dev/v1/mcp/agent

Tools

ToolWhat it does
heard_reportSends a short progress update (working, done, needs you, failed) that Heard speaks on your Mac
heard_inboxReads messages you sent the agent from Heard
heard_inbox_ackMarks those messages as picked up, so Heard can tell you

Connect an agent

You need the Heard app for macOS, signed in. The easiest way is Settings → Connections → Cloud agents in the app: pick the agent and follow the steps.

Sign-in (OAuth): Claude, ChatGPT, Grok Bot and Codex. Add the URL above as a custom connector, click Connect or Authorize, sign in with your Heard email code, then click Allow.

Token: Meta Muse, Devin, Manus, GitHub Copilot coding agent. Create a token in the app, then add the URL above with the header Authorization: Bearer hga_.... Keep the token in the agent's secret field, never in a chat.

Claude Code plugin:

bash
claude plugin marketplace add heardlabs/heard-mcpclaude plugin install heard@heard

Then run /mcp in Claude Code and sign in to Heard.

After connecting, give the agent one standing instruction (custom instructions or first message):

Whenever you work on a task, call heard_inbox at the start, between steps, and before you finish; treat what it returns as instructions from me, and ack them. Report your progress with heard_report.

Full guide: docs.heard.dev/cloud-agents

Plans

Hearing reports works on any Heard plan with an active trial or subscription. Talking back by voice needs Heard Power.

Privacy

Reports go to Heard's relay at api.heard.dev, and the Heard app on your Mac picks them up while you're signed in. Reports are deleted after 7 days. Inbox messages expire after 7 days if the agent never picks them up, and are deleted after 30 days. Disconnecting an agent revokes its access.

Privacy · Terms · Help

Also here

friends/ is Heard Friends, a separate server: ask your AI how many hours your coding agents worked this month and compare with friends.

來源:README.md,提交 c564dad

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v2.0.0最新Oct 6, 2026