Conectar tu cliente de IA

Todos los clientes usan https://mcp.clau.io/mcp. El nombre sugerido es clau. Agrega la entrada a tu configuración existente conservando los demás servidores.

Hay dos formas de autenticarte. Elige una por conexión:

• Con tu cuenta del dashboard (OAuth), recomendada. Solo configuras la URL. Al conectar, el cliente abre la pantalla de Clau: inicias sesión, eliges el negocio y los permisos, y tocas Autorizar. Requiere el permiso API Keys en tu usuario.
• Con una API key con permisos. Crea la key en Configuración → API Keys → API keys con permisos y envíala en el header apikey (o como Authorization: Bearer ck_...). La key ya identifica tu negocio (ck_<APPID>_...), así que no hace falta APPID. Los ejemplos leen la key de la variable de entorno CLAU_API_KEY.

Configura las variables en el entorno desde el que se inicia el cliente: una variable definida en una terminal no siempre está disponible para una aplicación abierta desde el escritorio. Nunca pegues la key en una conversación ni en un archivo compartido.

Claude (web, Desktop y mobile)

Clau está en el directorio oficial de conectores de Claude: abre el conector de Clau y toca Connect, o búscalo en Customize → Connectors. Los pasos están en la guía del conector para Claude. Claude web y Desktop no permiten headers propios, así que siempre se conectan con tu cuenta del dashboard.

Claude Code

claude mcp add --transport http --scope user clau https://mcp.clau.io/mcp

En la sesión, escribe /mcp, elige clau y Authenticate: se abre el navegador con la pantalla de Clau.

Con API key, por ejemplo en un servidor, agrega el header al crear la conexión:

claude mcp add --transport http --scope user clau https://mcp.clau.io/mcp --header "apikey: ${CLAU_API_KEY}"

O en .mcp.json del proyecto. Claude Code expande ${VARIABLE}:

{
  "mcpServers": {
    "clau": {
      "type": "http",
      "url": "https://mcp.clau.io/mcp",
      "headers": {
        "apikey": "${CLAU_API_KEY}"
      }
    }
  }
}

Revisa la configuración activa con claude mcp get clau. Referencia de Claude Code.

Cursor

Agrega esta entrada en .cursor/mcp.json para el proyecto, o en ~/.cursor/mcp.json para tu usuario:

{
  "mcpServers": {
    "clau": {
      "url": "https://mcp.clau.io/mcp"
    }
  }
}

Habilita el servidor en la configuración MCP de Cursor. Cursor pide iniciar sesión y abre la pantalla de Clau.

Con API key, agrega headers dentro de clau:

{
  "mcpServers": {
    "clau": {
      "url": "https://mcp.clau.io/mcp",
      "headers": {
        "apikey": "${env:CLAU_API_KEY}"
      }
    }
  }
}

Referencia de Cursor.

VS Code

Agrega el servidor en .vscode/mcp.json. VS Code usa la propiedad raíz servers y el tipo http:

{
  "servers": {
    "clau": {
      "type": "http",
      "url": "https://mcp.clau.io/mcp"
    }
  }
}

Ejecuta MCP: List Servers desde la paleta de comandos e inicia clau. VS Code pide permiso para autenticarte y abre la pantalla de Clau.

Con API key, VS Code puede pedirla en un campo oculto:

{
  "inputs": [
    {
      "id": "clau-key",
      "type": "promptString",
      "description": "API key de Clau",
      "password": true
    }
  ],
  "servers": {
    "clau": {
      "type": "http",
      "url": "https://mcp.clau.io/mcp",
      "headers": {
        "apikey": "${input:clau-key}"
      }
    }
  }
}

Si usas un agente que no admite entradas interactivas, usa ${env:CLAU_API_KEY} en el header y omite inputs. Configuración MCP de VS Code.

Codex

codex mcp add clau --url https://mcp.clau.io/mcp
codex mcp login clau

codex mcp login abre el navegador con la pantalla de Clau. Revisa las herramientas con /mcp en la interfaz de terminal.

Con API key, edita la entrada en ~/.codex/config.toml y no uses login:

[mcp_servers.clau]
url = "https://mcp.clau.io/mcp"
env_http_headers = { "apikey" = "CLAU_API_KEY" }

env_http_headers recibe nombres de variables, sin ${env:...}. Referencia de Codex.

Otros clientes

Cualquier cliente compatible con servidores MCP remotos por HTTP (Streamable HTTP) puede conectarse con la URL https://mcp.clau.io/mcp:

• Si el cliente soporta OAuth para servidores remotos, basta la URL: al conectar abrirá la pantalla de Clau.
• Si no, configura el header apikey con tu key, o Authorization: Bearer ck_... si el cliente solo admite un token.

Comprueba la conexión

Usa cuenta_actual del MCP de Clau. Dime el negocio conectado,
los permisos y los límites por minuto. No muestres la API key.

Si responde con tu negocio, la conexión funciona. Si algo falla, consulta Solución de problemas.