Claude Code MCP 教學：連上 GitHub 等外部工具

Q: MCP 和 claude.ai 的 connectors 有什麼不同？

都是讓 Claude 用外部工具。connectors 是在 claude.ai 網頁上連的，會跟著帳號出現在 /mcp 的 claude.ai 區；claude mcp add 加的是只在這台電腦、這個專案生效的伺服器。

發現網站有個小問題，想記一張 GitHub issue，卻得切到瀏覽器、找 repo、想標題、寫內容？這篇讓 Claude Code 連上 GitHub：你在終端機說一句「幫我開一張 issue」，它自己讀程式碼、寫好現況和建議，直接開在你的 repo 上。

快速回答 MCP 是讓 Claude Code 連上外部工具的方式。連 GitHub 要三件事：在 GitHub 建一把 fine-grained 權杖，只給 my-site、Issues 可寫；把它放進環境變數 GITHUB_PAT；在專案資料夾執行 claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer $GITHUB_PAT"。啟動 claude 輸入 /mcp，看到 github 打勾就連上了。2026-10-23 用 Claude Code 2.1.309 實測：47 個工具，一句話開好 issue，用時 19 秒。權杖是密碼，不要貼進對話、不要截圖，用完到 GitHub 刪掉。

做完這篇，你會有

一把只能碰 my-site 的 GitHub 權杖
連上官方 GitHub MCP 的 Claude Code
Claude Code 替你開的一張 issue：「手機版作品卡片的字太小」

開始之前要準備：

第 13 篇推上 GitHub 的 my-site repo
第 10 篇用過 Figma MCP 更好，不過不是必要

步驟 1：建一把只給 my-site 的權杖

打開 github.com/settings/personal-access-tokens，按 Generate new token：

New fine-grained personal access token 表單：Token name、Description、Resource owner、Expiration、Repository access — 實際畫面（GitHub，2026-10-23）

Token name 填 claude-code-mcp，Expiration 選 30 天。Repository access 選 Only select repositories，只勾 my-site：

名稱 claude-code-mcp、30 days (Nov 22, 2026)、Only select repositories 選了 sunnyDataScience/my-site — 實際畫面（2026-10-23）：只給一個 repo，權杖外流也只影響這個 repo。

往下到 Permissions，按 Add permissions 加兩個：Issues 設 Read and write，Contents 設 Read-only。Metadata 會自動加上，固定是唯讀：

Permissions：Contents Read-only、Issues Read and write、Metadata Required Read-only，下方是 Generate token 按鈕 — 實際畫面（2026-10-23）

按 Generate token，GitHub 會顯示權杖字串，只顯示這一次，馬上複製。這個畫面不要截圖，字串和提示在同一塊，截了就會拍到。

步驟 2：用環境變數交給 Claude Code

先把權杖放進環境變數，不要直接貼進指令或對話：

export GITHUB_PAT=貼上權杖          # macOS / Linux
$env:GITHUB_PAT="貼上權杖"          # Windows PowerShell

貼完清掉畫面（clear）。接著在 my-site 資料夾執行（PowerShell 把 $GITHUB_PAT 換成 $env:GITHUB_PAT）：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer $GITHUB_PAT"

執行 claude mcp add 後顯示 Added HTTP MCP server github，Headers 裡的 Authorization 是 [REDACTED]，寫入 ~/.claude.json 的 my-site 專案 — 實際畫面（Claude Code 2.1.309，2026-10-23）：它自動把權杖遮成 [REDACTED]。

最後一行告訴你設定存在哪裡：~/.claude.json 裡的 my-site 專案。也就是說，只有在 my-site 開的 Claude Code 才會連 GitHub。這個檔案裡存著權杖，不要分享、不要放進 repo。

步驟 3：確認連上了

在 my-site 啟動 claude，輸入 /mcp：

/mcp 的 Manage MCP servers：Local MCPs 裡 github 打勾，47 tools；下面是 claude.ai 的 connectors 和內建的 plugin 伺服器 — 實際畫面（2026-10-23）：github 打勾、47 個工具。

最上面 Local MCPs 就是剛加的 github。下面的 claude.ai … 是你在 claude.ai 網頁上連過的 connectors，帳號不同，清單就不同，不用管。按 Esc 離開。

步驟 4：叫它開 issue

輸入：

幫 my-site 開一張 GitHub issue：標題「手機版作品卡片的字太小」，內容寫現在的狀況和建議怎麼改

它先讀 index.html 和 style.css，找出卡片的字級，寫好內容。要呼叫 GitHub 工具時，會先給你看要送出的標題和內文，問你要不要繼續：

核准畫面：issue 內容草稿（現況表格、建議修改、驗收條件），下方 About the github — Create or update issue/pull request Tool，Do you want to proceed? 1. Yes 2. No — 實際畫面（2026-10-23）：送出前看一下內容對不對。

選 Yes，它開好並回報：

回報：已開好 issue https://github.com/sunnyDataScience/my-site/issues/2，標題、現況、建議、驗收條件，Sautéed for 19s — 實際畫面（2026-10-23）：19 秒。

它的回報原文：

已開好 issue：https://github.com/sunnyDataScience/my-site/issues/2

標題： 手機版作品卡片的字太小

內容重點：
- 現況： 我查了 style.css，卡片裡最小的字是 .tags-small li，只有
  13px。標題（32px）、描述和按鈕（18px）都不算小。卡片在手機上也沒有專屬的字級設定。
- 建議：
  - 標籤調到 14–15px，並加大 padding。
  - 在 max-width: 639px 區塊加入卡片的描述字級、行距和內距。
  - 字級改用 rem。
  - 用 360px 和 390px 寬度檢查。
- 驗收條件： 手機上卡片內所有文字至少 14px，在 360px 寬度下不溢出。

我只讀了 CSS，沒有在實機或 DevTools
看過，所以「哪些字太小」是從字級推測的。如果你看到的是別處的字（例如預覽圖）太小，告訴我，我再改
issue。

要不要我順便照建議把 CSS 改好？

步驟 5：到 GitHub 看

打開它給的連結：

GitHub 上的 issue #2：手機版作品卡片的字太小，內容分成現況（字級表格）、建議修改、驗收條件 — 實際畫面（2026-10-23）

它寫的是 Markdown，到了 GitHub 表格和清單都排好了。

換你做

回到 Claude Code 說：「好，照 issue #2 的建議把 CSS 改好，commit 訊息寫 fixes #2」。push 上去後，這張 issue 會自動關掉。

用完把權杖收掉

練習完，或不打算長期用：

移除 Claude Code 的設定：在 my-site 執行 claude mcp remove github。
到 GitHub 的 Settings → Developer settings → Personal access tokens → Fine-grained tokens，把 claude-code-mcp 刪掉。
關掉終端機，或執行 unset GITHUB_PAT。

實測拍完照這三步收掉了。就算沒刪，30 天後它也會自己過期。

常見卡關

/mcp 裡 github 顯示失敗或要求驗證：權杖沒放進環境變數就執行了 mcp add（$GITHUB_PAT 是空的）。echo ${#GITHUB_PAT} 看長度，0 就是沒設好；設好後 claude mcp remove github 再加一次。
開 issue 時說沒有權限（403）：權杖沒選到 my-site，或 Issues 不是 Read and write。到 GitHub 編輯權杖的權限，不用重建。
換個資料夾就沒有 github 了：它是存在 my-site 專案底下的。這是刻意的，別的專案用不到就不給。
不小心把權杖貼進對話或截圖：馬上到 GitHub 刪掉那把權杖，再建一把新的。

你做到了

建了一把只能碰 my-site、30 天到期的 GitHub 權杖
用環境變數和 claude mcp add 連上官方 GitHub MCP，用 /mcp 確認 47 個工具都在
用一句話讓 Claude Code 讀程式碼、開好 issue，用完把權杖收掉

常見問題

MCP 和 claude.ai 的 connectors 有什麼不同？

都是讓 Claude 用外部工具。connectors 是在 claude.ai 網頁上連的，會跟著帳號出現在 /mcp 的 claude.ai 區；claude mcp add 加的是只在這台電腦、這個專案生效的伺服器。

為什麼不用 GitHub 帳號密碼？

權杖可以限定 repo、權限和期限，外流了也只影響那個範圍，刪掉就失效。帳號密碼什麼都能做，不要交給任何工具。

它開 issue 前會問我嗎？

會。用 MCP 工具要你核准，除非你在權限設定裡允許它不問。開 issue、改 repo 這類動作，建議保留詢問。

下一步

Claude Code 權限設定懶人包：該自動的自動、該問的一定問：MCP 工具的核准也在這裡設定。
讓 Claude Code 每天自己工作：排程教學：讓雲端的 Claude 每天替 repo 開 PR。

參考資料

Anthropic, Connect Claude Code to tools via MCP（Claude Code 文件，claude mcp add、--transport http、--header、範圍與 /mcp） https://code.claude.com/docs/en/mcp
GitHub, GitHub MCP Server（官方 GitHub MCP，遠端網址 https://api.githubcopilot.com/mcp/） https://github.com/github/github-mcp-server
GitHub Docs, Managing your personal access tokens（fine-grained 權杖的建立、權限與刪除） https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens