Para vecinos y desarrolladores
Conecta tu asistente
Tu asistente de IA puede consultar tu información de la comunidad por ti. Solo lectura: puede ver tu estado de cuenta, las votaciones y tus comprobantes; nunca puede cambiar nada.
Para vecinos
Conecta tu asistente de IA a tu información de la comunidad. Solo lectura: puede ver tu estado de cuenta, las votaciones y tus comprobantes; nunca puede cambiar nada. Tú decides qué puede ver, y puedes desconectarlo cuando quieras.
01
Crea una conexión
En tu página de Conexiones eliges qué puede ver tu asistente y creas una llave. La llave aparece una sola vez: cópiala.
02
Agrégala a tu asistente
Pega la llave en tu asistente de IA, donde se configuran las conexiones. Con eso queda enlazado a tu información.
03
Pregúntale sobre tu comunidad
Ya puedes pedirle tu saldo, ver qué votaciones están abiertas o revisar tus comprobantes, en tus propias palabras.
Para desarrolladores
El Pozo expone un servidor MCP de solo lectura. Es el mismo contrato que usa tu asistente: cualquier cliente compatible con MCP puede conectarse con la llave del vecino.
Endpoint
Autenticación
Cada solicitud lleva el encabezado Authorization con la llave que el vecino creó en su página de Conexiones. La llave empieza con elpozo_ y es de solo lectura, acotada y revocable.
Protocolo
Model Context Protocol sobre JSON-RPC 2.0 por HTTP POST (el transporte Streamable HTTP síncrono). Los métodos son initialize, tools/list y tools/call.
Las seis herramientas de solo lectura
Acceso de escritura: proponer y confirmar
Con permisos de escritura, una IA puede PROPONER acciones (un pago, una cuota, un aviso) pero nunca ejecutarlas: cada propuesta cae en la fila "Por confirmar" y solo una persona con el cargo correspondiente la confirma. Un permiso ":propose" crea propuestas; un ":commit" solo las confirma si el titular del token ya tiene ese cargo (permiso Y rol, nunca solo permiso). Cada token tiene topes (monto por propuesta, propuestas por día) y se revoca al instante. La escritura está apagada hasta que cada comunidad la activa.
Una IA también puede traer un documento por la conexión (con propose_from_document): una lista de vecinos, un estado de cuenta del banco, unos recibos. El documento se trata como DATOS, nunca como instrucciones — cualquier texto adentro que parezca una orden se ignora — y se convierte en las mismas propuestas Por confirmar. Nada se escribe hasta que una persona confirma cada una.
Ejemplo de configuración de un cliente MCP
Apunta tu cliente al endpoint y pasa la llave en el encabezado Authorization.
{
"mcpServers": {
"elpozo": {
"url": "https://elpozo.mx/api/mcp",
"headers": {
"Authorization": "Bearer elpozo_your_key_here"
}
}
}
}Ejemplo con curl: la llamada initialize
Una llamada mínima que abre la sesión y confirma que la llave funciona.
curl -X POST https://elpozo.mx/api/mcp \
-H "Authorization: Bearer elpozo_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": { "name": "my-assistant", "version": "1.0.0" }
}
}'Todo es de solo lectura y se limita exactamente a lo que el vecino concedió. No existe ninguna forma de escribir o cambiar datos, y cualquier conexión puede revocarse en cualquier momento desde la página de Conexiones.