Cualquier programa que soporte MCP puede conectarse a Claix. Estos son los más habituales en producción y desarrollo:

• Cursor
• Claude Desktop
• Claude Code
• Windsurf
• Cline
• Continue
• Zed
• Smithery
• Lovable
• Replit Agent
• ChatGPT (con conectores MCP)
• n8n
• Make
• Zapier (vía HTTP/MCP)
• LangGraph / LangChain
• Cualquier cliente MCP con Streamable HTTP o SSE

IDEs y agentes de código (Cursor, Windsurf, Cline…) suelen usar configuración JSON con la URL del servidor y cabeceras. Smithery y clientes Streamable HTTP envían JSON-RPC directamente a POST /mcp. Claude Desktop suele usar SSE vía mcp-remote (GET /mcp + POST /mcp/message).

Opción recomendada — cabecera HTTP en todas las peticiones:

x-api-key: <TU_API_KEY>

En Smithery, configura el header con x-from: { "header": "x-api-key" } para que el usuario introduzca su clave al conectar. La API key es opcional en el schema de configuración si el cliente ya envía x-api-key.

Alternativa por tool: muchas tools aceptan api_key en los argumentos si el cliente MCP no puede enviar cabeceras personalizadas.

Ambos modos están activos en la misma URL base. El servidor detecta automáticamente el tipo de petición.

Metadatos estáticos para escaneo (Smithery, clientes): https://claix.dev/.well-known/mcp/server-card.json

1. Llama claix.schemas.list para obtener schema_id, tipo y si tiene Modo agente.
2. Usa claix.extract.* para extracción estructurada o claix.agent.* si is_agent_mode=true.
3. Envía el archivo en file_base64 (Base64 o data URL). El servidor reconstruye el multipart hacia la API REST de Claix.
4. Lee la respuesta en structuredContent.data (JSON tipado) o el texto en content.
5. Si el schema tiene ventana de contexto activa y la extracción devuelve document_id, guarda ese UUID: es la referencia al documento persistido en memoria de Claix.
6. Con el document_id, usa claix.window_context.get para leer el contenido bruto, claix.window_context.ask para preguntas en lenguaje natural, o claix.document.delete para eliminar el documento cuando ya no lo necesites.

Cuando un schema tiene ventana de contexto habilitada, Claix persiste el documento procesado y devuelve un document_id en la extracción. Las tres tools siguientes son proxies directos a la API REST de ventana de contexto y borrado; no consumen créditos de extracción.

Errores habituales en structuredContent.error: 401 (API key inválida), 404 (documento no encontrado o no pertenece a tu cuenta), 400 (parámetros inválidos). El borrado solo acepta DELETE sin body.

Prompt de workflow relacionado: workflow.window-context-ask (vía prompts/get).

Tras conectar, llama a tools/list para obtener las 25 tools con inputSchema, outputSchema y annotations (incluye destructiveHint en claix.document.delete):

El servidor expone prompts reutilizables vía prompts/list:

Recursos de documentación disponibles con resources/list:

Instalación one-click:

npx -y @smithery/cli run info-f4xz/claix

Configuración manual:

{
  "mcpUrl": "https://claix.dev/mcp",
  "headers": {
    "x-api-key": "TU_API_KEY"
  }
}

Directorio: smithery.ai/server/info-f4xz/claix

Añade en la configuración MCP de Cursor (Settings → MCP):

{
  "mcpServers": {
    "claix": {
      "url": "https://claix.dev/mcp",
      "headers": {
        "x-api-key": "TU_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "claix": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://claix.dev/mcp",
        "--header",
        "x-api-key:TU_API_KEY"
      ]
    }
  }
}

En n8n puedes usar un nodo HTTP Request con POST https://claix.dev/mcp, cabeceras JSON-RPC y body {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"claix.extract.pdf","arguments":{"schema_id":"…","file_base64":"…"}}}. Para ventana de contexto, cambia name a claix.window_context.get, claix.window_context.ask o claix.document.delete con document_id en arguments. También existen nodos comunitarios MCP; apunta la URL base a Claix y pasa x-api-key.