khive

npx add-mcp 'https://khive.ai/v1/mcp'

Todo ocurre en khive.ai. Inicias sesión y gestionas tu cuenta en https://khive.ai en un navegador, y los clientes MCP se conectan a https://khive.ai/v1/mcp.

1. Crea tu cuenta

Registrarse consta de tres pasos, en este orden: iniciar sesión, crear tu espacio de trabajo y tener un plan. Una clave API es un cuarto paso, solo para acceso mediante scripts. Cada uno es una acción explícita; ninguno ocurre como efecto secundario del paso anterior.

Iniciar sesión

Abre https://khive.ai/login e inicia sesión con un enlace de correo electrónico de un solo uso. No hay contraseña que configurar.

Iniciar sesión crea una sesión y nada más. Aún no tienes un espacio de trabajo, por lo que el panel te indicará que tu cuenta no está activa hasta que completes el siguiente paso.

Crea tu espacio de trabajo

Ve a Claves API en el panel (https://khive.ai/dashboard/keys). En Completar configuración de la cuenta, haz clic en Crear espacio de trabajo. Esto crea tu espacio de trabajo: el grafo privado de tu cuenta y un proyecto para almacenar tus datos.

Este es el paso que la gente se salta. Ir directamente a Facturación antes de crear un espacio de trabajo no funcionará: una compra necesita un espacio de trabajo al que acreditarse, por lo que el panel te indica que primero termines de configurar tu cuenta.

Ten un plan

Toda cuenta que usa khive tiene uno de tres planes. No hay nivel gratuito.

Plan	Mensual	Anual: 17% de descuento	Uso incluido	Prueba
Start	$8	$80	1x	ninguna
Plus	$25	$250	5x Start	14 días en mensual, tarjeta registrada
Pro	$100	$1,000	20x Start	ninguna

Cada plan incluye una asignación de uso mensual. El panel muestra cuánto has usado como proporción, y más allá del 100% añades uso adicional como compra única (desde $10, válido por 500 días), que es lo que vende la página de Facturación (https://khive.ai/dashboard/billing): elige un monto, el pago se procesa en Stripe, y el uso adicional se acredita a tu cuenta cuando el pago se liquida.

Conectar un cliente de chat (paso 2) inicia la prueba de Plus: exactamente una pantalla de Stripe entre tu inicio de sesión y la activación del conector, y la prueba continúa desde allí. Start y Pro se eligen desde la página de precios. Cancela en cualquier momento; el servicio continúa hasta el final del período pagado.

El acceso se verifica en cada llamada, en este orden: un plan activo (en prueba o activo, con su período aún no finalizado), luego uso restante (primero el uso incluido, luego el uso adicional). Una llamada rechazada por cualquiera de las dos verificaciones devuelve una línea que indica cuál fue y dónde gestionarla, y la lista de herramientas no se ve afectada. Un plan vencido se rechaza en la siguiente llamada.

Crea una clave API

De vuelta en Claves API, haz clic en Crear clave API. La clave se muestra una sola vez. Cópiala de inmediato y guárdala de forma segura, porque el panel no puede volver a mostrar la clave completa. Las claves están vinculadas a tu espacio de trabajo, y puedes revocar cualquiera de ellas desde la misma página.

Solo necesitas una clave para acceso mediante scripts. Un cliente MCP compatible con OAuth gestiona sus propios tokens, como se describe en el siguiente paso.

2. Conecta un cliente MCP

khive habla el transporte estándar MCP Streamable HTTP en:

https://khive.ai/v1/mcp

Apunta cualquier cliente MCP compatible con OAuth (Claude Desktop, la interfaz de conector de claude.ai, o tu propio cliente construido con un SDK de MCP) a esa URL. El cliente descubre los metadatos de OAuth en /.well-known/oauth-protected-resource/v1/mcp, te redirige a través del mismo inicio de sesión que usaste en el paso 1, y regresa con un token de acceso limitado a tu cuenta. No copias ni pegas una clave para esta ruta. El cliente gestiona el intercambio de tokens.

Una vez conectado, tu cliente lista las herramientas de khive por nombre: remember y recall_memories para memoria, create_record, link_records, search_records, graph_neighbors y graph_context para el grafo, add_task y list_tasks para tareas, y el resto del catálogo. No las llamas tú mismo. Pide a tu agente en lenguaje natural y él elige la herramienta. Los ejemplos a continuación muestran la herramienta y los argumentos que debería terminar llamando, para que puedas verificar lo que ocurrió.

Acceso mediante scripts y no interactivo

No todos los llamadores pueden manejar una redirección interactiva en el navegador. Los trabajos de CI, los scripts de backend y los entornos de agentes locales necesitan una credencial que puedan conservar: una clave API de larga duración, creada en la página de Claves API en el paso 1 y enviada como Authorization: ApiKey <key> o X-Api-Key: <key>. Una clave API se conecta al mismo endpoint de MCP que un cliente OAuth y recibe las mismas herramientas nombradas; cualquier cliente MCP que pueda enviar un encabezado de autorización fijo puede usarla, y también un POST JSON-RPC simple al endpoint de MCP. Si usas un cliente MCP compatible con OAuth, no necesitas una clave API.

3. Dale una memoria a tu agente

En una sesión, dile a tu agente algo que valga la pena conservar:

Recuerda que la API de facturación corre en Fly en la región iad, y hacemos rollback con fly releases.

El agente llama:

remember   { "content": "The billing API runs on Fly in iad; roll back with fly releases.", "memory_type": "semantic" }

y recibe el id de la nueva memoria. Ahora cierra la sesión y abre una nueva, para que nada de la primera conversación esté en contexto. Pregunta:

¿Cómo hacemos rollback de la API de facturación?

El agente llama:

recall_memories   { "query": "how to roll back the billing API" }

y responde desde la memoria que almacenó, junto con su puntuación. Las memorias son registros, por lo que una incorrecta puede corregirse con update_record o eliminarse con delete_record por su id.

4. Construye un grafo pequeño y léelo de vuelta

Las memorias son texto libre. Cuando quieras estructura, pide a tu agente que registre cosas y cómo se relacionan:

Registra que billing-api es un servicio que depende de postgres-primary.

El agente llama a create_record dos veces y a link_records una vez:

create_record   { "kind": "service", "name": "billing-api", "description": "Billing API, deployed on Fly." }
create_record   { "kind": "service", "name": "postgres-primary", "description": "Primary Postgres database." }
link_records    { "source_id": "<billing-api id>", "target_id": "<postgres-primary id>", "relation": "depends_on" }

Cada create_record devuelve el registro nuevo completo, incluido su id, y una lista similar_existing de registros que ya se le parecen. Antes de añadir un duplicado, revisa esa lista. link_records verifica que la relación encaje con los dos tipos y rechaza un par que no encaje.

Para leerlo de vuelta, busca por significado y luego recorre las aristas:

search_records    { "kind": "entity", "query": "which database does billing use" }
graph_neighbors   { "node_id": "billing-api" }

graph_neighbors toma un id o un nombre y devuelve cada registro vinculado con la relación y el peso de su arista. Cuando quieras un resumen fundamentado alrededor de varios registros a la vez, graph_context toma entity_ids (ids o nombres) y devuelve cada uno con su vecindario.

Gestiona tu cuenta

Tu plan, método de pago, facturas y cancelación están en Gestionar facturación en la página de Cuenta (https://khive.ai/account). Preguntas: contact@khive.ai.