API key · 3 clientes MCP

Conecta Claude
a tu cuenta Criba.

Ya tienes tu API key. Aquí están los pasos copy-paste para cada cliente MCP. claude.ai web es el path canónico (OAuth nativo, no requiere instalar nada). Claude Desktop y Cursor son opciones para flujos avanzados.

Opción 1 · Recomendado

claude.ai web.

Sin instalar nada. Pegas la URL del connector, autorizas con OAuth y empiezas a hablar con tu tenant. Funciona desde cualquier navegador.

  1. Abre claude.ai, ve a Settings → Connectors y haz clic en Add custom connector.
  2. Pega la URL del servidor MCP de Criba: https://criba-api-l3ymx3rmga-uc.a.run.app/v1/mcp
  3. Claude lanza el flow de OAuth: verás una pantalla de Criba pidiendo tu API key. Pégala.
  4. Aprueba el consent. Claude regresa con la conexión lista (verás "Connected").
  5. Pídele en una conversación nueva: "lista mis expedientes". La primera vez retorna lista vacía — es tu tenant fresco.
Tip: claude.ai recuerda la conexión entre sesiones. No necesitas re-autenticar. Si rotas la API key, regenera desde Criba y vuelve a hacer el flow.
Opción 2 · Desktop

Claude Desktop.

Mejor para sesiones largas con archivos locales. Requiere editar un JSON de config y reiniciar la app.

Ubicación del archivo

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
JSON · Reemplaza <TU_API_KEY> con la key del signup claude_desktop_config.json 
{
  "mcpServers": {
    "criba": {
      "url": "https://criba-api-l3ymx3rmga-uc.a.run.app/v1/mcp",
      "headers": {
        "Authorization": "Bearer <TU_API_KEY>"
      }
    }
  }
}
  1. Abre (o crea) el archivo de configuración en la ruta de arriba.
  2. Pega el JSON y reemplaza <TU_API_KEY> con la key real.
  3. Reinicia Claude Desktop completamente (Cmd+Q en Mac, no solo cerrar la ventana).
  4. Verifica el conector: abre una conversación nueva, deberías ver el ícono de Criba en la barra de herramientas.
Si no aparece: verifica que el JSON sea válido (sin coma extra al final). Claude Desktop loguea errores en ~/Library/Logs/Claude/mcp-server-criba.log en macOS.
Opción 3 · IDE

Cursor & Windsurf.

Para flujos de desarrollo donde quieres validar expedientes desde el editor. Ambos IDEs soportan MCP nativo con la misma config que Claude Desktop.

JSON · Settings → MCP → Add Server (o edita el archivo directamente) mcp.json 
{
  "mcpServers": {
    "criba": {
      "url": "https://criba-api-l3ymx3rmga-uc.a.run.app/v1/mcp",
      "headers": {
        "Authorization": "Bearer <TU_API_KEY>"
      }
    }
  }
}

Cursor: edita ~/.cursor/mcp.json y reinicia.
Windsurf: Settings → Cascade → MCP Servers → Add Server.

Nota: el soporte MCP en Cursor/Windsurf evoluciona rápido. Si la versión instalada no toma la config, verifica que estés en la última build del IDE.

Ya está conectado.
Ahora pregúntale a Claude:

Una vez conectado, prueba cualquiera de estos prompts para sentir el flow conversacional:

"lista mis expedientes"
"configura un producto pyme con 3 roles: acreditado, obligado_solidario, aval_pm"
"crea un caso pyme con dos empresas y un aval persona física"
¿Atascado? Contáctanos