Peon
Diga ao seu IA o cliente. A Peon cuida das contas.
Documentação
Conecte o Peon ao seu agente de IA.
Crie um cliente, atribua as contas de aplicativo corretas, conecte o servidor MCP remoto do Peon com OAuth e verifique as cinco ferramentas cientes do cliente antes da primeira solicitação roteada.
O painel Connect requer uma conta Peon. Novos usuários podem criar uma gratuitamente e depois voltar aqui para conectar sua IA.
Comece pela ferramenta que você já usa.
Cada ferramenta de IA tem uma página pública de transferência dedicada. O guia completo abaixo mantém o endpoint compartilhado, os comandos e a solução de problemas em um só lugar.
Prepare o grafo do cliente. Depois conecte a IA.
A configuração do cliente e das contas pertence ao Peon. A instalação do agente pode ocorrer antes ou depois, mas o cliente precisa de contas atribuídas antes que o trabalho útil possa ser roteado.
- AC
01
Crie o cliente
Adicione a pessoa ou empresa que sua IA deve reconhecer. - 02
Atribua as contas deles
Anexe o e-mail, arquivos, análises e espaços de trabalho que pertencem a eles. - Somente leitura
03
Escolha o acesso deles
Defina acesso total, somente leitura ou selecionado e declare o limite de dados do cliente. - 04
Conecte sua IA
Autorize a ferramenta de IA que você usa uma vez. Depois disso, comece com o nome do cliente.
Início rápido
Crie o cliente e atribua as contas de aplicativo dele antes de pedir que sua IA trabalhe pelo nome do cliente.
- 01
Crie um cliente
Adicione o nome, empresa opcional, apelidos e notas que o Peon deve reconhecer. - 02
Atribua contas de aplicativo
Anexe as contas de aplicativo exatas que pertencem ao cliente e escolha o modo de acesso. - 03
Declare limites de dados
Quando necessário, especifique a caixa de entrada, propriedade, pasta, repositório, canal, página, banco de dados ou calendário no escopo. - 04
Conecte sua IA
Use o caminho OAuth específico da plataforma abaixo e depois atualize o catálogo de ferramentas MCP. - 05
Verifique cinco ferramentas
O Peon informa Conectado somente depois que esse agente autenticado exato solicita com sucesso tools/list.
OAuth primeiro
Clientes de IA compatíveis descobrem o OAuth do Peon pelo endpoint MCP remoto. Uma sessão anterior do navegador do Peon pode ser reutilizada; o agente ainda recebe sua própria concessão revogável.
https://www.connectpeon.com/api/mcp
Use um token de acesso pessoal somente quando um cliente MCP não puder usar OAuth. Crie-o em Avançado: chaves de acesso manual no painel Connect, armazene-o como segredo e nunca o envie para um repositório.
Claude
Para Claude web ou desktop, abra Configurações → Conectores → Adicionar conector personalizado, nomeie-o como Peon, cole o endpoint e escolha Conectar. Ative o Peon em Pesquisar e ferramentas em uma nova conversa. O Claude Code pode usar o comando abaixo.
claude mcp add --transport http peon https://www.connectpeon.com/api/mcp
Após a aprovação, peça ao Claude para usar o Peon uma vez para que ele atualize o catálogo de ferramentas. Consulte o guia de conector personalizado da Anthropic.
ChatGPT
O ChatGPT web não lê a configuração MCP local do Codex. Em um espaço de trabalho compatível, ative o modo de desenvolvedor para aplicativos personalizados, crie o Peon com o endpoint abaixo, escolha OAuth, examine as ferramentas e ative o aplicativo.
https://www.connectpeon.com/api/mcp
A disponibilidade de aplicativos MCP personalizados depende do plano do ChatGPT, das configurações do espaço de trabalho e da função. Se os controles estiverem ausentes, use o Codex ou outro host MCP compatível.
OpenAI Codex
Execute os dois comandos no terminal usado pelo Codex. O comando de login abre o OAuth do Peon no navegador. O Codex CLI, a extensão do IDE e o aplicativo de desktop compartilham a configuração MCP.
codex mcp add peon --url https://www.connectpeon.com/api/mcp
codex mcp login peon
Reinicie a sessão do Codex ou abra a visualização MCP após o login para que as cinco ferramentas do Peon sejam carregadas. Consulte a documentação oficial do Codex MCP.
Cursor
Use Adicionar ao Cursor no painel. Se o link do aplicativo não abrir, coloque o JSON abaixo no arquivo global ~/.cursor/mcp.json e depois abra Cursor Personalizar → MCP e ative o Peon.
{
"mcpServers": {
"peon": {
"url": "https://www.connectpeon.com/api/mcp"
}
}
}
Conclua o OAuth quando o Cursor solicitar e depois atualize ou reinicie os servidores MCP. Consulte a documentação oficial do Cursor MCP.
OpenCode
Um aplicativo de desktop não é necessário. Abra o terminal do VS Code ou outro shell onde o comando opencode funcione, adicione o Peon globalmente, conclua o OAuth e verifique a conexão.
opencode mcp add peon --global --url https://www.connectpeon.com/api/mcp
opencode mcp auth peon
opencode mcp list
Se a autenticação for bem-sucedida, mas o Peon não estiver visível, inicie uma nova sessão do OpenCode após o comando de lista. Consulte a documentação oficial do OpenCode MCP.
Outros clientes MCP
Crie um servidor remoto Streamable HTTP chamado Peon. Cole o endpoint e deixe a autenticação na descoberta automática de OAuth. Aprove o Peon e depois atualize o catálogo MCP do cliente.
Name: Peon
MCP endpoint: https://www.connectpeon.com/api/mcp
Transport: Streamable HTTP
Authentication: OAuth discovery
Solução de problemas
Autorizado significa que o consentimento foi bem-sucedido. Conectado significa que o Peon observou que esse agente autenticado exato carregou seu catálogo de cinco ferramentas.
O OAuth abriu e fechou imediatamente
A sessão existente do navegador do Peon provavelmente foi reutilizada. Atualize os servidores MCP do agente ou inicie uma nova sessão.
Autorizado, mas não Conectado
O agente não solicitou tools/list. Ative o Peon na ferramenta de IA e atualize o catálogo MCP.
Um comando não foi encontrado
Execute-o no ambiente onde esse CLI está instalado. Para o OpenCode instalado pelo VS Code, use o terminal do VS Code.
Um link de um clique não faz nada
O aplicativo de desktop pode estar ausente ou o navegador bloqueou o link do aplicativo. Use o comando manual ou a configuração dessa plataforma.
O catálogo ainda está ausente
Volte ao painel Connect e selecione Conectar para a mesma plataforma novamente. O Peon pode verificar novamente sem revogar uma concessão funcional.
O catálogo de cinco ferramentas
Uma IA compatível deve ver exatamente as cinco ferramentas do Peon abaixo. As ações do provedor são descobertas e executadas por essa superfície ciente do cliente.
01 find_client
02 get_client_context
03 search_client_tools
04 collect_client_updates
05 perform_client_tool
- 01
Prepare um resumo do cliente
Colete e-mails recentes, reuniões, notas, arquivos e atividade de projeto para o cliente que você nomear. - 02
Pesquise nos aplicativos do cliente
Encontre informações relevantes nas contas atribuídas de um cliente sem misturar outro cliente. - 03
Elabore relatórios e acompanhamentos
Transforme material de origem específico do cliente em um rascunho conciso que fique pronto para sua revisão. - 04
Colete atualizações de projeto
Pergunte o que mudou e obtenha uma atualização com tolerância a falhas nos aplicativos conectados que podem ser consultados com segurança. - 05
Execute ações controladas de aplicativo
Execute a ação solicitada pela conta exata do cliente e pelo modo de acesso que você atribuiu. - 06
Continue o trabalho recente
Deixe outro agente conectado continuar a partir dos resultados recentes sem copiar uma conversa completa.
Limites de segurança
O acesso controla o que a IA pode fazer. Um limite de dados do cliente separado controla qual caixa de entrada, pasta, repositório, propriedade, canal, página, banco de dados ou calendário está no escopo.
TotalSomente leituraSelecionado
Cada instalação de IA tem sua própria identidade revogável.
Execuções diretas repetidas usam proteção de idempotência para que uma alteração concluída não seja aplicada cegamente duas vezes.
Uma leitura de vários aplicativos pode retornar resultados úteis dos aplicativos disponíveis e identificar o que foi ignorado ou falhou.
Leia o modelo de segurança voltado ao cliente para obter a explicação completa sobre roteamento, acesso, limites, credenciais e continuação.