ActivitySmith MCP

官方

發送推播通知與即時動態到您配對的 iOS 裝置。

你可以用 ActivitySmith MCP 做什麼?

  • 傳送推播通知 — 請您的助理將 send_push_notification 傳送至您的 iPhone 或 iPad,並可搭配選用動作、媒體與頻道指定。
  • 管理即時動態 — 使用 set_live_activity_stream 在鎖定畫面上啟動或更新即時進度,完成後再以 end_live_activity_stream 結束。
  • 請求遠端核准 — 讓您的代理程式針對購買或部署等動作呼叫 request_approval,並在您的裝置上接收接受或拒絕的決定。
  • 更新鎖定畫面小工具 — 使用 create_widget_metric 建立小工具指標,並透過 set_widget_metric_value 更新其數值。
  • 設定 App 圖示標記數 — 使用 update_app_icon_badge_count 設定或清除已配對裝置上的標記數字。
  • 檢視通知紀錄 — 使用 list_push_notifications 查詢過去的推播,或透過 list_live_activities 檢查即時動態狀態。

文件

為 AI 模型與代理程式提供直達 iPhone 的管道

伺服器 URL

https://mcp.activitysmith.com/mcp

協定

modelcontextprotocol.io

總覽

將官方 ActivitySmith MCP 伺服器連接到 Claude Code、Cursor、Codex、Grok,或任何其他支援遠端 MCP 伺服器的用戶端。完成 OAuth 授權後,您的代理程式即可傳送遠端核准與 推播通知,同時透過 iPhone 與 iPad 上的 即時活動 顯示即時更新。

遠端核准,端到端處理

為需要您核准的動作設定常駐規則,例如進行任何購買、部署至正式環境、公開發布、傳送外部電子郵件或刪除資料。當代理程式到達該界限時,ActivitySmith 會儲存其請求,並透過即時活動或推播通知傳送兩個標示清楚的動作選項。

當您選擇某個動作時,等待中的代理程式會立即收到決定。待處理的請求最多保留 30 分鐘,讓您即使暫時離開也有時間回應。

了解 AI 代理程式的遠端核准如何運作

代理程式可執行的事項

推播通知

傳送推播通知至您已配對的裝置。

即時活動

在鎖定畫面上顯示即時業務指標、營運狀態或進行中的工作。

遠端核准

傳送可從 iPhone 接受或拒絕的遠端核准。

鎖定畫面小工具

更新鎖定畫面小工具中顯示的值。

App 圖像標記數

在已配對的裝置上設定或清除 App 圖像標記數。

歷史記錄

檢閱推播通知與即時活動的歷史記錄。

AI agent task progress Live Activity on the iPhone Lock Screen, updated over MCP

iPhone 鎖定畫面上的 AI 代理程式任務進度即時活動,透過 MCP 更新

設定說明

伺服器 URL 在所有用戶端中皆相同。在瀏覽器中核准 OAuth 畫面,即可在新工作階段中使用 ActivitySmith 工具。

Claude Code

1. 註冊 ActivitySmith MCP 伺服器

開啟終端機並執行此命令。使用者範圍可讓 ActivitySmith 在 Claude Code 中跨所有專案使用。

claude mcp add --transport http --scope user activitysmith https://mcp.activitysmith.com/mcp

2. 開啟 MCP 選單

啟動新的 Claude Code 工作階段,然後在工作階段內執行此命令並選取 activitysmith

/mcp

3. 核准存取

在 Claude Code 中,選取「驗證」以開啟授權頁面。如有提示請登入,檢閱要求的存取權限,然後按一下「核准」。

4. 準備就緒

返回 Claude Code。ActivitySmith 工具現在可在您跨所有專案的工作階段中使用。

Cursor

在 Cursor 中安裝,一鍵完成。若您偏好手動設定,請將伺服器新增至 ~/.cursor/mcp.json

{  "mcpServers": {    "activitysmith": {      "url": "https://mcp.activitysmith.com/mcp"    }  }}

Cursor 會在首次使用伺服器時提示您登入。

Codex

codex mcp add activitysmith --url https://mcp.activitysmith.com/mcp

然後進行驗證:

codex mcp login activitysmith

Grok

在 Grok 中,開啟 Connectors,選取「New Connector」,然後選取「Custom」並輸入伺服器 URL:

https://mcp.activitysmith.com/mcp

在彈出視窗中完成 OAuth 流程。如果 Safari 封鎖該視窗,請允許 grok.com 的彈出視窗,然後重試。

若為 Grok Build,請從終端機新增伺服器:

grok mcp add --transport http activitysmith https://mcp.activitysmith.com/mcp

其他 MCP 用戶端

對於任何要求遠端 MCP 伺服器 URL 的用戶端,請使用 https://mcp.activitysmith.com/mcp。授權流程在 ActivitySmith 中進行。核准後,工具會針對您授權的帳戶執行。

工具

伺服器公開下列 MCP 工具,依資源分組。我們建議在用戶端中保持工具確認功能啟用,並在將伺服器與其他 MCP 伺服器結合時謹慎操作,以降低提示注入的風險。API 金鑰管理仍保留在 ActivitySmith 網頁應用程式中,不會公開給 MCP 用戶端。

資源工具說明
核准request_approval傳送可操作的核准請求,可選擇動作專屬的按鈕標籤,然後等待決定。
wait_for_approval繼續等待待處理的核准,並在使用者決定時立即喚醒。
get_approval取得核准請求的目前狀態,不需等待。
cancel_approval取消不再需要的待處理核准請求。
request_approval_task在支援 MCP Tasks 的 MCP 用戶端中建立持久性核准任務。
推播通知send_push_notification傳送推播通知,可選擇動作、媒體與頻道指定。
list_push_notifications列出帳戶的推播通知歷史記錄。
get_push_notification依公開 ID 取得單一推播通知。
App 圖像標記數update_app_icon_badge_count設定或清除 App 圖像標記數,可選擇頻道指定。
即時活動set_live_activity_stream啟動或更新受管理的即時活動串流。
pause_live_activity_stream暫停串流並結束其目前的即時活動。
resume_live_activity_stream恢復已暫停的串流,使更新再次套用。
end_live_activity_stream結束目前的即時活動並移除串流金鑰。
list_live_activities列出帳戶的即時活動。
標籤list_tags列出帳戶範圍的標籤及其在推播通知與即時活動中的使用情況。
鎖定畫面小工具create_widget_metric建立小工具指標定義。
set_widget_metric_value設定小工具指標的最新值。
update_widget_metric更新小工具指標定義。
list_widget_metrics列出帳戶的小工具指標。
delete_widget_metric刪除小工具指標。
頻道create_channel建立頻道以指定推播通知與即時活動的目標。
get_channel取得單一頻道及其指派的使用者與裝置。
list_channels列出帳戶的頻道。
update_channel更新頻道別名。
set_channel_users取代頻道的使用者成員資格。
set_channel_devices取代頻道的明確裝置指派。
delete_channel刪除頻道。
使用者與裝置list_account_users列出帳戶中的使用者以供頻道指派。
list_account_devices列出有效裝置以供明確頻道指派。