Pleaxy
Documentação

Conectar um agente de IA

Dê ao Claude, ao ChatGPT ou a qualquer outro cliente MCP as ferramentas para os seus pedidos de compra, faturas e aprovações, conectado como você.

Visão geral

O servidor MCP da Pleaxy dá a um agente de IA, como o Claude ou o ChatGPT, ferramentas para os seus pedidos de compra, faturas, recebimentos e aprovações. Você o conecta à sua própria conta da Pleaxy: ele vê o que você vê, nos espaços de trabalho que você escolher, e cada alteração que ele faz fica registrada como sua. As decisões continuam com você.

Há duas formas de conectar. Um app que se conecta a servidores MCP por URL, como o claude.ai, os apps do Claude ou o ChatGPT, usa o servidor hospedado da Pleaxy, sem nada para instalar. Um cliente MCP no seu computador, como o Claude Desktop, o Claude Code ou o Cursor, pode rodar o próprio servidor com npx. As duas se conectam do mesmo jeito: a Pleaxy abre no seu navegador, você entra, marca os espaços de trabalho e permite.

Conectar um app por URL

Nas configurações de conectores do seu app, adicione um conector personalizado com este endereço. Não há ID de cliente nem chave para informar: o próprio app se registra na Pleaxy.

connector URL
https://mcp.pleaxy.ai/mcp
  1. Conecte. O app abre a Pleaxy no seu navegador. Entre como você sempre faz: senha, chave de acesso ou o login único da sua empresa.
  2. Escolha os espaços de trabalho. A Pleaxy mostra qual app está pedindo e para onde ele vai levar você de volta. Marque os espaços de trabalho que o agente pode usar e selecione Permitir.
  3. Use. De volta ao app, pergunte sobre os seus pedidos de compra ou faturas. O app mantém a conexão; você não precisa entrar de novo por 30 dias.

Rodar no seu computador

O servidor está no npm como pleaxy-mcp e precisa do Node.js 22.18 ou posterior. Conecte-o uma vez a partir de um terminal: a Pleaxy abre no seu navegador, onde você entra, marca os espaços de trabalho e permite.

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

Depois, adicione-o à configuração do seu cliente MCP. Sem uma chave de API definida, o servidor age como você. O login fica armazenado no seu computador, legível só por você, e todo cliente MCP ali que rodar o servidor o compartilha.

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

Espaços de trabalho

Um agente usa só os espaços de trabalho que você marcou ao conectá-lo. Cada ferramenta recebe um workspace, e list_workspaces lista os nomes deles, então uma única conexão funciona em todos. Com um só espaço de trabalho permitido, o agente usa esse.

Para adicionar ou remover um espaço de trabalho, conecte o agente de novo e marque outro conjunto. Se você perder o acesso a um espaço de trabalho na Pleaxy, o agente também perde.

O que um agente pode fazer

Um agente pode ler e redigir tudo o que a sua função permite: encontrar pedidos de compra e faturas, consultar os gastos com IA, conciliar uma fatura, abrir uma solicitação de compra. As decisões são diferentes. Aprovar ou rejeitar uma fatura, encaminhar uma divergência para aprovação, registrar um pagamento, criar ou aprovar um pedido de compra, confirmar um recebimento, decidir sobre uma folha de registro de serviços e definir o limite de gastos de um provedor e, no caso de um fornecedor, confirmar que um pagamento chegou ou informar que não chegou, são enviados a você como solicitações do agente. Você confirma ou cancela cada uma na Pleaxy em até 24 horas, e nada acontece até que você o faça. Rejeitar um pedido de compra cuja etapa de aprovação indica você acontece na hora, como no Pleaxy Assistant.

Um agente nunca confirma as próprias solicitações e não pode alterar as suas configurações de segurança, as chaves de API nem os membros do espaço de trabalho. A Pleaxy registra cada alteração que um agente faz ou pede.

Seus agentes conectados

A Pleaxy avisa você sempre que um agente se conecta à sua conta. Você vê cada agente conectado, com o app em que ele roda, os espaços de trabalho dele e quando foi usado pela última vez, na Pleaxy em Segurança e login → Agentes, onde pode desconectar cada um.

Uma conexão dura 30 dias. Ela termina antes se você desconectar o agente, redefinir a sua senha, desativar a verificação em duas etapas ou for bloqueado na Pleaxy. Nesse caso, conecte-o de novo. Você pode ter até 20 agentes conectados.

Integrações com uma chave de API

Para uma integração que roda sem uma pessoa, o servidor no seu computador pode usar uma chave de API do espaço de trabalho em vez do seu login (veja Agentes de IA (MCP)). Uma chave age em um único espaço de trabalho, e as decisões são recusadas a ela: elas exigem uma pessoa. O servidor hospedado não aceita chaves de API.

Fale conosco