Pleaxy
Documentación

Conectar un agente de IA

Dale a Claude, ChatGPT o cualquier otro cliente MCP las herramientas para tus órdenes de compra, facturas y aprobaciones, con tu propia sesión iniciada.

Introducción

El servidor MCP de Pleaxy da a un agente de IA, como Claude o ChatGPT, herramientas para tus órdenes de compra, facturas, recepciones y aprobaciones. Lo conectas a tu propia cuenta de Pleaxy: ve lo que tú ves, en los espacios de trabajo que elijas, y cada cambio que hace queda registrado a tu nombre. Las decisiones siguen siendo tuyas.

Hay dos formas de conectarlo. Una aplicación que se conecta a servidores MCP por URL, como claude.ai, las aplicaciones de Claude o ChatGPT, usa el servidor alojado de Pleaxy, sin instalar nada. Un cliente MCP en tu computadora, como Claude Desktop, Claude Code o Cursor, puede ejecutar el servidor por su cuenta con npx. Ambas se conectan igual: Pleaxy se abre en tu navegador, inicias sesión, marcas los espacios de trabajo y lo permites.

Conectar una aplicación por URL

En la configuración de conectores de tu aplicación, añade un conector personalizado con esta dirección. No hay ID de cliente ni clave que introducir: la aplicación se registra sola en Pleaxy.

connector URL
https://mcp.pleaxy.ai/mcp
  1. Conéctalo. La aplicación abre Pleaxy en tu navegador. Inicia sesión como siempre: con contraseña, passkey o el inicio de sesión único de tu empresa.
  2. Elige los espacios de trabajo. Pleaxy muestra qué aplicación lo pide y a dónde te devolverá. Marca los espacios de trabajo que el agente puede usar y selecciona Permitir.
  3. Úsalo. De vuelta en la aplicación, pregunta por tus órdenes de compra o tus facturas. La aplicación mantiene la conexión; no vuelves a iniciar sesión durante 30 días.

Ejecutarlo en tu computadora

El servidor está en npm como pleaxy-mcp y necesita Node.js 22.18 o posterior. Inicia sesión con él una vez desde una terminal: Pleaxy se abre en tu navegador, donde inicias sesión, marcas los espacios de trabajo y lo permites.

shell
export PLEAXY_API_BASE_URL="https://api.pleaxy.ai"
npx -y pleaxy-mcp login     # opens Pleaxy: sign in, tick the workspaces, Allow
npx -y pleaxy-mcp whoami    # who the server acts as, and its workspaces
npx -y pleaxy-mcp logout    # disconnects it

Después añádelo a la configuración de tu cliente MCP. Sin una clave de API configurada, el servidor actúa como tú. La sesión se guarda en tu computadora, solo tú puedes leerla, y la comparten todos los clientes MCP de esa computadora que ejecutan el servidor.

mcp config · json
{
  "mcpServers": {
    "pleaxy": {
      "command": "npx",
      "args": ["-y", "pleaxy-mcp"],
      "env": {
        "PLEAXY_API_BASE_URL": "https://api.pleaxy.ai"
      }
    }
  }
}

Espacios de trabajo

Un agente solo usa los espacios de trabajo que marcaste al conectarlo. Cada herramienta recibe un workspace, y list_workspaces los enumera, así que una sola conexión sirve para todos. Si solo permitiste un espacio de trabajo, el agente usa ese.

Para añadir o quitar un espacio de trabajo, vuelve a conectar el agente y marca otro conjunto. Si pierdes el acceso a un espacio de trabajo en Pleaxy, el agente también lo pierde.

Qué puede hacer un agente

Un agente puede leer y preparar borradores de todo lo que permite tu rol: buscar órdenes de compra y facturas, revisar el gasto en IA, conciliar una factura, crear una solicitud de compra. Las decisiones son otra cosa. Aprobar o rechazar una factura, enviar una discrepancia a aprobación, registrar un pago, crear o aprobar una orden de compra, confirmar una recepción, resolver una hoja de entrada de servicios y fijar el límite de gasto de un proveedor, y, en el caso de un proveedor, confirmar que llegó un pago o informar de que no llegó, se te envían como solicitudes del agente. Confirmas o cancelas cada una en Pleaxy en un plazo de 24 horas, y no pasa nada hasta que lo haces. Rechazar una orden de compra cuyo paso de aprobación te indica a ti ocurre de inmediato, igual que en Pleaxy Assistant.

Un agente nunca confirma sus propias solicitudes, y no puede cambiar tu configuración de seguridad, tus claves de API ni los miembros del espacio de trabajo. Pleaxy registra cada cambio que un agente hace o pide.

Tus agentes conectados

Pleaxy te avisa cada vez que un agente se conecta a tu cuenta. Ves cada agente conectado, con la aplicación en la que se ejecuta, sus espacios de trabajo y cuándo se usó por última vez, en Pleaxy, en Seguridad e inicio de sesión → Agentes, donde puedes cerrar la sesión de cada uno.

Una conexión dura 30 días. Termina antes si cierras la sesión del agente, restableces tu contraseña, desactivas la verificación en dos pasos o se bloquea tu acceso a Pleaxy. En ese caso, vuelve a conectarlo. Puedes tener hasta 20 agentes conectados.

Integraciones con una clave de API

Para una integración que funciona sin una persona, el servidor en tu computadora puede usar una clave de API del espacio de trabajo en lugar de tu sesión (consulta Agentes de IA (MCP)). Una clave actúa en un solo espacio de trabajo, y las decisiones se le rechazan: necesitan a una persona. El servidor alojado no acepta claves de API.

Habla con nosotros