Cómo exponer tus APIs a agentes de IA sin darles las llaves

Tienes una API de pedidos, de facturación o de inventario, bien documentada y en producción. Y ahora quieres que un agente de IA la use. El camino rápido es darle un token de servicio y dejarle llamar. El problema es que ese token no distingue entre consultar un pedido y borrarlo: el agente puede hacer todo lo que el token permita, y lo hará si alguien consigue colarle la instrucción adecuada.

Con Ploybot la API no se entrega entera. Se publican operaciones concretas, cada una con su política, y el agente las ve como tools por MCP. La credencial nunca sale del gateway.

1. Conecta el destino

Lo primero es decirle a Ploybot dónde está la API y cómo se autentica: URL base y credencial. Puede ser un token, usuario y contraseña, una API key en cabecera o en query, o un login OAuth delegado si la API lo pide. La credencial se guarda cifrada y solo la resuelve el gateway en el momento de llamar.

Al darla de alta, Ploybot comprueba la conexión. Un destino que no responde se ve en ese momento, no cuando el agente está a mitad de una tarea.

2. Importa su contrato

No hace falta describir las operaciones a mano. Ploybot lee el contrato que ya tienes:

• OpenAPI 3, en YAML o JSON, pegado o descargado del propio destino.
• WSDL de un servicio SOAP 1.1.
• FileDescriptorSet de un servicio gRPC.
• Las tools de un servidor MCP de terceros.

Importar propone, no crea nada. Verás cada operación con los argumentos que pedirá y la política que se le aplicaría, y quién la ha decidido: el dueño de la API o Ploybot por omisión.

ploybot alta openapi --conexion=conn_pedidos --url=https://api.tuempresa.com/openapi.json --prefijo=pedidos

3. Revisa y publica, una a una

Publicar se hace por nombre. No existe «publicar todas», porque ese paso es la revisión: alguien de tu organización elige qué puede tocar un agente.

Si quien mantiene la API quiere adelantar el trabajo, puede marcarlo en el propio OpenAPI con la extensión x-agent:

x-agent:
  expose: true
  capability: {name: pagos.execute}
  constraints: {maxAmount: 500}
  approval: {requiredAbove: 100, parameter: amount}

Eso se lee así: se propone publicarla, un importe por encima de 500 se deniega y por encima de 100 lo decide una persona. Sin x-agent, el criterio es conservador: las lecturas (GET) se permiten y todo lo demás pide aprobación. Siempre en esa dirección, nunca al revés.

La petición la escribe la capability, no el agente

Este es el punto importante. El agente no compone HTTP: no elige método, ni ruta, ni qué campos lleva el cuerpo. Eso quedó fijado al publicar. El agente solo rellena los huecos, y Ploybot los valida contra el esquema y los escapa según dónde caen: un valor en la ruta no puede salirse de su segmento, y un número tiene que ser un número.

Una operación publicada es, por tanto, algo mucho más estrecho que «acceso a la API»: es POST /orders/{order_id}/refunds con un importe como máximo de tanto, y con una persona delante si pasa de cierto umbral.

4. Pruébala antes de dársela a nadie

Desde la consola (Probar) o con ploybot invocar, puedes llamar a la operación publicada y ver la respuesta real del destino, sin pasar por un agente. Así compruebas que el alta está bien antes de que la use nadie.

5. Asígnala a un agente

Cuando asignas la capability a un agente, aparece en su tools/list la próxima vez que pregunte. Cada tool dice a qué conexión pertenece, para que el modelo no mezcle identificadores de una API con los de otra. Y cada llamada deja su expediente: qué se pidió, qué política se aplicó, quién lo aprobó, qué llegó al destino y qué contestó.

¿Y si la API está dentro de tu red?

Para las APIs que no se pueden publicar en Internet, el gateway se instala dentro de tu red o de tu cuenta cloud. Es él quien llama al control plane, nunca al revés, así que no hay que abrir ningún puerto de entrada. Ejecuta HTTP, SOAP, gRPC y MCP, y resuelve las credenciales donde vive: el control plane solo guarda referencias.

Empieza por una

La mejor forma de verlo es con una operación de lectura de una API que ya tengas. La prueba de Ploybot dura 14 días y no pide tarjeta. Si quieres que lo hagamos juntos, escríbenos desde el formulario de contacto.