Esta web también está hecha para máquinas.

LAS CUATRO PUERTAS

Ninguna necesita clave. Todo lo que devuelven ya está publicado en esta web: no hay datos de clientes detrás. Los detalles de autenticación —y por qué hoy no hace falta— están en auth.md.

SERVIDOR MCP

Streamable HTTP, sin sesión y sin autenticación. Solo POST: no abrimos stream de eventos porque el servidor no tiene nada que empujar.

{
  "mcpServers": {
    "okcomputer": {
      "type": "http",
      "url": "https://okcomputer.es/mcp"
    }
  }
}

Comprobar que responde:

curl -s https://okcomputer.es/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Herramientas

resources/list expone además llms.txt y llms-full.txt, por si prefieres cargar el contexto entero de una vez.

Tarjeta del servidor: /.well-known/mcp/server-card.json

AGENTE A2A

JSON-RPC contra /a2a, con la tarjeta en /.well-known/agent-card.json. Contesta preguntas sobre la empresa usando la FAQ oficial y el índice de páginas.

curl -s https://okcomputer.es/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{
        "message":{"kind":"message","role":"user","messageId":"1",
                   "parts":[{"kind":"text","text":"¿cuánto cuesta un agente de IA?"}]}}}'

API REST

Descrita en /openapi.json (OpenAPI 3.1) y anunciada en /.well-known/api-catalog (RFC 9727).

GET  /api/v1                          → índice de endpoints
GET  /api/v1/health                   → estado
GET  /api/v1/info                     → ficha de la empresa
GET  /api/v1/servicios                → catálogo de servicios
GET  /api/v1/casos                    → casos en producción
GET  /api/v1/precios                  → política de precios
GET  /api/v1/faq?q=cuanto%20cuesta    → FAQ con búsqueda
GET  /api/v1/paginas?q=fichaje        → índice de páginas
GET  /api/v1/herramientas             → catálogo invocable
POST /api/v1/herramientas/{nombre}    → invoca una herramienta
POST /api/v1/calculadora/tiempo-perdido

Ejemplo con la calculadora — devuelve el mismo número que la de la web, con los mismos supuestos (1.720 h de jornada anual, 46 semanas, 50 % automatizable):

curl -s https://okcomputer.es/api/v1/calculadora/tiempo-perdido \
  -H 'content-type: application/json' \
  -d '{"empleados":10,"coste_anual_bruto":30000,"horas_semana":12}'

MARKDOWN BAJO DEMANDA

Cualquier página devuelve markdown si lo pides por cabecera. El navegador sigue recibiendo su HTML.

curl -s -H 'Accept: text/markdown' https://okcomputer.es/casos

La respuesta llega con Content-Type: text/markdown y una cabecera de contexto con el título, la URL canónica y dónde seguir leyendo.

LO DEMÁS QUE HAY PUBLICADO

Las señales de contenido dicen search=yes, ai-input=yes, ai-train=yes. Traducido: puedes indexarnos, citarnos en tus respuestas y entrenar con esto. Vivimos de que nos encuentren.

Y si el agente corre dentro de un navegador con WebMCP, la página registra sus propias herramientas en navigator.modelContext al cargar: buscar, leer lo que hay en pantalla, calcular y navegar.

LO QUE NO HAY

Nada que escriba. Ninguna herramienta reserva reuniones, manda correos ni crea nada. Un agente puede darte el enlace de la reunión de evaluación; rellenarlo lo hace una persona. La agenda no se abre a robots — quien nos escribe merece que le contestemos nosotros.

Nada de OAuth de mentira. No publicamos /.well-known/oauth-authorization-server ni oauth-protected-resource porque no hay ningún recurso público que exija token. Describir una autenticación que no existe puntúa bien en los escáneres y engaña a quien la lea. El día que haya un recurso protegido de verdad, se publica.

Los HUB de cliente son otra cosa: otro dominio, sesión de usuario y acceso por contrato. Eso se habla con una persona, en hola@okcomputer.es.

¿Y ESTO PARA QUÉ?

Porque es exactamente el trabajo que hacemos. Un OKHUB es esto mismo puesto dentro de una empresa: los datos que ya tiene —el ERP, las cámaras, los fichajes, la documentación— expuestos de forma que una IA los pueda usar sin inventarse nada, y con las puertas que escriben cerradas salvo donde toca.

Si te interesa cómo se monta eso en tu negocio, la primera reunión es de una hora y no cuesta nada: reservar o hola@okcomputer.es.