plori

plori

plori (plori.ai): um agente de IA em nuvem com seu próprio ambiente persistente - disco durável, ferramentas CLI reais e memória.

plori fornece o agente: cada um recebe uma máquina persistente com um disco real, ferramentas reais e memória própria. Agentes ociosos são reduzidos a zero. Você conversa com seus agentes no aplicativo web, ou os controla a partir de suas próprias ferramentas via MCP e REST.

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

Conecte seu cliente MCP

plori é um servidor MCP remoto (HTTP streamable). 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 conecta; ambientes headless podem usar uma chave de API.

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 carregou, digite /reload-plugins quando o Claude perguntar, e continue na mesma conversa. Com o pareamento, abra o endereço curto que o Claude mostra, insira o código, faça login e aprove. Você pode usar um telefone 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 llms-install.md, escrito para o instalador automatizado do Cline.

Qualquer outro cliente

Clientes nativos de streamable-HTTP conectam-se 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 é sua fonte):

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

Chaves de API são geradas em Dashboard -> Configurações em uma conta registrada.

Ou pule o MCP: seu próprio terminal

O CLI do plori não é um cliente MCP. É uma porta própria, e 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. Uma interação que você envia no terminal aparece em uma aba aberta do navegador enquanto transmite.

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

O instalador coloca um binário estático em ~/.local/bin e não precisa de Node; se esse diretório não estiver no seu PATH ainda, o script imprime a linha para 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, o disco e os arquivos são o ambiente de nuvem próprio do agente.

Verifique a conexão

Pergunte ao seu cliente:

Liste meus agentes plori e me diga quantos créditos me restam.

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

O que as ferramentas fazem

O servidor expõe 25 ferramentas em cinco grupos.

• Agentes (o Plori Router escolhe o modelo de cada agente por tarefa): list_agents (seus agentes, com modelo e status de sessão ao vivo), get_agent (nome, tipo, modelo e status de um agente, além de sua caixa de correio com mensagens de outros agentes na conta), create_agent (obter ou criar um agente por nome, que reutiliza um agente existente com esse nome em vez de criar uma duplicata), delete_agent (excluir permanentemente um agente e revogar seu disco).
• Execuções: invoke_agent (enviar uma mensagem e aguardar a resposta, com wait_seconds para definir por quanto tempo manter, 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 (status de uma execução, carimbos de tempo, créditos, tokens, progresso das ferramentas e a resposta quando termina), list_runs (histórico de execuções de um agente, mais recentes primeiro), cancel_run (parar uma execução em andamento, que reporta cancelling e depois cancelled), schedule_run (invocar um agente uma vez mais tarde, após um atraso ou em um carimbo de tempo).
• Humano no circuito: list_pending_inputs (execuções pausadas em uma aprovação ou uma solicitação de entrada), answer_pending_input (aprovar, negar ou responder uma, que inicia uma execução de continuação).
• Fluxos de trabalho: list_workflows (todos os fluxos, ou os de um agente com agent_id, ou os não atribuídos com agent_id="none"), get_workflow (metadados e a projeção de etapas fixada para execução), get_workflow_version (definição completa e valores de parâmetros de uma versão exata), create_workflow (um fluxo vazio em um gatilho manual, cron ou webhook, para um agente construir), edit_workflow (um lote de edições restritas como um novo rascunho, sob compare-and-swap em base_version), set_workflow_agent (atribuir um dos seus agentes a um fluxo, tipicamente após delete_agent reportar fluxos pausados ou run_workflow retornar workflow_agentless), run_workflow (executar um fluxo construído agora, como uma execução real e cobrada), list_workflow_executions (execuções recentes com status, falha, fonte do gatilho, tempo e créditos), get_workflow_execution (entrada e saída por etapa de uma execução).
• Conta: get_credits (saldo e plano), get_usage (gasto por medidor e por agente), get_disk (bytes incluídos, comprados e usados), empty_trash (esvaziar permanentemente a lixeira de um agente para que arquivos excluídos parem de contar contra o disco; apenas enquanto o pod desse agente estiver adormecido), list_connections (seus provedores OAuth de terceiros com status, tempos de autorização e expiração, e os escopos configurados para cada um, nunca tokens ou segredos de cliente).

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

Custos: criar e executar agentes gasta créditos plori da sua conta. Ler (listas, resultados, saldos) é gratuito. 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 -> Configurações.

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 do registro: ai.plori/plori no Registro MCP oficial

Toda página em plori.ai também é servida como Markdown: anexe .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
• Perguntas: agent@plori.ai