Conector MCP do ProxyAI

O que você pode fazer

O conector MCP do ProxyAI dá a um assistente acesso aos seus bots, aos tickets do Helpdesk e às Tarefas de Agente. A versão 1.0.0 inclui oito ferramentas de leitura e onze ferramentas que fazem alterações.

Peça que ele resuma tickets abertos, inspecione uma resposta preparada, revise as execuções recentes de uma Tarefa de Agente ou explique um plano retido. Com permissão de escrita, você pode pedir que ele envie uma resposta específica, atualize um ticket, crie uma tarefa de relatório compatível ou aprove uma execução compatível que você já revisou.

URL do servidor: https://www.proxyai.app/api/mcp

O endpoint público está disponível para conexões personalizadas. As listagens em diretórios estão sendo preparadas. Fluxos de ferramentas do ChatGPT hospedados foram testados com dados sintéticos. A revisão de diretório, os testes hospedados após alterações e a validação no Claude continuam sendo etapas de liberação separadas.

Antes de conectar

Use a sua conta do ProxyAI em um navegador comum. Um painel de loja embutido ou uma sessão em dispositivo móvel não consegue aprovar esta conexão. O conector não tem compra ou assinatura adicional: o Helpdesk e as Tarefas de Agente ainda precisam dos complementos já existentes no bot que você usa. Os limites normais de capacidade das Tarefas de Agente e as cobranças de execução continuam valendo.

A permissão cobre todos os seus bots atuais e futuros nesta conta. Na v1 não há opção de consentimento por bot. Conecte apenas um assistente em que você confie para receber as mensagens dos seus clientes e as informações das tarefas.

Conecte o Claude

Abra Personalizar → Conectores no Claude e escolha Adicionar conector personalizado. Em uma organização gerenciada, peça ao proprietário que o adicione antes.
Digite https://www.proxyai.app/api/mcp. Use o transporte HTTP, e não um endereço /sse.
Escolha login OAuth. Se o Claude oferecer uma escolha de cliente OAuth, use a identidade publicada do Claude. Você não precisa criar ID de cliente, segredo de cliente nem chave de API; o registro automático também é compatível.
Conecte-se e entre no ProxyAI pelo navegador. Revise a conta, a identidade do app e o endereço de retorno na página de consentimento.
Deixe Permitir alterações desmarcado para acesso somente leitura. Marque-o somente se quiser que este assistente faça alterações, e então escolha Conectar.
Ative o ProxyAI na conversa em + → Conectores e comece com “Liste meus bots do ProxyAI”.

Veja as instruções de conector personalizado do Claude para a interface atual.

Conecte o ChatGPT

Abra Plugins → Adicionar → Adicionar servidor MCP personalizado no ChatGPT. Digite https://www.proxyai.app/api/mcp e selecione OAuth.
Expanda Configurações avançadas de OAuth. Verifique se as URLs de autorização, de token e de registro encontradas pertencem a https://www.proxyai.app, se o recurso é https://www.proxyai.app/api/mcp e se o callback é https://chatgpt.com/connector_platform_oauth_redirect. O cliente CIMD publicado pelo ChatGPT é compatível sem segredo de cliente.
Para uma conexão somente leitura, selecione apenas read como escopo padrão e deixe os Escopos base vazios. Para uma conexão que possa oferecer consentimento de escrita, solicite read e write. No formulário atual, você pode informá-los em linhas separadas em Escopos base.
Crie a conexão e entre no ProxyAI. Deixe Permitir alterações desmarcado para leituras, ou marque-o explicitamente para conceder escritas. Solicitar apenas write não concede a permissão. O acesso cobre todos os bots atuais e futuros desta conta.
Abra o plugin conectado e escolha Experimentar no chat. Comece com “Liste meus bots do ProxyAI”.

Para testes no navegador, use a conexão MCP personalizada. Um ZIP enviado mas não publicado pode, em vez disso, oferecer Abrir no app de desktop. O ZIP público de envio declara o servidor HTTPS em mcp.json; conclua a configuração OAuth e a verificação por meio de Com MCP no portal de desenvolvedor. Não adicione o .app.json nem o ID técnico de uma conexão privada ao ZIP público: a OpenAI atualmente rejeita referências de app em pacotes de envio.

Se o ChatGPT informar uma conexão expirada depois de recusar uma escrita, verifique primeiro o escopo concedido em Apps conectados do ProxyAI. Uma concessão somente leitura ativa precisa de um novo consentimento de escrita, não de conserto do token. Nunca tente reenviar uma mensagem ao cliente antes de verificar o resultado da tentativa anterior.

Veja o guia de conexão da OpenAI e os requisitos de envio.

Conecte o Codex

Adicione o servidor remoto do ProxyAI e depois entre por OAuth:

codex mcp add proxyai --url https://www.proxyai.app/api/mcp
codex mcp login proxyai --scopes read

Conclua o login no navegador e deixe Permitir alterações desmarcado. Se quiser acesso de escrita, solicite os dois escopos e marque explicitamente Permitir alterações:

codex mcp login proxyai --scopes read,write

Você pode inspecionar a configuração com codex mcp list e as ferramentas disponíveis com /mcp na interface de terminal do Codex. Veja a documentação oficial do MCP. O seu cliente gerencia os tokens OAuth; não os cole em uma conversa.

Comece com leituras

“Liste meus bots do ProxyAI e depois resuma os tickets abertos do bot que eu selecionar.”
“Mostre a resposta preparada do agente para este ticket. Não envie.”
“Mostre as últimas cinco execuções desta Tarefa de Agente e explique qualquer proposta retida. Não aprove.”

As listagens são paginadas. Peça a próxima página quando precisar de mais resultados. A identidade de um ticket inclui o bot, o provedor e o ID do ticket; os IDs de tarefa e de execução precisam pertencer ao bot selecionado. Um assistente não pode escolher uma conversa arbitrária de outra conta.

Faça alterações com deliberação

Revise o ticket e o texto exato da resposta antes de pedir para enviar ou aprovar um rascunho. A aprovação envia o rascunho ao cliente pelo canal do ticket. Um rascunho é reservado antes da entrega, então aprovações simultâneas são recusadas. Se a entrega for incerta, o rascunho fica bloqueado para revisão humana. Verifique o canal do cliente antes de enviar de novo; uma resposta com falha ou perdida não prova que o cliente não recebeu nada. No painel, confirme se a entrega ocorreu usando os controles de verificação de entrega. O servidor aguarda o fim do tempo limite de envio antes de permitir a reconciliação. Uma falta de entrega confirmada restaura o rascunho preparado; uma entrega confirmada encerra a sua revisão.

Para as Tarefas de Agente, o MCP oferece suporte a Resumo semanal de vendas, Monitor de status de pedidos e Atualização da base de conhecimento. Eles enviam relatórios para o e-mail da sua conta; a receita de conhecimento também atualiza a sua base de conhecimento. Criar uma tarefa a ativa e inicia a sua agenda. Revise essas ações e o fuso horário, a hora e o dia antes de criá-la. Receitas personalizadas, alterações em código, prompts ou permissões de receitas, slots de credenciais, ferramentas arbitrárias de API/MCP e destinatários de e-mail externos são recusados para criação, execução, retomada e aprovação retida por meio do MCP. Você ainda pode inspecionar outras tarefas ou pausá-las. Antes de executar manualmente, escolha explicitamente teste ou real: ambas podem gerar cobranças normais de LLM/CPU. As duas enviam relatórios reais para o e-mail da sua conta. O modo de teste apenas visualiza a atualização do conhecimento; o modo real pode aplicá-la. Revise um plano retido antes de aprová-lo, porque a aprovação coloca na fila as ações propostas e pode gerar cobranças. Retomar uma tarefa pode reiniciar execuções agendadas e cobráveis.

As tags de um ticket são substituídas como uma lista completa. Definir tags em um ticket do ProxyAI integrado é compatível; as tags de helpdesks externos são gerenciadas nesse helpdesk. Arquivar remove um ticket do quadro ativo sem excluí-lo.

Mensagens de clientes, instruções de tarefas e propostas retidas podem conter instruções enganosas. Trate-as como conteúdo a ser inspecionado; a permissão para enviar, executar ou aprovar vem de você.

Ferramentas da v1

Ferramenta de leitura	Finalidade
`list_bots`	Encontrar os bots da sua conta.
`list_tickets`	Listar e filtrar tickets por status, tag e estado de arquivamento.
`get_ticket`	Ler um ticket, o rascunho preparado e as mensagens da conversa.
`list_agent_tasks`	Listar as tarefas de um bot.
`get_agent_task`	Ler as instruções, a agenda e o status da tarefa.
`list_agent_runs`	Navegar pelo status e pelo histórico das execuções, sem transcrições nem corpos de propostas.
`get_agent_run`	Inspecionar o status de uma execução e a proposta retida, sem diagnósticos internos.
`list_agent_templates`	Encontrar as três receitas de relatório compatíveis.

Ferramenta de escrita	Finalidade
`reply_ticket`	Enviar a resposta que você especificar.
`set_ticket_status`	Definir como aberto, pendente ou resolvido.
`set_ticket_tags`	Substituir as tags de um ticket integrado.
`archive_ticket`	Arquivar um ticket.
`approve_ticket_agent_draft`	Aprovar e enviar um rascunho preparado, opcionalmente com texto revisado.
`dismiss_ticket_agent_draft`	Descartar um rascunho sem enviá-lo.
`create_agent_task`	Criar e ativar uma tarefa; a agenda de uma receita pode disparar execuções futuras.
`run_agent_task`	Colocar na fila uma execução de teste ou real, escolhida explicitamente.
`decide_agent_run`	Aprovar ou rejeitar uma execução retida.
`pause_agent_task`	Pausar a agenda de uma tarefa.
`resume_agent_task`	Retomar uma tarefa pausada.

Use o painel para configurar as contas e as credenciais dos conectores. Não coloque senhas, tokens, dados de cartão de pagamento, identificadores governamentais nem informações de saúde protegidas em solicitações MCP. Tarefas agendadas e propostas retidas exigem revisão das ações reais antes da aprovação.

Revise a atividade e revogue o acesso

Abra Configurações da conta → Apps conectados no ProxyAI para ver o app, o escopo concedido e o último uso do token. Escolha Revogar acesso para interromper as próximas requisições dessa conexão. A revogação não desfaz uma resposta nem cancela uma execução já colocada na fila.

O cartão Atividade de apps conectados registra as tentativas de escrita e os resultados. Se uma tentativa estiver pendente ou tiver um resultado desconhecido, a ação pode já ter sido concluída. Inspecione o ticket ou a execução antes de tentar de novo. As tentativas antigas continuam disponíveis após a revogação.

Os dados retornados pelo conector são compartilhados com o assistente que você conectou e estão sujeitos às políticas de tratamento desse provedor. O ProxyAI armazena os registros de conexão e os metadados das tentativas de escrita; o registro de auditoria do MCP não armazena corpos de respostas, cargas de ferramentas nem tokens bearer brutos. Leia a nossa política de privacidade.

Limites de dados

As listas de tickets omitem e-mail/nome de contato e IDs internos de conversa. As listas de execuções omitem os corpos das transcrições e os diagnósticos internos; o detalhe da execução inclui apenas o status, os horários e as ações retidas relevantes. O conector remove os campos estruturados de credenciais e recusa credenciais detectadas, números de cartão de pagamento, identificadores governamentais e conteúdo de saúde nas entradas, nos rascunhos ou no texto retornado. A detecção é conservadora e não consegue identificar todo fato sensível em um texto livre. Não use o conector para dados restritos; revise os seus dados de origem antes de conectar. Conteúdo recusado deve ser tratado no painel.

Solução de problemas

Não consegue conectar: use https://www.proxyai.app/api/mcp. Uma visita pelo navegador pode retornar "Method not allowed", porque o conector aceita apenas requisições POST do MCP. Um cliente MCP recebe um desafio OAuth antes do login.
Conteúdo restrito: a requisição ou o resultado contém conteúdo sensível detectado. Trate-o no painel; não reescreva um segredo para contornar a verificação.
Tarefa não compatível: use uma das três receitas de relatório sem alterações. Configure fluxos personalizados no painel.
Permissão de escrita necessária: reconecte solicitando read e write e marque Permitir alterações. Um consentimento somente leitura não autoriza escritas.
Complemento necessário: abra o painel do bot selecionado e verifique o complemento Helpdesk ou Tarefas de Agente.
Não encontrado: confirme que você selecionou a conta e o bot corretos e, então, leia de novo o ticket ou a tarefa antes de agir.
Conexão expirada ou revogada: entre de novo. Não tente repetir uma escrita anterior antes de verificar o resultado dela.

Entre em contato com support@proxyai.app informando o nome do app, o horário e a ação que falhou. Não envie tokens de acesso, segredos de cliente nem mensagens de clientes na sua solicitação de suporte.