用 Claude Code、Codex、Cursor 自動記錄工作（MCP）| Perfly

實際用起來長這樣

一段工作結束，你打一句：

你：把今天的工作送到 Perfly

Agent： 這是我準備幫你記錄的 10/1 工作：

修好 webhook worker 的重試風暴（branch:fix/webhook-backoff）

Review 並合併了 rate limit middleware 的 PR（issue:API-412）

一起處理 Postgres index migration

要送出這 3 項嗎？

你：好，第三項拿掉

那兩項會出現在 Perfly 的 Today 頁面，而且會放在獨立的區塊，你一眼就看得出哪些是 Agent 送來的。你像確認一般筆記一樣確認它們，之後它們就會進到你的週報。

為什麼要這樣做？

今天做了什麼，你的 Agent 看得比你週五回想起來的還清楚。它知道 branch 名稱、commit 標題、issue 編號。少了它，「我這週到底做了什麼？」就會變成一小時的 git log 考古。

Perfly 會把這些摘要整理成週報，幾個月後再變成你的績效自評和履歷條目。細節由 Agent 記著，你要做的只是決定哪些留、哪些刪。

會送出什麼，什麼絕對不會送

這個連線是刻意設計成只能寫入、範圍很窄的。

Perfly 會收到	Perfly 絕對不會收到
簡短的標題，一件事一條	原始碼或 diff
選填的一行備註	PR 或 issue 的內文
日期和你的時區	完整的終端機輸出或 log
是哪個 Agent 送的（例如 `agent:claude-code`）	密鑰、token 或 API key
簡短的參照，像是 `git_commit:abc123` 或 `issue:ABC-123`	客戶資料、文件或附件

預設情況下，Agent 寫入任何東西之前都會先給你看預覽，等你同意。只有你刻意開啟無人值守模式，它才會跳過這一步。

這些工具能做的就只有新增項目，Agent 沒辦法把你在 Perfly 的歷史紀錄讀出來。

哪天不想用了，到 App 的 Agent 設定頁撤銷連線，馬上就會失效。

設定（大概一分鐘）

你需要先有 Perfly 帳號，前 30 天免費試用。

Claude Code

claude mcp add --transport http perfly https://api.perfly.dev/mcp

Claude Code 會打開瀏覽器，讓你登入 Perfly 並授權連線。完成。

Codex

在 ~/.codex/config.toml 加上：

[mcp_servers.perfly]
url = "https://api.perfly.dev/mcp"

Cursor

在專案的 .cursor/mcp.json 加上這段；想每個專案都能用，就放在 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "perfly": {
      "url": "https://api.perfly.dev/mcp"
    }
  }
}

其他支援遠端 HTTP server 的 MCP client 也一樣，指向 https://api.perfly.dev/mcp 就好。

在 SSH、devcontainer 或 CI 裡工作？

如果你的環境沒辦法開瀏覽器登入，可以到 Agent 設定頁建立一個只能寫入的 token，再用 header 帶上去：

export PERFLY_INGESTION_TOKEN="pfl_ing_..."
claude mcp add --transport http perfly https://api.perfly.dev/mcp \
  --header "Authorization: Bearer $PERFLY_INGESTION_TOKEN"

不要把 token 直接貼進跟 Agent 的對話裡，用上面這種環境變數的方式設定。

選配：加上 Skill

只裝 MCP server 就能用了。如果你希望 Agent 連整套流程都懂（該摘要什麼、什麼不能送、什麼時候要問你），可以再裝 Perfly Agent Sync skill。裝好之後，說一句「記錄今天的工作」就行。

Agent 會拿到的四個工具

工具	用途
`perfly_check_connection`	確認連線正常，不會回傳任何密鑰
`perfly_get_ingestion_policy`	告訴 Agent 哪些可以送、格式該怎麼寫
`perfly_preview_work_items`	檢查項目並預覽會寫入什麼，但不會真的寫入
`perfly_add_work_items`	把你同意的項目寫進你的 Today 頁面

常見問題

需要 Perfly 帳號嗎？

需要。Agent 是寫進你自己的紀錄，總要有地方寫。前 30 天免費、所有功能都能用，之後每月 $6.99。

它會不問我就自己記錄嗎？

預設不會。Agent 會先給你看清單，等你回覆。只有你刻意設定成無人值守，它才會直接送出。

哪些 Agent 可以用？

只要支援 MCP、而且能連遠端 HTTP server 的都可以。上面寫了 Claude Code、Codex 和 Cursor 的設定方式。如果你的環境沒辦法走 OAuth，就用 token 的方式。

我沒有用 Coding Agent 怎麼辦？

沒關係。下班前自己打幾行，或是連接 GitHub、Jira、Google Calendar、Notion，讓 Perfly 根據你的活動先擬好草稿。可以看看週報是怎麼產生的。

讓你的 Coding Agent 幫你記工作日誌