Claix es una API B2B de normalización semántica con IA que convierte PDFs, Excel/CSV, documentos Word/texto e imágenes en JSON estrictamente tipado según un schema definido por el desarrollador. Sitio oficial: https://www.claix.dev

¿Qué formatos admite la API de Claix?

Claix admite Excel (.xlsx) y CSV, JSON para exportar a Excel, PDF (texto o escaneado), documentos .docx/.txt/.md/.rtf, e imágenes .jpeg/.jpg/.png/.webp/.heic/.heif. Cada formato usa un endpoint y un tipo de schema específico.

¿Cómo convierto un PDF a JSON con Claix?

Crea un schema de tipo pdf-json, obtén una API key y envía un POST multipart a https://www.claix.dev/api/pdf-json con los campos file y schema_id y la cabecera x-api-key. Documentación: https://www.claix.dev/documentation/pdf-to-json

¿Cuál es el modelo de precios de Claix?

Pay-as-you-go. Las 15 primeras llamadas exitosas (HTTP 200) son gratis. Excel↔JSON cobra por volumen de variables (€0,25–€1,00). PDF→JSON €0,35, Doc→JSON €0,20 e Img→JSON €0,10 por envío exitoso. Los errores 4xx/5xx no se facturan.

¿Claix tiene un widget embebible?

Sí. Claix ofrece un widget iframe gratuito e ilimitado en uso de UI (https://www.claix.dev/widget/{id}), personalizable y listo para producción. El JSON se entrega al webhook HTTPS del dueño; la API key nunca se expone en el navegador.

¿Dónde está la especificación OpenAPI?

La especificación OpenAPI 3 está en https://www.claix.dev/openapi.yaml. El resumen para IAs está en https://www.claix.dev/llms.txt y la base de conocimiento completa en https://www.claix.dev/llms-full.txt.

¿Claix es compatible con n8n y Make?

Sí. Puedes usar HTTP multipart genérico o el nodo comunitario n8n-nodes-claix. Guía: https://www.claix.dev/blog/integrar-claix-en-n8n

¿Claix cumple el RGPD?

Claix ofrece procesamiento orientado a la UE, DPA público en https://www.claix.dev/dpa, sin retención de archivos para entrenar modelos y sin entrenamiento sobre documentos del cliente.

Servidor MCP

Claix como servidor MCP

Endpoint

MCPhttps://www.claix.dev/mcp

Claix expone un servidor Model Context Protocol (MCP) para que asistentes de IA y herramientas de automatización invoquen extracción, listado de schemas y Modo agente sin escribir integraciones REST a mano.

La URL pública del servidor es https://www.claix.dev/mcp. La autenticación usa tu API key de Claix en la cabecera x-api-key (o el parámetro opcional api_key en cada tool si el cliente no envía cabeceras).

Las tools usan nomenclatura dot notation (claix.schemas.list, claix.extract.pdf, …) y devuelven structuredContent con success, data y error.

1. Clientes compatibles

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).

2. Autenticación

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.

3. Modos de transporte

Modo	Uso típico	Cómo conectar
Streamable HTTP	Smithery, Cursor, clientes modernos	POST /mcp con JSON-RPC (initialize, tools/list, tools/call). Cabecera Accept: application/json, text/event-stream
SSE legacy	Claude Desktop, mcp-remote	GET /mcp (stream SSE) + POST /mcp/message?sessionId=… para mensajes

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://www.claix.dev/.well-known/mcp/server-card.json

4. Flujo recomendado

Llama claix.schemas.list para obtener schema_id, tipo y si tiene Modo agente.
Usa claix.extract.* para extracción estructurada o claix.agent.* si is_agent_mode=true.
Envía el archivo en file_base64 (Base64 o data URL). El servidor reconstruye el multipart hacia la API REST de Claix.
Lee la respuesta en structuredContent.data (JSON tipado) o el texto en content.

5. Tools disponibles

Tras conectar, llama a tools/list para obtener el catálogo completo con inputSchema, outputSchema y annotations. Tools principales:

Tool	Descripción
claix.schemas.list	Lista schemas de la cuenta (id, nombre, tipo, is_agent_mode, agent_definition). Llama primero para obtener schema_id.
claix.extract.excel	Excel/CSV → JSON tipado (POST /api/excel-json). Primera hoja.
claix.extract.pdf	PDF → JSON tipado (POST /api/pdf-json). Texto o escaneado, máx. 15 MB.
claix.extract.doc	Documento (.docx, .txt, .md, .rtf) → JSON (POST /api/doc-json).
claix.extract.image	Imagen (JPEG, PNG, WebP, HEIC) → JSON (POST /api/img-json).
claix.convert.json_to_excel	JSON → Excel .xlsx (POST /api/json-excel). Devuelve file_base64.
claix.agent.excel	Excel/CSV + Modo agente → data[] y agent_data (POST /agent/excel-json).
claix.agent.pdf	PDF + Modo agente → data[] y agent_data (POST /agent/pdf-json).
claix.agent.doc	Documento + Modo agente (POST /agent/doc-json).
claix.agent.image	Imagen + Modo agente (POST /agent/img-json).

6. Prompts de workflow

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

Prompt	Descripción
workflow.discover-and-extract	Descubre schemas con claix.schemas.list y extrae JSON con claix.extract.*.
workflow.agent-document-analysis	Ejecuta claix.agent.* cuando el schema tiene is_agent_mode.
workflow.invoice-pdf	Flujo optimizado para facturas PDF con claix.extract.pdf.

7. Resources

Recursos de documentación disponibles con resources/list:

URI	Descripción
claix://docs/mcp	Guía de conexión MCP y catálogo de tools.
claix://docs/openapi	URL de la especificación OpenAPI de Claix.
claix://docs/tools	Catálogo JSON de todas las tools MCP.

8. Ejemplo Smithery

Instalación one-click:

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

Configuración manual:

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

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

9. Ejemplo Cursor

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

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

10. Ejemplo Claude Desktop

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

11. n8n y automatización

En n8n puedes usar un nodo HTTP Request con POST https://www.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":"…"}}}. También existen nodos comunitarios MCP; apunta la URL base a Claix y pasa x-api-key.