plori

oficial

Crie e conduza agentes de nuvem plori (cada um é um agente de IA em seu próprio computador em nuvem)

O que você pode fazer com Plori MCP?

  • Listar e inspecionar Workspaces — Peça ao seu assistente para listar os Workspaces que você possui, com o estado, o agente padrão e a revisão atual.
  • Ler e enviar arquivos do Workspace — Leia um arquivo ou a listagem de um diretório de uma revisão salva, ou grave um arquivo nos arquivos atuais de um Workspace.
  • Enviar mensagens e obter resultados de execução — Envie uma mensagem para uma conversa de um Workspace e depois busque o status, os créditos, os tokens e a resposta da execução.
  • Gerenciar workers paralelos — Inicie workers em suas próprias cópias dos arquivos do Workspace, verifique o status deles, oriente um worker em execução ou pare um grupo de tarefas.
  • Revisar e mesclar changesets — Liste os changesets de um worker, veja os caminhos alterados e em conflito e depois aceite ou rejeite as alterações.
  • Tratar aprovações pendentes — Liste execuções pausadas aguardando uma aprovação ou pergunta e responda ou negue, com as aprovações abertas no app web.

Documentação

plori

O Plori executa agentes de IA que colaboram em um único produto na nuvem.

O Plori executa agentes de IA que colaboram em um único produto na nuvem. Código, pesquisa, conteúdo: cada um trabalha na sua própria cópia, e o Plori mescla as alterações de volta. Os agentes trabalham em um Workspace na nuvem que mantém os arquivos do produto com revisões salvas. Apenas os arquivos do Workspace persistem entre execuções. Você conversa com seus agentes no aplicativo web, ou os controla a partir das suas próprias ferramentas via MCP e REST.

Este repositório é a porta de entrada de integração. O produto em si fica em plori.ai; o servidor MCP remoto fica em https://api.plori.ai/mcp.

Conecte seu cliente MCP

O plori é um servidor MCP remoto (HTTP com streaming). Não há nada para instalar ou executar localmente. O login acontece no seu navegador via OAuth 2.1 na primeira vez que seu cliente se conecta; ambientes sem interface podem usar uma chave de API em vez disso.

Claude Code

Cole isto na sua conversa do Claude Code:

Configure https://plori.ai/SKILL.md

O Claude lê as instruções de configuração e configura o MCP se necessário. Se o novo servidor não tiver carregado, digite /reload-plugins quando o Claude perguntar, e continue na mesma conversa. Com o emparelhamento, abra o endereço curto que o Claude mostra, insira o código, faça login e aprove. Você pode usar um celular enquanto o Claude Code roda em uma máquina remota. Nenhuma skill ou plugin instalado é necessário.

Cursor

Use o botão de um clique Adicionar ao Cursor, ou adicione manualmente: Settings -> MCP -> Add server com 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

O Codex detecta automaticamente o OAuth do plori em login. Alternativa de instalação única com a skill incluída: codex plugin marketplace add plori-ai/codex-plugin e depois codex plugin add plori@plori.

Cline

Siga o llms-install.md, escrito para o instalador automatizado do Cline.

Qualquer outro cliente

Clientes nativos de HTTP com streaming se conectam a https://api.plori.ai/mcp diretamente. Clientes que só falam stdio podem fazer a ponte com o pacote npm plori-mcp (um wrapper fino em torno de mcp-remote com o endpoint fixado; este repositório é a fonte dele):

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

As chaves de API são geradas em Dashboard -> Settings em uma conta registrada.

Ou pule o MCP: seu próprio terminal

A CLI do plori não é um cliente MCP. É uma porta própria, e ela abre a mesma sessão ao vivo que o aplicativo web mostra: o histórico recente, um prompt, saída em streaming e a fila de aprovações em um só lugar. Um turno que você envia no terminal aparece em uma aba do navegador aberta enquanto é transmitido.

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

O instalador coloca um único binário estático em ~/.local/bin e não precisa de Node; se esse diretório ainda não estiver no seu PATH, o script imprime a linha a adicionar. npm i -g @plori/cli works too. The argument to attach é um nome de agente, um id de agente ou um id de sessão, então um id de sessão copiado do aplicativo web funciona sozinho. Ctrl-D desanexa e deixa a execução continuando no servidor.

O terminal não dá ao agente acesso aos seus arquivos locais. O shell e os arquivos do Workspace estão na nuvem do Plori.

Verifique a conexão

Pergunte ao seu cliente:

Liste meus Workspaces do plori e me diga quantos créditos eu ainda tenho.

Você deve ver chamadas de ferramenta list_workspaces e get_credits e uma resposta real.

O que as ferramentas fazem

O servidor expõe 24 ferramentas em cinco grupos. Um Workspace contém arquivos duráveis com revisões salvas, uma conversa principal e histórico de execuções. Um agente roda em um Workspace com um shell e os arquivos do Workspace em /workspace.

  • Workspaces e conta: list_workspaces (os Workspaces que você possui, com estado, agente padrão, revisão atual e storage_readiness enquanto o armazenamento inicia), create_workspace (um Workspace com sua primeira revisão. A menos que você passe default_manager_agent_id, ele também cria um agente padrão. idempotency_key faz uma nova tentativa retornar o mesmo Workspace), delete_workspace (excluir permanentemente um Workspace com seus arquivos, revisões, cópias e conversas), read_workspace_file (um arquivo ou uma listagem de diretório em uma revisão salva), upload_workspace_file (gravar um arquivo nos arquivos atuais de um Workspace, substituindo qualquer arquivo no caminho; passe texto UTF-8 como content, ou omita content para um upload_url único para um arquivo maior ou binário), get_workspace_costs (o valor cobrado pelas execuções de um Workspace ou de um grupo de tarefas em uma janela de tempo), get_credits (saldo pré-pago, plano e limites).
  • Execuções: send_workspace_message (enviar uma mensagem para uma conversa de Workspace e aguardar a resposta, com wait_seconds para definir por quanto tempo esperar, idempotency_key para fazer uma nova tentativa retornar a execução original, e callback_url mais callback_secret para postar uma notificação de status assinada no seu endpoint), get_run_result (o status de uma execução, timestamps, créditos, tokens, progresso das ferramentas e a resposta quando ela termina; para um gerente de Workspace que aguarda seus workers, worker_inputs lista as perguntas e aprovações abertas dos workers e next_run_id nomeia a execução que a continua), list_runs (o histórico de execuções de um agente, mais recente primeiro), cancel_run (parar uma execução em andamento, que reporta cancelling e depois cancelled), schedule_run (executar um agente uma vez mais tarde, após um atraso ou em um timestamp. Ele retorna awaiting_confirmation e um confirm_url. O Plori enfileira a execução somente depois que você a confirma no aplicativo web do Plori).
  • Human-in-the-loop: list_pending_inputs (execuções pausadas em uma aprovação ou em uma solicitação de entrada), answer_pending_input (negar uma, ou responder a uma pergunta do agente, o que inicia uma execução de continuação). Um cliente MCP não pode aprovar uma ação: cada aprovação pausada carrega um approve_url que você abre no aplicativo web do Plori.
  • Workers: create_workspace_worker (iniciar um agente na sua própria cópia dos arquivos do Workspace, para que vários workers rodem ao mesmo tempo sem alterar os arquivos uns dos outros), list_workspace_workers e get_workspace_worker (status, execução e se o Plori salvou os arquivos do worker), steer_workspace_worker (enviar uma mensagem para o turno de um worker em execução), stop_workspace_task_group (parar todos os workers de um grupo de tarefas).
  • Changesets: quando a execução de um worker termina normalmente e altera pelo menos um arquivo, o Plori envia seus arquivos salvos e aceita uma comparação limpa por conta própria. submit_workspace_changeset (enviar os arquivos salvos de um worker cuja execução terminou em erro, foi cancelada ou foi interrompida, para comparação com os arquivos atuais do Workspace), list_workspace_changesets e get_workspace_changeset (estado, fase e caminhos alterados e em conflito), accept_workspace_changeset (as alterações do worker se tornam os arquivos atuais do Workspace como uma nova revisão), reject_workspace_changeset (manter os arquivos do Workspace como estão).

Um turno que ainda está em execução quando o tempo de espera termina continua no servidor: send_workspace_message retorna um run_id com status running e um atraso de poll_after_seconds, e você lê a resposta com get_run_result usando wait=true (ou o seu próprio wait_seconds, até 1800).

Custos: executar agentes gasta créditos do plori da sua conta. Leitura (listas, resultados, saldos) é gratuita. A página de preços tem os detalhes. Revogue o acesso de um cliente a qualquer momento nas configurações do seu cliente, ou revogue a chave de API em Dashboard -> Settings.

Para agentes de IA lendo isto

Os pontos de entrada legíveis por máquina:

  • Porta de entrada: plori.ai/agents.md
  • Índice do site: plori.ai/llms.txt
  • Skill: SKILL.md (índice: /.well-known/agent-skills/index.json)
  • Cartão do servidor MCP: https://api.plori.ai/mcp/server-card
  • Descoberta OAuth: metadados de recurso protegido RFC 9728 em api.plori.ai, registro dinâmico de cliente suportado
  • Entrada no registro: ai.plori/plori no Registro MCP oficial

Toda página em plori.ai também é servida como Markdown: acrescente .md ao caminho ou envie Accept: text/markdown.

Documentação e suporte