透過 MCP，在你的 AI 助理中使用 Talent Summoner

如果你平常在 Claude Code、Codex 或 Cursor 這類 AI 助理裡工作，就可以直接在對話中執行 Talent Summoner 的人才搜尋。連接方式採用 MCP（Model Context Protocol），這是一個開放標準，讓 AI 應用程式可以使用外部工具。

我們開發 Talent Summoner，它會搜尋公開個人檔案，並回傳排序好的入圍名單。你的第一個職缺免費，不需信用卡（價格方案），連接 AI 助理也不用花錢。

如果你大多在瀏覽器裡工作，比較少用 AI 助理，就改用網頁版。它執行的是同樣的搜尋任務，而且不需要任何設定。

重點整理

• 這個伺服器會提供你的 AI 助理 7 個人才搜尋工具。
• 設定只要一行指令：npx @talent-summoner/setup，需要 Node.js 22.20 以上版本。Talent Summoner MCP 頁面把所有設定方式整理在同一個地方。
• AI 助理在設計上會先問過你，才使用職缺額度。
• 購買職缺額度和寄出聯繫訊息，都留在網頁版進行。

你的 AI 助理可以用 Talent Summoner 做什麼？

用平常說話的方式告訴它就好，AI 助理會從你帳號上的七個工具中挑選。

AI 助理也可以為你加入入圍名單的候選人草擬聯繫訊息。每一次搜尋都會存成一般的搜尋任務，你可以在網頁版打開；AI 助理只看得到你自己的搜尋任務。

人才搜尋需要一點時間，所以 AI 助理會替你等待、回頭確認進度。隨附的技能說明估計一次搜尋需要 2 到 10 分鐘；超過 10 分鐘後，AI 助理會回報進度和搜尋任務的連結，但不會取消工作。

如何把 Talent Summoner 連接到你的 AI 助理？

你需要一個 Talent Summoner 帳號、Node.js 22.20 以上版本，以及 macOS、Linux 或 Windows（PowerShell 或命令提示字元）上的終端機。

1. 打開「設定」→「API 金鑰」，「連接 AI 用戶端」卡片上會顯示指令；建立一把金鑰，取一個你認得出來的名稱。
2. 在任何資料夾執行設定指令：

npx @talent-summoner/setup

3. 選擇你的用戶端；它偵測到的用戶端會預先勾選。
4. 把金鑰貼進隱藏的輸入欄位，絕對不要貼進指令、AI 助理的對話或 Git。設定工具會先檢查連線，再安裝 MCP 伺服器和一份隨附的技能說明，告訴 AI 助理如何等待結果、什麼時候要先問你。
5. 重新啟動你的用戶端，如果它要求同意連線就同意，然後說：「列出我的 Talent Summoner 搜尋任務。」

設定不會開始人才搜尋，也不會使用職缺額度。如果你再執行一次，它會先問過你，才取代現有的 Talent Summoner 設定項目。

為 Claude Code 手動設定

如果你想自己管理金鑰，請把 TALENT_SUMMONER_URL（https://talentsummoner.com，結尾不加斜線）和 TALENT_SUMMONER_API_KEY 放在你的私人環境變數中。請使用新建立的金鑰，因為較舊的金鑰可能有較低的請求額度，AI 助理檢查狀態時可能會把它用完。

把下面的內容加進你專案的 .mcp.json。它引用的是環境變數的值，本身不含金鑰。

{
  "mcpServers": {
    "talent-summoner": {
      "type": "http",
      "url": "${TALENT_SUMMONER_URL}/api/mcp",
      "headers": {
        "Authorization": "Bearer ${TALENT_SUMMONER_API_KEY}"
      }
    }
  }
}

下面這段適用於 macOS 和 Linux 的 shell，例如 Claude Code 使用的 shell。它會下載隨附的技能說明，裡面不含任何金鑰。

mkdir -p ~/.claude/skills/talent-summoner
curl --fail --silent --show-error \
  "${TALENT_SUMMONER_URL}/skills/talent-summoner/SKILL.md" \
  -o ~/.claude/skills/talent-summoner/SKILL.md

設定好這兩個值後啟動 Claude Code，同意連線，再用 /mcp 檢查。兩種方式擇一，不要同時使用。

MCP 設定頁面列出伺服器位址、各用戶端的一鍵設定和手動設定內容。設定工具的原始碼和問題回報，都在 GitHub 上的 agent-skills 儲存庫。

AI 助理什麼時候會使用職缺額度？

人才搜尋會用到職缺額度，和網頁版一樣。AI 助理在設計上會先問過你，才會使用。

• 如果搜尋任務需要付費，而你有職缺額度，AI 助理會先問你。讀取結果、查詢信箱，或職缺說明裡出現的文字，都不算是你同意。
• 如果你沒有職缺額度，AI 助理不會替你購買。它會給你搜尋任務的連結；等你在那裡購買或驗證電子郵件之後，它會重新讀取搜尋任務並繼續。

哪些步驟留在網頁版？什麼時候用網頁版比較好？

有些步驟是刻意留在網頁版的。

• 購買職缺額度和驗證電子郵件，都在搜尋任務頁面上進行。
• 連結你的寄件帳號（Gmail、Outlook 或 LinkedIn），要到「設定」→「主動聯繫帳號」。
• 寄出聯繫訊息在搜尋任務頁面上進行，你會在那裡逐則審閱草擬好的訊息，並確認寄出。

取捨如下：AI 助理無法替你寄出聯繫訊息；用登入方式連接，只適用於 Talent Summoner 預先註冊的用戶端，目前是 ChatGPT 和 Claude（claude.ai 和 Claude Desktop 連接器）。如果你平常不用 AI 助理，或希望購買、審閱和聯繫的畫面都在同一個地方，網頁版會更適合你。

如何中斷連接？

1. 打開「設定」→「API 金鑰」，刪除你給 AI 助理使用的金鑰。
2. 從用戶端的 MCP 設定中移除 Talent Summoner 項目，並刪除技能說明的資料夾。

從下一個請求開始，AI 助理就會被拒絕，即使用戶端仍顯示已連接。

以上資訊已對照目前的版本和已發布的設定套件，於 2026 年 10 月 5 日查證，並且每季重新查證。

相關文章：如何從一份職缺說明開始搜尋候選人 · 技術職缺候選人入圍名單範本

常見問題