Conectá un agente en cinco minutos

Una demostración viva de Vanisur Platform: identidad, permisos acotados, topes de gasto y una auditoría que sólo se agrega, para un agente de IA. Sin cuenta, sin instalar nada y sin bajarse el repo: alcanzan las seis llamadas de abajo.

Demostración públicaplatform.demo.vanisur.comRead in English

Empresa inventada. La empresa es inventada y sus datos también. La demostración se borra y se siembra de nuevo cada 24 horas, así que lo que hagas acá mañana no está. No le pongas datos reales.

Los seis pasos

1 Pedí la credencial del dueño de la demostración
La demostración la entrega: es el dueño de una empresa ficticia. Guardala como DUENO.
```
curl -s https://platform.demo.vanisur.com/api/v1/demo
```
De la respuesta sale: credencial_dueno
2 Registrá tu agente
Nace sin poder hacer nada: ni un permiso. El token se muestra una sola vez — guardalo como AGENTE_TOKEN, y el id como AGENTE.
```
curl -s -X POST https://platform.demo.vanisur.com/api/v1/agentes \
  -H "authorization: Bearer $DUENO" \
  -H "content-type: application/json" \
  -d '{"nombre":"Agente de un desconocido d19995"}'
```
De la respuesta sale: agente.id · credencial.token

3 Dale un permiso

Negado por defecto: sin esta fila, la acción se niega. pedidos.consultar sólo lee, así que no lleva topes.

curl -s -X POST https://platform.demo.vanisur.com/api/v1/agentes/$AGENTE/permisos \
  -H "authorization: Bearer $DUENO" \
  -H "content-type: application/json" \
  -d '{"accion":"pedidos.consultar"}'

4 Preguntale al agente quién es

Por MCP (Streamable HTTP), con el token del agente. Contesta su identidad y qué puede hacer hoy.

curl -s -X POST https://platform.demo.vanisur.com/api/mcp \
  -H "authorization: Bearer $AGENTE_TOKEN" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"yo","arguments":{}}}'

5 Agarrá un pedido para preguntar por él
La acción pide el id de un pedido, y los pedidos los tiene el dueño. Guardá el primero como PEDIDO.
```
curl -s https://platform.demo.vanisur.com/api/v1/practica/pedidos \
  -H "authorization: Bearer $DUENO"
```
De la respuesta sale: pedidos[0].id

6 Corré la acción

La misma llamada con el nombre de la herramienta. Todo lo que hace el agente queda en la auditoría, que sólo se agrega.

curl -s -X POST https://platform.demo.vanisur.com/api/mcp \
  -H "authorization: Bearer $AGENTE_TOKEN" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"pedidos_consultar","arguments":{"pedido_id":"'$PEDIDO'"}}}'

Apuntá tu cliente MCP

Claude Desktop y Claude Code llegan a un servidor HTTP con mcp-remote; Cursor y VS Code pueden mandar la cabecera por su cuenta. Nuestra puerta toma un token al portador y no tiene OAuth: la credencial del agente es toda la autenticación.

Claude Desktop · Claude Code

{
  "mcpServers": {
    "vanisur-platform": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://platform.demo.vanisur.com/api/mcp",
        "--header",
        "Authorization:Bearer ${TOKEN_AGENTE}"
      ],
      "env": {
        "TOKEN_AGENTE": "vp_agente_…"
      }
    }
  }
}

Cursor · VS Code (mandan la cabecera ellos)

{
  "mcpServers": {
    "vanisur-platform": {
      "url": "https://platform.demo.vanisur.com/api/mcp",
      "headers": {
        "Authorization": "Bearer vp_agente_…"
      }
    }
  }
}

Qué pasó recién

Ese agente tiene identidad, un permiso acotado y un renglón en una auditoría que nadie puede editar, ni nosotros. Pedile algo para lo que no tiene permiso y se le niega, y la negación también queda escrita.

Lo mismo, en texto, para una máquina: /llms.txt · Las rutas y quién las puede llamar: la portada