AI 整合

GitResume 支援 MCP,這是連接 AI 助理與外部服務的開放標準。連上之後,你的 AI 助理就能把 PDF 履歷遷移到 GitResume、讀取你的履歷、查詢剛才那次推送建置得如何、給你下載連結、發布履歷,全程不用切回 Dashboard。

支援 Claude 以及任何相容 MCP 的用戶端,免費方案即可使用。

連接

GitResume 的 MCP 伺服器使用 Streamable HTTP,驗證走 OAuth 動態註冊,不需要事先申請 client ID 或 token:

https://gitresume.co/mcp

GitResume 也登錄於官方 MCP registry,名稱是 co.gitresume/gitresume。

Claude(網頁版與桌面版)

GitResume 已上架 Claude 的連接器目錄。開啟 Claude 目錄中的 GitResume,按「Connect to Claude」,在 GitResume 的授權頁同意即完成。

Claude 連接器目錄中的 GitResume 頁面,標示 New 與 Community,右側有 Connect to Claude 按鈕,下方列出說明、開發者、連接器網址與說明文件連結

連接完成後,按鈕會變成「Connected」。

用自訂連接器手動新增

看不到目錄,或組織的管理員限制了目錄時,可以手動新增:開啟設定 → Connectors → Add → Add custom connector,Name 填 GitResume,MCP server URL 填 https://gitresume.co/mcp,按「Continue」後在授權頁同意。

Claude 設定的 Connectors 頁面上開啟的 Add custom connector 對話框,Name 填 GitResume,MCP server URL 填 https://gitresume.co/mcp

Claude Code

  1. 在終端機執行:
    claude mcp add --transport http gitresume https://gitresume.co/mcp
  2. 開啟 Claude Code 後執行 /mcp,完成授權。

Codex

桌面版與 CLI 共用同一份設定,擇一即可。

  • 桌面版:開啟 Plugins → MCPs → Add → Add MCP server,名稱填 gitresume,Type 選 Streamable HTTP,URL 填上面的網址,其他欄位留空後儲存,再按 gitresume 那一列的 Authenticate 完成授權。 Codex 的 Connect to a custom MCP 表單,Name 填 gitresume,Type 選 Streamable HTTP,URL 填 https://gitresume.co/mcp,Bearer token 與 Headers 欄位留空
  • CLI:依序執行
    codex mcp add gitresume --url https://gitresume.co/mcp
    codex mcp login gitresume

其他客戶端

支援遠端 MCP 的工具,把上面的網址加為遠端伺服器(Streamable HTTP)即可,第一次連線時會開啟瀏覽器授權。接受 JSON 設定的工具可以用:

{
  "mcpServers": {
    "gitresume": {
      "url": "https://gitresume.co/mcp"
    }
  }
}

權限

授權頁上由你決定給哪些權限,只給讀取也是合理的選擇:

權限能做什麼備註
讀取你的專案、履歷內容、建置紀錄、PDF 與瀏覽數據必要權限
建置觸發重新建置、調整版面密度選用
發布發布或取消發布履歷選用
寫入建立未連結 GitHub 的專案、上傳新版本履歷選用
GitResume 的授權頁,標題為 Connect to GitResume,列出 Read、Build、Publish、Write 四個權限開關,Read 為必要權限,其餘三個可自行開關,下方是 Approve 與 Deny 按鈕

AI 助理只看得到你授權的功能。若不給發布權限,發布相關的工具對那條連線根本不存在。已授權的連線可隨時在「個人檔案 → 已連結的 AI Agent」查看與撤銷,撤銷後該連線隨即失效,最長不超過 15 分鐘。

你可以怎麼問

不需要記工具名稱,直接說你要做什麼:

  • 「幫我把這份 PDF 履歷遷移到 GitResume。」轉換、驗證、建立專案並建置。
  • 「我剛剛推的那次建置過了嗎?」讀取最新一次建置,失敗的話連錯誤訊息一起帶出來讓你修。
  • 「我的履歷有哪些地方要修?」讀取最新一次建置的 Resume Check 提醒,連同要改的行號一起帶出來。
  • 「把邊界縮小一點,讓履歷剩一頁。」調整版面密度並重新建置,再檢查一次結果。
  • 「幫我在推送前檢查這份履歷符不符合 schema。」先驗證 YAML,一個錯字只花幾秒,不必等一次失敗的建置。
  • 「給我 PDF 連結。」回傳可在瀏覽器開啟的下載連結。
  • 「這個月有多少人看過我的履歷?」讀取的是與 Dashboard 相同的數據。
  • 「發布吧。」把履歷切換為公開並回傳公開網址。

匯入既有履歷

手上已經有履歷的話(PDF、Word、Markdown 等任何格式都可以),這是最快的方式:建立 GitResume 帳號後,把你的 AI 工具(Claude、Claude Code、Codex 等)接上 GitResume MCP 並給予寫入權限,再把檔案交給它,請它遷移到 GitResume。它會轉換格式、通過驗證、跟你確認網址後建立專案並建置,全程在對話裡完成。建好的履歷預設不公開,確認後再請它發布。

Claude 的輸入框,已附上一份 PDF 履歷,訊息寫著 Migrate this PDF resume to GitResume. Claude 回報遷移完成:履歷已成為 GitResume 上的 resume 專案,第一次建置成功,版面檢查沒有問題,附上 PDF 與 HTML 預覽連結,並說明履歷尚未公開,確認後可發布到 gitresume.co/@gitresume-user/resume

完成後,專案就在你的 GitResume Dashboard 裡,可以下載 PDF、繼續編輯,或按「Publish」發布。

遷移完成後的 GitResume 專案頁,專案名稱 John Smith,標示 Not connected to GitHub,Deployment 區塊顯示履歷目前為私人並有 Publish 按鈕,Resume Check 顯示沒有發現常見問題

左邊是交給 AI 的原始 PDF,右邊是 GitResume 建置出的版本:

遷移前後對照。左邊是原始的 PDF 履歷,米色側欄、大頭照的雙欄版面;右邊是 GitResume 建置出的單欄履歷,經歷、技能、學歷等內容相同

疑難排解

「此 client 尚未註冊」

你的 AI 工具沿用了一個 GitResume 已經沒有紀錄的連線。把 GitResume 從工具裡移除再重新加入,讓它重新註冊即可。

  • Claude、Codex 桌面版:刪除 GitResume 後依連接的步驟重新新增。
  • Claude Code:
    claude mcp remove gitresume
    claude mcp add --transport http gitresume https://gitresume.co/mcp
  • Codex CLI:
    codex mcp remove gitresume
    codex mcp add gitresume --url https://gitresume.co/mcp
    codex mcp login gitresume

如果還是出現同樣的錯誤,請寄信到 [email protected] 告訴我們。

AI 助理無法建立專案或上傳履歷

這條連線沒有寫入權限。照上一題的方式移除 GitResume 再重新加入,在授權頁勾選「寫入」。

隱私

授權 AI 助理後,它就能以你的身分存取你所授權的資料與操作,直到授權被撤銷為止。資料交給該助理後,如何處理適用其服務商的隱私權政策,不適用我們的。想結束授權,隨時到「個人檔案 → 已連結的 AI Agent」撤銷。完整條款見隱私權政策的 AI Assistant Authorization 章節。

更新於