# MuseON MCP｜給 AI 助理的公開安裝與使用說明

更新日期：2026-11-09

給協助老闆安裝及使用 MuseON 的 AI 助理。完整安裝步驟以 [MCP 安裝頁](https://muse-on.biz/mcp) 為準。

## 連線與安裝

本服務提供的入口與使用說明版本：0.1.2。取得位置：museon://guide/usage；https://muse-on.biz/mcp-agent.md。已連線、已安裝入口、已讀說明要分開確認。

請一次只帶會員做一步：說明現在要打開哪個設定、按哪個按鈕、填什麼，等待會員回覆做完或說出畫面內容，再帶下一步。介面不同就先確認他看見的選項；不要一次丟整份步驟，也不要猜不存在的按鈕。

一次安裝（建議）：Claude Code 可執行 `claude plugin marketplace add zealchou/museon-plugin` 與 `claude plugin install museon@museon`，裝好 MuseON MCP 與 12 個用途入口 Skill，再用 /mcp 讓會員本人登入；Claude 網頁版可到「自訂 → 外掛程式 → 新增市集」貼上 `https://github.com/zealchou/museon-plugin`。ChatGPT 請依下方 ChatGPT 步驟連 MCP，再貼一次使用導引；不能安裝外掛的其他 AI 也可先連 MCP、讀取指南。連線成功不等於已安裝入口或已讀說明。

連線資料：網址 `https://muse-on.biz/mcp`，遠端 HTTP MCP，OAuth 登入，使用 MuseON 會員的 Google 帳號。讀取本說明頁時帶 `Accept: text/html`。Claude 網頁版已實測走新版協定，可見商會配對；舊版相容只服務仍用 2025-06-18 或 2025-11-25 的 AI，舊版不提供商會配對。免費使用至 2027/2/28；2027/3/1 起每月 8 美金（原價 30 美金）。

1. 先確認會員要接在哪裡：Claude 網頁版或 App、Claude Desktop、Claude Code、Codex，還是 ChatGPT。如果你就是其中一個，直接確認是否要接到這裡。
2. 開啟 [選你的 AI](https://muse-on.biz/mcp#install)，依該平台的安裝說明設定。
3. 本人登入並按允許：遇到 Google 登入與「允許」畫面，請會員本人操作；你不代按、不代填，也不要請會員把密碼或驗證碼貼給你。

## 確認連線成功

必須看到 MuseON 工具實際回覆，才告知老闆連線成功；入口安裝與已讀說明另行確認。

接好後，請 AI 主動呼叫一次本人已授權的 MuseON 唯讀工具確認，例如用 `museon.memory.recall` 測試「用 MuseON 查我的會員資料」。登入或工具確認畫面由會員本人操作。看到工具成功回覆才說連線成功；沒有已存紀錄也可以，工具出錯或 AI 自己回答都不算成功。

未成功時，依 [常見錯誤](https://muse-on.biz/mcp#errors) 排查，完成後再測一次工具。

## Codex CLI／IDE：MCP 與用途入口一次安裝

給 Codex CLI／IDE 的指示：開始前請一次確認，會員是否同意設定 MuseON MCP 並安裝 MuseON 用途入口 Skill；同意後接續下列步驟，登入與系統權限仍由會員本人確認。

第一步：打開 Codex 的設定檔（~/.codex/config.toml），在最上面加這兩行，讓登入回來的位置固定：mcp_oauth_callback_port = 43219 mcp_oauth_callback_url = "http://127.0.0.1:43219/callback"

第二步：在終端機貼上這一行，把 MuseON 加進 Codex：`codex mcp add museon --url https://muse-on.biz/mcp --oauth-client-id museon-codex --oauth-resource https://muse-on.biz/mcp`

第三步：瀏覽器會打開 MuseON 登入頁，登入後確認授權內容，按『允許』。

第四步：回到 Codex 輸入 /mcp，看到 MuseON 就代表連上了；再請它讀一次你的 MuseON 記憶試試看。

第五步：使用 $skill-installer，從正本 https://github.com/zealchou/museon-plugin/tree/main/museon/skills 安裝該目錄下全部用途入口 Skill（包含 museon/skills/museon/SKILL.md）。先讀取正本目錄清單，再以官方 install-skill-from-github.py 的 --repo zealchou/museon-plugin、--path 列出各 skill 目錄，明確指定 --dest ~/.agents/skills，保留各 skill 的完整資料夾與相鄰結構。

同名目錄已存在時先核對，不自動覆寫；需要更新就另請會員確認。下載或寫入權限不足時，說明卡在哪裡，不宣稱安裝成功。

安裝後逐一讀回各入口的 SKILL.md，確認與正本一致，再讀 museon 入口。請會員重開 Codex 或重新載入 IDE 工作階段，用 /skills 確認入口可見，再以 $museon 開始；MCP 連線、Skill 安裝與已讀說明分別回報。

以上是本機 CLI／IDE 安裝。Codex cloud 可用儲存在專案 .agents/skills 的技能，但本機個人技能不會同步到 cloud；要在本機使用，請回到本機 Codex 完成安裝，雲端完成不代表本機已裝好。

如果瀏覽器沒有自己打開，輸入 codex mcp login museon 再試一次。

## ChatGPT：一次一步接好並取得使用說明

請先用電腦瀏覽器打開 ChatGPT。能否新增 MCP、可用哪些工具，依方案與公司管理設定而定；看不到新增入口時，請見官方文件或請管理人協助，不用一直重試。

打開 [ChatGPT 外掛程式（Plugins）](https://chatgpt.com/plugins)，按「+」，選「新增自訂 MCP 伺服器」（Add custom MCP server）。若你看到舊版介面，點個人頭像 →「設定」（Settings）→「應用程式」（Apps）→「建立」（Create）；公司管理人也可能從「工作區設定 → Apps → Create」進入。

名稱填 MuseON，Connection 的網址填 `https://muse-on.biz/mcp`，登入方式選 OAuth。若有其他欄位但不確定填法，先把欄位名稱告訴 AI，不要填密碼或猜設定值。

確認連線與工具內容；新版介面需閱讀風險提示、勾選同意，再按「建立為外掛程式」（Create as a plugin）。舊版按「掃描工具」（Scan Tools），掃描完成後按「建立」（Create）。這些按鈕若未出現，先讓 AI 依你看到的畫面帶下一步。

跳出 MuseON 登入頁時，由你本人用自己的 Google 帳號登入並按「允許」；若授權畫面要求接續設定，也由你本人完成。回到 ChatGPT，確認工具已載入，並依畫面完成新增或安裝。

開新對話，在輸入框打 @ 選 MuseON；舊版可從「+」的工具選單選應用程式。請 AI 主動叫一次你已授權的 MuseON 唯讀工具確認，工具成功回覆才算連線成功；出錯就把錯誤交給 AI 排查。

這條 ChatGPT 連線不會安裝 MuseON 的 12 支入口 Skill，也不用去找 Skill 安裝按鈕。請把下面的「MuseON 使用導引」貼進專案指令或自訂指令，讓 AI 知道怎麼核對說明版本；若只貼在目前對話，新對話需要再貼。

只想在某個專案使用：在 ChatGPT 左側新增或打開專案，點專案的「•••」→「專案設定」（Project settings），把下方導引貼進專案指令並儲存。之後在這個專案裡開對話；專案指令只對該專案生效。

想在平常對話也使用：點個人頭像 →「設定」（Settings）→「個人化」（Personalization）→「自訂指令」（Custom Instructions），開啟自訂功能，把下方導引加在原有內容後並儲存。手機可從設定找「自訂 ChatGPT」（Customize ChatGPT）。已有原本指令時請保留；專案內以專案指令為準。

貼好後，請 AI 核對可讀到的 MuseON 說明版本；讀得到可說「已讀此版說明」，讀不到就說「版本尚未確認」，並提供這個安裝頁讓你取得目前導引。這不代表已安裝 Skill；同一對話不需要一直提醒。

## 可貼到專案或自訂指令的導引

MuseON 使用導引｜入口說明版本 0.1.2。來源：zealchou/museon-plugin。指南：museon://guide/usage；公開說明：https://muse-on.biz/mcp-agent.md。 當會員請你使用 MuseON 時，在本次對話第一次使用時核對可取得的服務說明版本。能讀 museon://guide/usage 就讀；不支援 resource 時，不反覆嘗試不存在的工具。有網頁讀取能力時可讀公開說明，否則提供 https://muse-on.biz/mcp 請會員貼入目前說明，並繼續原任務可用的部分。 只以實際啟用的套件或本對話已讀說明比對；下載目錄、原始碼與使用者口述不算安裝證據。只比較同來源的正式三段版號，按數字比較（0.9.0 比 0.10.0 舊）；來源不明、缺版號、預發布、快取或資訊衝突時說「版本尚未確認」。較舊才提示更新；本機較新時說「服務宣告較舊，需核對」，不自動降級。同版通常不提示；只在說明缺少、較舊或衝突時，依套件、版號與狀態在同一對話簡短提醒一次。只有新版本、會員明確重查或資訊遺失才重查。 ChatGPT 連上 MCP 不會安裝這套 12 支入口 Skill；可說「已讀此版本說明」，不可說「已安裝 Skill」。無法看見安裝清單時說「無法確認」。連線成功、已安裝入口與已讀說明分開確認。不要為版本檢查修改設定、安裝、登入、保存對話或上傳安裝清單；既有資料與工具限制仍適用。

## 找到可用功能

公開工具索引：[mcp-catalog.json](https://muse-on.biz/mcp-catalog.json)。功能以當次授權及連線後實際列出的工具為準。

連上後，看看你的 AI 顯示哪些工具；那份清單就是你現在能用的。

連線授權後，可從 MCP 資源清單開啟 MuseON 使用指南（`museon://guide/usage`），閱讀目前可用功能的使用方式。