plori

oficial

Crear y manejar agentes en la nube plori (cada uno un agente de IA en su propia computadora en la nube)

¿Qué puedes hacer con Plori MCP?

  • Listar e inspeccionar Workspaces — Pide a tu asistente que liste los Workspaces que posees con su estado, agente predeterminado y revisión actual.
  • Leer y subir archivos de Workspace — Lee un archivo o el listado de un directorio de una revisión guardada, o escribe un archivo en los archivos actuales de un Workspace.
  • Enviar mensajes y obtener resultados de ejecución — Envía un mensaje a una conversación de Workspace y luego obtén el estado de la ejecución, los créditos, los tokens y la respuesta.
  • Gestionar trabajadores paralelos — Inicia trabajadores sobre sus propias copias de los archivos del Workspace, consulta su estado, dirige a un trabajador en ejecución o detén un grupo de tareas.
  • Revisar y fusionar conjuntos de cambios — Lista los conjuntos de cambios de un trabajador, consulta las rutas modificadas y en conflicto, y luego acepta o rechaza los cambios.
  • Gestionar aprobaciones pendientes — Lista las ejecuciones pausadas por una aprobación o pregunta y respóndelas o recházalas, con las aprobaciones abiertas en la aplicación web.

Documentación

plori

Plori ejecuta agentes de IA que colaboran en un mismo producto en la nube.

Plori ejecuta agentes de IA que colaboran en un mismo producto en la nube. Código, investigación, contenido: cada uno trabaja sobre su propia copia, y Plori fusiona sus cambios de vuelta. Los agentes trabajan en un Workspace en la nube que conserva los archivos del producto con revisiones guardadas. Solo los archivos del Workspace persisten entre ejecuciones. Hablas con tus agentes en la aplicación web, o los controlas desde tus propias herramientas mediante MCP y REST.

Este repositorio es la puerta de entrada de integración. El producto en sí vive en plori.ai; el servidor MCP remoto vive en https://api.plori.ai/mcp.

Conecta tu cliente MCP

plori es un servidor MCP remoto (HTTP con streaming). No hay nada que instalar ni ejecutar localmente. El inicio de sesión ocurre en tu navegador mediante OAuth 2.1 la primera vez que tu cliente se conecta; los entornos sin interfaz pueden usar una clave de API en su lugar.

Claude Code

Pega esto en tu conversación de Claude Code:

Set up https://plori.ai/SKILL.md

Claude lee las instrucciones de configuración y configura MCP si es necesario. Si el nuevo servidor no se ha cargado, escribe /reload-plugins cuando Claude lo pida y luego continúa en la misma conversación. Con el emparejamiento, abre la dirección corta que muestra Claude, introduce el código, inicia sesión y aprueba. Puedes usar un teléfono mientras Claude Code se ejecuta en una máquina remota. No se requiere ninguna skill ni plugin instalado.

Cursor

Usa el botón de un clic Add to Cursor, o añádelo manualmente: Settings -> MCP -> Add server con la URL https://api.plori.ai/mcp.

VS Code

code --add-mcp '{"name":"plori","type":"http","url":"https://api.plori.ai/mcp"}'

Codex CLI

codex mcp add plori --url https://api.plori.ai/mcp
codex mcp login plori

Codex detecta automáticamente el OAuth de plori en login. Alternativa de una sola instalación con la skill incluida: codex plugin marketplace add plori-ai/codex-plugin y luego codex plugin add plori@plori.

Cline

Sigue llms-install.md, escrito para el instalador automatizado de Cline.

Cualquier otro cliente

Los clientes nativos de HTTP con streaming se conectan a https://api.plori.ai/mcp directamente. Los clientes que solo hablan stdio pueden hacer de puente con el paquete npm plori-mcp (un envoltorio ligero alrededor de mcp-remote con el endpoint fijado; este repositorio es su código fuente):

npx plori-mcp
# headless / CI: authenticate with an API key instead of the OAuth flow
npx plori-mcp --header "Authorization: Bearer plori_sk_..."
# equivalent, without the wrapper:
npx mcp-remote https://api.plori.ai/mcp

Las claves de API se generan en Dashboard -> Settings en una cuenta registrada.

O prescinde de MCP: tu propia terminal

La CLI de plori no es un cliente MCP. Es una puerta propia, y abre la misma sesión en vivo que muestra la aplicación web: el historial reciente, un prompt, la salida en streaming y la cola de aprobaciones en un solo lugar. Un turno que envías en la terminal aparece en una pestaña del navegador abierta mientras se transmite.

curl -fsSL https://plori.ai/install.sh | sh
plori login && plori attach <agent-name>

El instalador coloca un único binario estático en ~/.local/bin y no necesita Node; si ese directorio aún no está en tu PATH, el script imprime la línea que debes añadir. npm i -g @plori/cli works too. The argument to attach es un nombre de agente, un id de agente o un id de sesión, así que un id de sesión copiado de la aplicación web funciona por sí solo. Ctrl-D se desconecta y deja la ejecución en marcha en el servidor.

La terminal no da al agente acceso a tus archivos locales. El shell y los archivos del Workspace están en la nube de Plori.

Verifica la conexión

Pregunta a tu cliente:

List my plori Workspaces and tell me how many credits I have left.

Deberías ver llamadas a las herramientas list_workspaces y get_credits y una respuesta real.

Qué hacen las herramientas

El servidor expone 24 herramientas en cinco grupos. Un Workspace contiene archivos duraderos con revisiones guardadas, una conversación principal y el historial de ejecuciones. Un agente se ejecuta en un Workspace con un shell y los archivos del Workspace bajo /workspace.

  • Workspaces y cuenta: list_workspaces (los Workspaces que posees, con estado, agente predeterminado, revisión actual y storage_readiness mientras se inicia el almacenamiento), create_workspace (un Workspace con su primera revisión. A menos que pases default_manager_agent_id, también crea un agente predeterminado. idempotency_key hace que un reintento devuelva el mismo Workspace), delete_workspace (eliminar permanentemente un Workspace con sus archivos, revisiones, copias y conversaciones), read_workspace_file (un archivo o un listado de directorio en una revisión guardada), upload_workspace_file (escribir un archivo en los archivos actuales de un Workspace, reemplazando cualquier archivo en la ruta; pasa texto UTF-8 como content, u omite content para un upload_url de un solo uso para un archivo más grande o binario), get_workspace_costs (el importe cobrado por las ejecuciones de un Workspace o de un grupo de tareas en una ventana de tiempo), get_credits (saldo prepago, plan y límites).
  • Ejecuciones: send_workspace_message (enviar un mensaje a una conversación de un Workspace y esperar la respuesta, con wait_seconds para establecer cuánto tiempo esperar, idempotency_key para hacer que un reintento devuelva la ejecución original, y callback_url más callback_secret para enviar una notificación de estado firmada a tu endpoint), get_run_result (el estado de una ejecución, marcas de tiempo, créditos, tokens, progreso de herramientas y la respuesta una vez que termina; para un gestor de Workspace que espera a sus workers, worker_inputs lista las preguntas y aprobaciones abiertas de los workers y next_run_id nombra la ejecución que la continúa), list_runs (el historial de ejecuciones de un agente, más reciente primero), cancel_run (detener una ejecución en curso, que informa cancelling y luego cancelled), schedule_run (ejecutar un agente una vez más tarde, tras un retraso o en una marca de tiempo. Devuelve awaiting_confirmation y un confirm_url. Plori encola la ejecución solo después de que la confirmes en la aplicación web de Plori).
  • Intervención humana: list_pending_inputs (ejecuciones pausadas por una aprobación o una solicitud de entrada), answer_pending_input (denegar una, o responder a la pregunta de un agente, lo que inicia una ejecución de continuación). Un cliente MCP no puede aprobar una acción: cada aprobación pausada lleva un approve_url que abres en la aplicación web de Plori.
  • Workers: create_workspace_worker (iniciar un agente sobre su propia copia de los archivos del Workspace, de modo que varios workers se ejecutan al mismo tiempo sin cambiar los archivos de los demás), list_workspace_workers y get_workspace_worker (estado, ejecución y si Plori guardó los archivos del worker), steer_workspace_worker (enviar un mensaje al turno de un worker en ejecución), stop_workspace_task_group (detener todos los workers de un grupo de tareas).
  • Changesets: cuando la ejecución de un worker termina normalmente y cambia al menos un archivo, Plori envía sus archivos guardados y acepta una comparación limpia por sí mismo. submit_workspace_changeset (enviar los archivos guardados de un worker cuya ejecución terminó con error, fue cancelada o fue detenida, para compararlos con los archivos actuales del Workspace), list_workspace_changesets y get_workspace_changeset (estado, fase y rutas cambiadas y en conflicto), accept_workspace_changeset (los cambios del worker pasan a ser los archivos actuales del Workspace como una nueva revisión), reject_workspace_changeset (mantener los archivos del Workspace tal como están).

Un turno que sigue en ejecución cuando termina la espera continúa en el servidor: send_workspace_message devuelve un run_id con estado running y un retraso de poll_after_seconds, y lees la respuesta con get_run_result usando wait=true (o tu propio wait_seconds, hasta 1800).

Costes: ejecutar agentes gasta créditos de plori de tu cuenta. Leer (listas, resultados, saldos) es gratis. La página de precios tiene los detalles. Revoca el acceso de un cliente en cualquier momento en la configuración de tu cliente, o revoca la clave de API en Dashboard -> Settings.

Para agentes de IA que lean esto

Los puntos de entrada legibles por máquina:

  • Puerta de entrada: plori.ai/agents.md
  • Índice del sitio: plori.ai/llms.txt
  • Skill: SKILL.md (índice: /.well-known/agent-skills/index.json)
  • Tarjeta del servidor MCP: https://api.plori.ai/mcp/server-card
  • Descubrimiento de OAuth: metadatos de recurso protegido RFC 9728 en api.plori.ai, con registro dinámico de clientes compatible
  • Entrada en el registro: ai.plori/plori en el Registro MCP oficial

Todas las páginas de plori.ai también se sirven como Markdown: añade .md a la ruta o envía Accept: text/markdown.

Documentación y soporte