PuentesDevelopers
Conectá un servidor MCP a un agente de Puentes
Si ya tenés un servidor MCP andando, conectarlo a un agente de Puentes es un campo más en el agente. No hay que escribir el pegamento entre el modelo y tus herramientas.
El campo
Al crear o editar un agente de tipo ai, le pasás mcp:
curl -X PATCH https://app.puentes.ai/api/bots/<id> \
-H "Authorization: Bearer pk_…" -H "Content-Type: application/json" \
-d '{ "mcp": { "url": "https://mi-server.com/mcp", "label": "Pedidos" } }'
url tiene que ser pública y https. Si tu servicio necesita una clave, va en secret, que se guarda cifrada y nunca se devuelve. El tipo de autenticación (none, bearer, oauth) se detecta solo si no lo mandás. Pasar null en un PATCH desconecta el servidor.
Desde ahí, las herramientas de tu servidor están disponibles para ese agente adentro de cualquier chat donde esté.
Lo que tu servidor recibe de más
Acá está la parte que no es estándar y que conviene aprovechar.
Cada llamada que Puentes le hace a tu servidor trae, en _meta.puentes, una dirección para publicar en ese chat: postUrl. Es una por agente y por chat.
La guardás. Cuando en tu sistema pasa algo (salió el pedido, se cayó un servicio, cambió un precio), hacés un POST a esa dirección:
POST <postUrl>
Content-Type: application/json
{ "text": "🔴 Se cayó el rack 4",
"card": { … },
"pin": { … } }
Los tres campos son opcionales. text y card salen como un mensaje del agente, con su notificación. pin pone, actualiza o saca la pastilla que queda fija arriba del chat.
Tres cosas que importan de esto:
- No despierta al modelo ni le cobra a nadie. Es el agente hablando, no una respuesta generada.
- No vence por tiempo. Vale mientras el agente siga en ese chat. Si lo sacan, muere.
- No hace falta un segundo bot. Antes, para avisar por tu cuenta tenías que crear un bot externo con token sólo para publicar.
Si lo que querés es "pasó algo y que la IA actúe", eso es otra cosa: el callbackUrl de siempre.
Lo que tu agente puede mostrar
No está limitado a texto. Desde tus herramientas podés devolver tarjetas:
- Botones, para un sí o un no.
- Listas, de una opción o varias, con secciones.
- Formularios de hasta ocho campos, con respuestas guardadas arriba (por ejemplo, las direcciones que esa persona ya usó).
- Catálogo con canasta: secciones, productos con foto y precio, y el pedido sale como un solo mensaje.
- Pedir la ubicación, una foto o un archivo. La respuesta llega como el mensaje de la persona con ese adjunto.
El modelo lee la tarjeta como texto, así que sabe qué le ofreció a la persona.
Fijar algo arriba del chat
La pastilla no es sólo para carritos. Es un estado que tu agente mantiene vivo y actualiza cuando quiere: un pedido en camino, un turno, una guardia, un conteo.
Se puede fijar para todo el chat o sólo para una persona.
Por qué esto no existe en otros lados
Es el punto que más nos preguntan, así que va derecho: buscamos "MCP" en toda la documentación de bots de Telegram y no aparece. WhatsApp tiene un MCP oficial, pero es para administrar tu integración (crear plantillas, registrar números), no para darle herramientas a un bot en tiempo de ejecución.
Podés programar todo eso a mano en cualquier plataforma. MCP es justamente el trabajo que te ahorrás.
La comparación completa está en esta nota, y el detalle de cada campo en la documentación.