# 在 ChatGPT、Claude 和 Hermes 使用 commonplot (https://docs.commonplot.co/user/chatgpt-and-claude/)

連結 commonplot 後，ChatGPT 和 Claude 推薦的文章、論文、貼文和影片會顯示成卡片。按卡片上的「儲存」，內容就會存進你的 commonplot；你沒按之前，AI 不會替你儲存任何東西。AI 也可以讀取你的收藏、Notebook 與文件來回答問題。

## 連結 ChatGPT [#連結-chatgpt]

1. 在 ChatGPT 開啟「Settings → Security and login → Developer mode」（開發人員模式）。
2. 新增一個應用程式，網址填 `https://www.commonplot.co/api/mcp`，驗證方式選 OAuth。
3. 依畫面登入 commonplot，在授權頁按「允許連結」。

## 連結 Claude [#連結-claude]

1. 在 Claude 開啟「Settings → Connectors → Add custom connector」（新增自訂連接器）。
2. 網址填 `https://www.commonplot.co/api/mcp`。
3. 依畫面登入 commonplot，在授權頁按「允許連結」。

連結後開一個新對話即可使用。

## 連結 Hermes Agent [#連結-hermes-agent]

1. 在 `~/.hermes/config.yaml` 加入 commonplot：

   ```yaml
   mcp_servers:
     commonplot:
       url: "https://www.commonplot.co/api/mcp"
       auth: oauth
   ```

2. 開一個新的終端機，執行 `hermes mcp login commonplot`。
3. 在開啟的瀏覽器登入 commonplot，在授權頁按「允許連結」。

之後 Hermes 會保持連結，排程執行時也能使用。Hermes 在終端機裡運作，推薦會以文字呈現而不是卡片，也無法直接儲存；它可以搜尋 commonplot，並讀取你的收藏、Notebook 與文件。

## 可以做什麼 [#可以做什麼]

- **推薦並儲存**：請 AI 推薦閱讀，例如「推薦五篇 agent evaluation 的論文」，再按卡片上的「儲存」。
- **問你的收藏**：例如「我這週存了什麼？」「我之前存的那篇 RAG 評估論文重點是什麼？」AI 可以依主題搜尋你的收藏，也看得到一篇內容引用了什麼、被誰討論、有幾個人存過。
- **問你的 Notebook 與文件**：例如「整理我的 AI 晶片供應鏈 Notebook」「我的研究筆記寫了什麼？」第一次使用時，AI 會請你另外允許讀取 Notebook 與文件。
- **寫進 Notebook**：例如「把這段整理成筆記放進我的 AI 研究 Notebook」「把剛剛討論的三篇論文加進論文 Notebook」。AI 只在你要求時寫入；第一次使用時，會請你另外允許新增到 Notebook。
- **在對話裡閱讀**：按已儲存卡片上的「閱讀」，會在對話裡開啟全文。

想確保 AI 使用 commonplot，可以在訊息中提到 `@commonplot`，例如「@commonplot 推薦 MCP 相關的文章」。

## AI 能存取什麼 [#ai-能存取什麼]

連結後，AI 可以：

- 搜尋 commonplot 的公開內容；
- 列出與讀取你的已儲存資源，包含你上傳的私人檔案；
- 在你按下「儲存」時存下連結，並查看處理進度；
- 經你另外允許後，讀取你的 Notebook 與文件；
- 再經你另外允許後，在你指定的 Notebook 建立文件、加入收藏（不會修改或刪除既有內容）。

AI 無法讀取其他使用者的私人資料。透過 AI 存下的連結會和平常一樣出現在你的公開個人頁。AI 讀到的內容會傳給你連結的應用程式及其使用的模型服務商，並受其隱私權政策規範，詳見 commonplot [隱私權政策](https://www.commonplot.co/privacy)。

## 中斷連結 [#中斷連結]

到 commonplot 的「設定 → 帳號 → 已連結的應用程式」按「中斷連結」，存取會立即停止。已經存下的內容會保留。

## 需要協助 [#需要協助]

寫信到 [hello@commonplot.co](mailto:hello@commonplot.co)，附上你使用的應用程式（ChatGPT、Claude 或 Hermes）與發生的情況。