把 Contextick 連接到 Claude Code 或 Codex CLI

對 Claude Code 和 Codex CLI 來說，最簡單的連接方式是 OAuth：沒有 API 金鑰， 也沒有設定檔。您在瀏覽器裡核准一次登入，就連上了。API 金鑰是無介面環境或 CI 場景下的替代方案。這兩個 工具的指令和欄位名稱並不相同，所以下面的程式碼片段不能互換。請選擇您用的那一個。

需要準備什麼

有 OAuth 就優先用 OAuth：沒有需要建立、保管、可能外洩的金鑰，指令也只有一行。只有在無法 用瀏覽器登入時（CI、無介面環境）才用 API 金鑰。

連接是怎麼回事

Contextick 是一個基於 streamable HTTP 的標準遠端 MCP 伺服器。每個工具都需要端點 https://contextick.ai/mcp 和一個伺服器名稱。走 OAuth 時您只要提供這些——登入由工具處理， 沒有金鑰也沒有標頭。走 API 金鑰這個替代方案時，還要多加一樣：一個 Authorization: Bearer <your API key> 標頭。程式碼片段裡其餘的部分，只是各個工具對這 幾樣東西的不同寫法。

Claude Code

兩條指令，沒有金鑰，不必編輯檔案。先註冊伺服器，再登入——第二條指令會開啟瀏覽器讓您核准。 （claude mcp add 只負責註冊伺服器，OAuth 登入是 claude mcp login。）

claude mcp add --transport http contextick https://contextick.ai/mcp
claude mcp login contextick

用 claude mcp list 確認。在無介面或 SSH 的機器上，執行 claude mcp login contextick --no-browser——它會印出一個可以在別處開啟的 URL，再把結果貼回來。 無人值守的 CI 請改用 API 金鑰方式。

Codex CLI

一條指令。Codex 會偵測到 Contextick 支援 OAuth，並自行發起瀏覽器登入——沒有金鑰，不必編輯檔案：

codex mcp add contextick --url https://contextick.ai/mcp

--url 參數註冊的是遠端 streamable-HTTP 伺服器；在沒有 bearer token 的情況下，Codex 會自動 走 OAuth。用 codex mcp list 確認。沒有瀏覽器可用（CI、無介面）？請改用 API 金鑰方式。

用 API 金鑰連接

在無法用瀏覽器登入時——CI 或無介面伺服器——才用金鑰。在帳戶頁面的 MCP 連接 → API 金鑰 → 建立 API 金鑰裡建立。

關於金鑰的兩點。它只在建立後顯示一次——之後無法再查看， 所以請當場複製。另外，您給金鑰取的名字會成為來源，記錄在透過它儲存的每一筆內容上， 所以請用您要連接的那個工具來命名。

下面的程式碼片段從 CONTEXTICK_API_KEY 讀取金鑰，請先在 shell 裡設定好：

export CONTEXTICK_API_KEY="your-api-key"

用金鑰的 Claude Code

在同一條指令裡帶上標頭：

claude mcp add --transport http contextick https://contextick.ai/mcp \
  --header "Authorization: Bearer $CONTEXTICK_API_KEY"

或者手動寫進 .mcp.json：

{
  "mcpServers": {
    "contextick": {
      "type": "http",
      "url": "https://contextick.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${CONTEXTICK_API_KEY}"
      }
    }
  }
}

這裡的 "type": "http" 是必要的。Claude Code 會把沒有 type 的項目當作本機 stdio 伺服器，所以漏掉它不是悄悄退化，而是直接報錯——您會看到 "has a url but no type"。從別的工具文件裡抄程式碼時，最容易弄丟的就是這個欄位。

用金鑰的 Codex CLI

Codex 用的是 TOML，不是 JSON。把下面這段加到 ~/.codex/config.toml（或專案裡的 .codex/config.toml）：

[mcp_servers.contextick]
url = "https://contextick.ai/mcp"
bearer_token_env_var = "CONTEXTICK_API_KEY"

有兩點要留意：表格名稱是底線寫法的 mcp_servers，不是 mcpServers。另外 Codex 接受的是存放金鑰的環境變數名稱，而不是金鑰本身——這樣金鑰就 不會留在檔案裡。

確認是否成功

分兩步驗證，第二步一定要開新工作階段。如果在同一個工作階段裡問，工具不呼叫 Contextick 也能憑剛才說過的話回答——這樣即使連接壞了，看起來也像成功了。

  1. 儲存一件您真正想回頭查的東西。在一次理清了想法的工作結尾說：「把我們剛整理 的移轉步驟儲存到 Contextick。」
  2. 結束並開一個新工作階段，問：「我們整理的移轉步驟是什麼？」

如果在新工作階段裡答得出來，就表示連接成功了——同時您也看到了它的意義：您一句都不用重講。這筆筆記在 Claude、ChatGPT 或任何連接到 Contextick 的 AI 裡同樣能用；而您在聊天應用裡儲存的內容，在這裡也讀得到。

如果沒有出現

官方文件

← 全部連接指南