plori
oficialCrie 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 estorage_readinessenquanto o armazenamento inicia),create_workspace(um Workspace com sua primeira revisão. A menos que você passedefault_manager_agent_id, ele também cria um agente padrão.idempotency_keyfaz 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 comocontent, ou omitacontentpara umupload_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, comwait_secondspara definir por quanto tempo esperar,idempotency_keypara fazer uma nova tentativa retornar a execução original, ecallback_urlmaiscallback_secretpara 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_inputslista as perguntas e aprovações abertas dos workers enext_run_idnomeia 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 reportacancellinge depoiscancelled),schedule_run(executar um agente uma vez mais tarde, após um atraso ou em um timestamp. Ele retornaawaiting_confirmatione umconfirm_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 umapprove_urlque 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_workerseget_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_changesetseget_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/plorino 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
- Guia de conexão (por cliente, mantido atualizado)
- Documentação
- Privacidade e termos
- Dúvidas: agent@plori.ai