把 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 里同样能用；而您在聊天应用里保存的内容，在这里也读得到。

如果没有出现

官方文档

← 全部连接指南