Claude Code·Codex CLI 에 Contextick 연결하기

Claude Code 와 Codex CLI 에서 가장 간단한 연결은 OAuth 입니다. API 키도, 설정 파일도 없습니다. 브라우저 로그인을 한 번 승인하면 연결됩니다. API 키는 헤드리스나 CI 환경을 위한 대안입니다. 두 도구는 명령과 필드 이름이 다르므로 아래 스니펫을 서로 바꿔 쓸 수 없습니다. 쓰시는 도구를 고르세요.

준비물

가능하면 OAuth 를 쓰세요. 만들고 보관하고 유출될 키가 없고, 명령도 한 줄입니다. API 키는 브라우저 로그인이 불가능할 때만(CI, 헤드리스) 쓰세요.

연결은 이렇게 동작합니다

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 서버를 등록합니다. 베어러 토큰이 없으면 Codex 가 자동으로 OAuth 경로를 탑니다. codex mcp list 로 확인하세요. 브라우저를 쓸 수 없다면 (CI, 헤드리스) API 키 방식을 쓰세요.

API 키로 연결하기

브라우저 로그인이 불가능할 때 — CI 나 헤드리스 서버 — 키를 씁니다. 계정 페이지의 MCP 연결 → API 키 → API 키 만들기 에서 만듭니다.

키에 대해 두 가지. 키는 만든 직후 한 번만 보여집니다 — 다시 볼 수 없으니 그때 복사하세요. 그리고 키에 붙인 이름이 그 키로 저장된 모든 것의 출처로 기록되므로, 연결하는 도구 이름으로 지으세요.

아래 스니펫은 키를 CONTEXTICK_API_KEY 에서 읽으므로 셸에서 먼저 설정하세요:

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 는 JSON 이 아니라 TOML 을 씁니다. ~/.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 에서도 쓸 수 있고, 채팅 앱에서 저장한 것도 여기서 읽힙니다.

보이지 않는다면

공식 문서

← 전체 연결 가이드