Conecta tu agente
puertafria tiene una API HTTP, y su propio servidor MCP encima. Tu agente lee la cola, abre una empresa y apunta lo que pasó, por HTTPS y nunca contra la base de datos. Las mismas filas, las mismas reglas, otra puerta.
Cuatro pasos
Crea una clave
En tu cuenta, debajo del panel de la suscripción. Una etiqueta que diga dónde vas a usarla y una casilla para si puede escribir, desmarcada por defecto. La clave se enseña una vez y se guarda como hash, así que nadie la vuelve a leer. Conectar un agente forma parte del plan Pro. Ir a tu cuenta.
Mándala en la cabecera
En cada petición y en ningún otro sitio. Nunca como parámetro, que se queda en los logs. Nunca la cookie de sesión: un navegador con sesión abierta no puede llegar aquí sin querer.
Authorization: Bearer pf_...
Pregunta qué tienes en la mano
La primera llamada dice de quién es la cuenta, en qué plan está y si esta clave puede escribir. El agente que lo lee primero no descubre el límite a base de que lo rechacen.
curl -sS https://puertafria.es/api/v1/me \ -H "Authorization: Bearer $PUERTAFRIA_TOKEN"
Trabaja la cartera
Lista las carteras, lee la cola, abre una empresa, apunta lo que pasó. Cada llamada pasa por la misma función que la pantalla, así que se topa con los mismos rechazos que tú.
curl -sS https://puertafria.es/api/v1/funnels/$FUNNEL/queue \ -H "Authorization: Bearer $PUERTAFRIA_TOKEN"
Cada puerta, y lo que hay detrás
Las rutas, los nombres de los tools y los rechazos se quedan en inglés en los dos idiomas. Una ruta traducida es una ruta equivocada.
Lecturas
GET /api/v1/me- The account this key opens, its plan, and whether this key may change anything. tool: whoami
GET /api/v1/funnels- Every funnel this account holds. Start here: nothing else takes a funnel by name. tool: list_funnels
GET /api/v1/funnels/:id- One funnel: counts by stage, how many are due, its campaigns and provinces, and its tracking fields with their ids. tool: funnel
GET /api/v1/funnels/:id/queue- Who to call today. Takes ?stage= &campaign= &province= &q= &page=. A company that asked to stop is never in it. tool: queue
GET /api/v1/companies/:id- One card: the row, its branches, its people, its history, its tracking values and its reminders. tool: company
GET /api/v1/funnels/:id/metrics- One funnel's numbers over ?days=7, 30 or 90. Pro and above; the free plan answers 403 PLAN_METRICS. tool: metrics
GET /api/v1/funnels/:id/export/:file- prospects.csv, contacts.csv or activities.csv. For curl and a pipe, never offered as a tool. sin tool, a propósito
Escrituras, y cada una necesita una clave que pueda escribir
POST /api/v1/companies/:id/activities- What happened on a call. An outcome that leaves the company open needs nextActionAt; a losing one needs a note. tool: record_outcome
PATCH /api/v1/companies/:id/tracking- The funnel's own fields on one company, keyed by field id. A blank clears a value; a field left out is left alone. tool: save_tracking
POST /api/v1/companies/:id/reminders- A promise to come back to this company on a day. Pro and above. tool: add_reminder
PATCH /api/v1/reminders/:id- Tick a reminder off, put it back, or move it. Exactly one of those per call. tool: update_reminder
PATCH /api/v1/companies/:id/branches/:locationId- One researched fact about one branch. A blank value clears it. tool: edit_branch_fact
POST /api/v1/funnels/:id/activate- Move named companies into a campaign. Ids only, never a filter: read the queue first and send what you looked at. tool: activate_cohort
POST /api/v1/funnels/:id/companies- One company typed in, for when there is no file. Bulk loading is the import screen, not this. tool: add_company
Lo que te va a rechazar
- No borra nada. Ninguna ruta quita una empresa, una cartera, un campo o un recordatorio. Un agente que se enrede puede liarla de forma que la leas, nunca de forma que desaparezca.
- Un no es para siempre. La empresa que pidió que no la llamaras sale de todas las colas, y el servidor se niega a registrar otro contacto lo pida quien lo pida.
- Un resultado que deja la empresa abierta tiene que decir cuándo se retoma, y uno perdedor tiene que llevar nota. Las mismas reglas que obedece la pantalla.
- 500 intentos de escritura por clave y día. Intentos, no aciertos: un bucle al que rechazan es justo el bucle que hay que parar. Las lecturas no gastan.
- Una clave solo lee salvo que marcaras la casilla, y la revocas desde el mismo panel. Revocar no deshace nada de lo que escribió.
El archivo al que apuntar tu agente
Todo lo de esta página, más el sobre, las palabras de rechazo y las reglas que hay detrás, en una sola dirección en texto plano. Eso es lo que tiene que leer un agente, y es el contrato entero y no un resumen.
El servidor MCP
stdio, un proceso que arranca el host de tu agente, con los mismos tools de la tabla de arriba. No lleva lógica: cada tool es una petición a esas rutas, así que lo remoto es la API y no el shim, y a una clave de solo lectura se le ofrecen tools de solo lectura en vez de dejarla descubrir un 403 llamando.
Todavía no está publicado en ningún registro, así que pídenoslo. No pierdes nada esperando: cualquier agente que sepa hacer una petición HTTPS ya puede trabajar tu cartera hoy. Pídenoslo.