Conecta Contextick con Claude Code o Codex CLI

Para Claude Code y Codex CLI la conexión más sencilla es OAuth: sin clave de API y sin archivo de configuración. Apruebas un inicio de sesión en el navegador una vez y ya está conectado. La clave de API es la alternativa para entornos headless o de CI. Lo que cambia entre las dos herramientas es el comando exacto y el nombre de los campos, así que los fragmentos de abajo no son intercambiables. Elige tu herramienta.

Lo que necesitas

Prefiere OAuth donde esté disponible: no hay ninguna clave que crear, guardar o filtrar, y el comando es una sola línea. Usa una clave de API solo cuando no sea posible iniciar sesión en un navegador (CI, headless).

Cómo funciona la conexión

Contextick es un servidor MCP remoto estándar sobre streamable HTTP. Cada herramienta necesita el endpoint https://contextick.ai/mcp y un nombre para el servidor. Por OAuth eso es todo lo que aportas: la herramienta se encarga del inicio de sesión y no hay clave ni cabecera. Por la vía alternativa de la clave de API añades una cosa más: una cabecera Authorization: Bearer <tu clave de API>. Todo lo demás en los fragmentos es la forma particular que tiene cada herramienta de escribir esto.

Claude Code

Dos comandos, sin clave y sin editar archivos. Registra el servidor y luego inicia sesión: el segundo comando abre tu navegador para aprobar. (claude mcp add solo registra el servidor; el inicio de sesión OAuth es claude mcp login).

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

Compruébalo con claude mcp list. En una máquina headless o por SSH, ejecuta claude mcp login contextick --no-browser: imprime una URL para abrir en otro sitio y pegar el resultado de vuelta. Para CI desatendido, usa mejor el método de la clave de API.

Codex CLI

Un comando. Codex detecta que Contextick admite OAuth y arranca él mismo el inicio de sesión en el navegador: sin clave y sin editar archivos:

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

La opción --url registra un servidor remoto streamable-HTTP; sin token bearer, Codex toma la vía OAuth automáticamente. Compruébalo con codex mcp list. ¿No hay navegador disponible (CI, headless)? Usa mejor el método de la clave de API.

Conectar con una clave de API

Usa una clave cuando no sea posible iniciar sesión en un navegador: CI o un servidor headless. Crea una en tu página de cuenta, en Conexión MCP → Claves de API → Crear clave de API.

Dos cosas sobre la clave. Se muestra una sola vez, justo después de crearla: cópiala entonces, porque no podrás volver a verla. Y el nombre que le des a la clave pasa a ser el origen que queda registrado en todo lo que se guarde con ella, así que ponle el nombre de la herramienta que estás conectando.

Los fragmentos de abajo leen la clave de CONTEXTICK_API_KEY, así que defínela antes en tu shell:

export CONTEXTICK_API_KEY="your-api-key"

Claude Code con una clave

Pasa la cabecera en el mismo comando:

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

O escríbelo a mano en .mcp.json:

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

Aquí "type": "http" es obligatorio. Claude Code interpreta una entrada sin type como un servidor stdio local, así que omitirlo es un error duro y no un comportamiento por defecto silencioso: verás «has a url but no type». Este es el campo que la gente pierde al copiar de la documentación de otras herramientas.

Codex CLI con una clave

Codex usa TOML, no JSON. Añade esto a ~/.codex/config.toml (o a .codex/config.toml dentro de un proyecto):

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

Dos detalles: la tabla es mcp_servers en snake_case, no mcpServers. Y Codex toma el nombre de la variable de entorno que contiene tu clave, no la clave en sí, así que la clave nunca acaba dentro del archivo.

Comprueba que funciona

Pruébalo en dos partes, y que la segunda sea una sesión nueva. Si preguntas en la misma, la herramienta puede responder con lo que acabas de decir sin llamar nunca a Contextick, así que una conexión rota parecería igualmente correcta.

  1. Guarda algo que de verdad querrías recuperar. Al final de una sesión en la que hayas resuelto algo, di: «Guarda en Contextick los pasos de migración que acabamos de perfilar».
  2. Sal, empieza una sesión nueva y pregunta: «¿Cuáles son los pasos de migración que perfilamos?»

Si vuelve en la sesión nueva, estás conectado, y acabas de ver para qué sirve: no has tenido que explicarlo otra vez. Esa nota está también disponible en Claude, ChatGPT o cualquier otra IA que conectes con Contextick, y todo lo que hayas guardado desde una aplicación de chat también se puede leer aquí.

Si no aparece

Documentación oficial

← Todas las guías de conexión