Xorventa

Conecte o Xora para revisar sua conta Xorventa e solicitar trabalhos suportados sob os controles do proprietário.

Ver em xorventa.ai

Servidor MCP hospedado

npx add-mcp 'https://api.xorventa.ai/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Xorventa MCP

Conecte o assistente de IA que você já usa à sua conta Xorventa e peça respostas e trabalhos na conta ao Xora a partir de lá — dentro das permissões que você escolher.

Traga o Xora para o Claude, ChatGPT, Gemini e Grok.

O Xorventa MCP está listado no diretório do Claude da Anthropic e no Registro MCP oficial, e funciona no ChatGPT, Gemini e Grok hoje. Qualquer assistente que suporte conectores MCP pode adicioná-lo com um único endereço.

Endereço do conector

https://api.xorventa.ai/mcp

Incluído em toda conta Xorventa. Adicione-o como um conector personalizado no seu assistente de IA.

Como funciona

Conecte, escolha permissões e desconecte a qualquer momento.

Visão geral

O que o Conector faz

O Conector Xorventa permite conectar um assistente de IA que você já usa à sua própria conta Xorventa. A partir desse assistente, você pode perguntar ao Xora, o assistente de conta da Xorventa, sobre o seu negócio e a sua conta, ver o que está aguardando sua decisão e solicitar que trabalhos suportados sejam feitos — publicar, responder, enviar, alterar configurações e excluir — dentro das permissões que você escolher.

Ele usa o protocolo aberto Model Context Protocol (MCP). O endereço é https://api.xorventa.ai/mcp. Ele está incluído em toda conta Xorventa sem custo adicional.

Ele funciona através da mesma lista de ações que o Xora usa nas páginas da sua conta, sob os mesmos interruptores, com algumas coisas deixadas de fora que estão listadas mais abaixo nesta página. Um assistente conectado não pode fazer nada que o Xora não tenha permissão para fazer por você.

Configuração

Como conectar

  • Antes de começar: você precisa de uma conta Xorventa na qual possa entrar e de um assistente que permita adicionar um conector personalizado. A configuração geralmente é chamada de conectores, integrações ou ferramentas.
  • Adicione o endereço. No seu assistente, adicione um novo conector e insira https://api.xorventa.ai/mcp.
  • Entre na Xorventa. Seu assistente abre uma página da Xorventa; entre na sua própria conta. A solicitação dura 10 minutos — se expirar, comece novamente pelo seu assistente.
  • Revise a tela de aprovação. Ela mostra o nome e o endereço web do assistente, a conta Xorventa à qual ele se conectará e cada permissão que ele está solicitando, todas marcadas inicialmente. Desmarque qualquer uma que você não queira conceder; a leitura não pode ser desmarcada. Em seguida, aprove ou recuse.
  • Pergunte algo. Volte ao seu assistente e pergunte, por exemplo, "O que precisa da minha atenção na minha conta Xorventa hoje?"
  • Nada é conectado até você aprovar. Recusar informa ao assistente que você disse não, e nada é compartilhado. Seu assistente também pode mostrar seus próprios avisos de permissão, por exemplo, antes de usar uma ferramenta; esses vêm do seu assistente, não da Xorventa.

Permissões

As quatro permissões

Cada permissão é listada como aparece na tela de aprovação, com o nome curto que sua página de Configurações de Perfil mostra para ela. Nenhuma permissão inclui outra.

  • Ler sua conta (xorventa:read) — obrigatória — Ver seus produtos Xorventa, configurações, etapas de configuração e atividade, e fazer perguntas ao Xora sobre o seu negócio.
  • Alterar configurações (xorventa:manage) — Alterar configurações por você, onde você permitiu que o Xora altere configurações.
  • Publicar, enviar ou excluir diretamente (xorventa:execute) — Publicar posts e respostas, enviar e-mails e excluir coisas por você, sem perguntar a cada vez — dentro dos interruptores que você definiu na página O que o Xora sabe sobre você.
  • Rascunho para sua aprovação (xorventa:prepare) — Criar rascunhos de posts, respostas e outras coisas para publicar; eles aguardam você confirmar na Xorventa. Conceda isso sem "Publicar, enviar ou excluir diretamente" se quiser aprovar cada um.
  • Somente leitura: o assistente pode olhar e perguntar, e não altera nada.
  • Com Alterar configurações: ele pode alterar as configurações que o Xora tem permissão de alterar.
  • Com Publicar, enviar ou excluir diretamente: publicar, enviar e excluir são executados assim que o assistente solicitar, se o seu interruptor para esse tipo de ação estiver ativado.
  • Com Rascunho para sua aprovação, mas não Publicar, enviar ou excluir diretamente: toda publicação, envio ou exclusão se torna uma proposta que aguarda você (veja Propostas abaixo).
  • Algumas configurações contam como publicação quando usadas de determinada maneira. Alternar respostas sociais para automáticas, por exemplo, é tratado como publicação.
  • Para alterar o que uma conexão pode fazer, desconecte-a, conecte novamente e marque as permissões que deseja desta vez.

Seus controles

O que a Xorventa ainda verifica

Uma permissão permite que o assistente solicite. Ela não substitui nenhuma das regras da sua própria conta. Cada solicitação é verificada contra:

  • as permissões que você concedeu a esta conexão;
  • seus interruptores na página O que o Xora sabe sobre você;
  • os produtos incluídos na sua conta;
  • os serviços que você conectou, como uma rede social, caixa de e-mail ou site;
  • os limites de uso da sua conta; e
  • o limite da sua conta: uma conexão pertence a uma conta Xorventa e não pode alcançar nenhuma outra.
  • Seus interruptores e a conexão são verificados novamente no momento em que uma ação é executada. Se você desativar algo ou desconectar o assistente, a próxima ação é interrompida.
  • Tudo o que um assistente conectado solicitar, incluindo o que foi recusado, é listado com o que o Xora fez na sua página O que o Xora sabe sobre você, marcado como vindo desse assistente.

Ferramentas

As quatorze ferramentas que seu assistente usa

Cada ferramenta é listada pelo nome exato que seu assistente vê, seguido pelo título e para que serve. Você não as chama diretamente; seu assistente as escolhe a partir do que você pergunta. As ações são divididas pelo que fazem — leitura, alteração de configurações, publicação ou envio e exclusão — e cada uma dessas quatro ferramentas recusa uma ação de outro tipo.

Um assistente ainda na versão anterior do Conector, 1.1.0, vê as primeiras doze.

  • xorventa_status · Status da conta — Seus produtos, etapas de configuração não concluídas, o que está aguardando sua decisão e links para as páginas corretas na sua conta. Somente leitura. Precisa de Leitura.
  • xora_ask · Perguntar ao Xora — Faça uma pergunta ao Xora sobre sua conta ou sobre a Xorventa. A resposta dela se baseia no material de ajuda da Xorventa, seus Fatos de Negócio aprovados, seus itens de trabalho abertos e o que ela lembra sobre você (um assistente na 1.1.0: apenas o número de itens abertos), e pode nomear ações que fariam o que você pediu. Não altera nenhuma configuração. A pergunta e a resposta são mantidas como a conversa desta conexão para que o assistente possa continuá-la. Precisa de Leitura.
  • xora_capabilities · Listar ações — Toda ação que o Xora pode realizar para sua conta e toda ação que permanece com você, com o que cada uma faz, qual permissão precisa, se seria executada diretamente ou como proposta para esta conexão, e se esta conexão pode usá-la agora — e, se não, por quê. Precisa de Leitura.
  • xora_action_details · Detalhes da ação — Para uma ação: as informações que ela precisa, o que faz, se é executada diretamente ou aguarda você, e em qual página da sua conta ela pertence. Não executa nada. Precisa de Leitura.
  • xora_read · Ler dados da conta — Executa uma leitura: listas, consultas e resumos das suas janelas de chat, Fatos de Negócio, configurações, rascunhos, posts, auditorias de SEO e atividade. Recusa qualquer coisa que altere algo. Precisa de Leitura.
  • xora_change_settings · Alterar configurações — Executa uma alteração de configurações: aparência e texto da janela de chat, Fatos de Negócio, fontes de conhecimento, assistente, telefone, caixa de e-mail e configurações de SEO, rascunhos que não são publicados e alterações semelhantes dentro da sua conta. Precisa de Alterar configurações; as poucas configurações que sempre pedem primeiro também precisam de Publicar, enviar ou excluir diretamente, ou se tornam uma proposta com Rascunho para sua aprovação.
  • xora_publish_or_send · Publicar ou enviar — Executa uma ação de publicação ou envio: posts e respostas sociais, respostas por e-mail, alterações de agendamento que notificam a pessoa que reservou e alterações no site que entram no ar. Executa diretamente com Publicar, enviar ou excluir diretamente; torna-se uma proposta com Rascunho para sua aprovação.
  • xora_delete · Excluir — Executa uma exclusão: rascunhos, registros, fontes de conhecimento, relatórios, conexões e posts publicados. Executa diretamente com Publicar, enviar ou excluir diretamente; torna-se uma proposta com Rascunho para sua aprovação.
  • xora_action_status · Status da ação — O estado atual de uma ação que esta conexão solicitou. Nunca executa, tenta novamente ou altera a ação. Precisa de Leitura.
  • xora_cancel_action · Cancelar uma ação — Cancela uma ação proposta ou em espera que esta conexão solicitou, desde que nada tenha sido entregue a outro serviço ainda. Precisa de Rascunho para sua aprovação ou Publicar, enviar ou excluir diretamente.
  • xora_upload_prepare · Preparar um upload — Reserva um upload único para uma ação que usa um arquivo (veja Arquivos e uploads). Precisa de Alterar configurações.
  • xora_upload_status · Status do upload — Se um arquivo preparado chegou e passou nas verificações, para que possa ser usado. Precisa de Leitura.
  • xora_upload_from_url · Anexar um arquivo de um endereço web — A Xorventa busca um arquivo de um endereço web https público e o prepara para uma ação que usa um arquivo, após as mesmas verificações que um upload atende (veja Arquivos e uploads). Precisa de Alterar configurações.
  • xora_upload_request · Pedir ao proprietário um arquivo — Mostra a você um cartão no chat onde você escolhe um arquivo do seu dispositivo; ele é enviado e verificado, e o assistente então o usa — por exemplo, coloca em um post. Precisa de Alterar configurações.
  • Cada solicitação carrega um identificador escolhido pelo seu assistente. Se ele enviar a mesma solicitação novamente com o mesmo identificador, a Xorventa retorna o primeiro resultado e não faz o trabalho duas vezes.
  • Uma solicitação retorna como concluída, proposta (aguardando você), na fila ou em execução (ainda não concluída), falhou, recusada (com o motivo), cancelada ou indeterminada. Somente concluída significa que aconteceu.

Propostas

Prepare sem fazer

Se você concedeu Rascunho para sua aprovação, mas não Publicar, enviar ou excluir diretamente, qualquer coisa que publicaria, enviaria ou excluiria é preparada, mas não feita:

  • O assistente recebe uma proposta e um link para uma página de confirmação na sua conta Xorventa.
  • Você abre o link, conectado à Xorventa, e vê exatamente o que será executado e onde. Confirme ou escolha Agora não.
  • Você tem 10 minutos para confirmar (um minuto para um assistente ainda na versão anterior do conector, 1.1.0). Depois disso, a proposta expira e nada acontece; seu assistente pode prepará-la novamente se você ainda quiser.
  • Depois que você confirmar, a ação é executada e o assistente pode verificar o status.
  • Seu assistente não pode confirmar uma proposta por você. Se você desconectou o assistente ou desativou esse tipo de ação nesse meio tempo, a confirmação é recusada e nada é executado.

Cancelamento

Cancelamento e resultados incertos

  • Seu assistente pode cancelar uma ação proposta ou em espera que ele solicitou, antes de ser entregue a outro serviço. O cancelamento não pode desfazer o trabalho que já aconteceu.
  • Se uma ação que publica, envia, exclui ou altera algo expirar, ou falhar no lado do outro serviço depois de iniciada, a Xorventa a reporta como indeterminada e não tenta novamente: ela pode já ter acontecido. Verifique a página na sua conta Xorventa, ou a rede ou o serviço em si, antes de pedir novamente. Isso evita posts e mensagens duplicados.

Arquivos

Arquivos e uploads

Algumas ações usam um arquivo: uma imagem ou vídeo para um post social, um logotipo ou banner de negócio, uma imagem de janela de chat ou um documento para seus Fatos de Negócio. Um assistente remoto não pode ler os arquivos do seu computador, então ele dá à Xorventa o arquivo de uma destas maneiras:

  • Mídia para post social — imagens PNG, JPEG, GIF ou WebP, ou vídeo — até 100 MB (um vídeo curto de celular cabe). Um arquivo enviado dentro da própria solicitação está limitado a 8 MB.
  • Logotipo ou banner da empresa; imagem da janela de chat — imagens PNG, JPEG, GIF ou WebP — até 10 MB.
  • Documento de Business Facts — PDF, Word (.docx ou .doc), texto simples, Markdown, HTML ou CSV — até 10 MB.
  • Aguardando uso — No máximo 20 arquivos em espera, ou 200 MB, por conta por vez. Um arquivo em espera é mantido por no máximo uma hora e depois excluído. O produto ao qual é adicionado pode aplicar verificações adicionais próprias.
  • Na mesma solicitação, para um post social. Quando o assistente envia mídia social, cria um post ou edita um rascunho ou post agendado, ele pode incluir a imagem ou o vídeo em si — pelo endereço web público https, ou o conteúdo do arquivo (até 8 MB). A Xorventa armazena e coloca no post em uma única etapa.
  • Por endereço web. A Xorventa busca um endereço https público que o assistente indicar e coloca o arquivo em espera para a ação. Endereços privados e locais, http simples e qualquer redirecionamento para um deles são recusados.
  • No chat. O assistente mostra um cartão onde você escolhe um arquivo do seu dispositivo; ele é enviado e verificado, e o assistente então o usa — por exemplo, coloca em um post.
  • Por link de upload. O assistente declara o arquivo — nome, tipo, tamanho, uma impressão digital do conteúdo (SHA-256) e a única ação para a qual ele serve — e envia o arquivo exato para o link de uso único que a Xorventa retorna. O link funciona uma vez, por 10 minutos, e carrega sua própria credencial, então também funciona com as ferramentas de código de um assistente. Um arquivo que não corresponde à declaração é rejeitado.
  • Ou o assistente fornece um link para uma página da Xorventa onde você escolhe o arquivo você mesmo.
  • Independentemente de como um arquivo chega, ele passa pelas mesmas verificações de tipo e tamanho, e seu tipo é lido do próprio arquivo, não do nome ou do site que o serviu. Um arquivo em espera pode ser usado por apenas uma ação, dentro de 10 minutos. A Xorventa nunca lê um caminho de arquivo que um assistente indicar.
  • Cada endereço web que a Xorventa busca é listado com o que a Xora fez na sua página O que a Xora sabe sobre você, pelo nome do site.

Limites

O que o Conector não pode fazer

Configuração e dinheiro permanecem com você. Essas ações são marcadas como permanecendo com você, e o assistente é informado para qual página da sua conta enviar você. Um assistente conectado não pode:

  • alterar sua senha, e-mail da conta, configurações de dois fatores ou códigos de recuperação;
  • adicionar, alterar ou escolher um cartão de pagamento;
  • comprar qualquer coisa, mudar um plano ou cancelar um produto;
  • publicar uma janela de chat;
  • iniciar a revisão de SEO gratuita ou ativar alterações automáticas no site;
  • clonar uma voz;
  • conectar ou entrar em uma rede social, caixa de correio, Google, Bing ou plataforma de site em seu nome;
  • excluir sua conta Xorventa;
  • ativar os interruptores da Xora, conceder a si mesmo mais permissões ou agir fora das permissões que você concedeu;
  • confirmar suas próprias propostas; ou
  • controlar uma chamada telefônica ao vivo.

Seus dados

O que um assistente conectado recebe, e o que não recebe

Um assistente que você permite ler sua conta pode discutir seu plano e quanto uma alteração custaria, incluindo cotações, prévias de mudança de plano e códigos de promoção — comprar e mudar um plano permanece com você. Ele pode ler as listas de cada um dos seus produtos, com o que contêm, para agir sobre elas: seus comentários sociais, mensagens e menções e quem os escreveu; seus rascunhos de SEO, próximas ações, relatórios, lacunas de conteúdo e números do Search Console e Google Analytics; as perguntas de clientes que a Xora não conseguiu responder; seus compromissos, incluindo nomes e endereços de e-mail das pessoas que reservaram; e os e-mails aguardando sua aprovação, com a resposta redigida para cada um. Um assistente ainda na versão anterior do Conector, 1.1.0, recebe os e-mails aguardando sua aprovação, mas não as outras listas.

  • Suas conversas privadas com a Xora nas páginas da sua conta. (As respostas da Xora a elas podem se basear no que ela lembra sobre você e nos seus itens de trabalho abertos, como fazem nas páginas da sua conta.)
  • Sua senha, configurações de dois fatores ou códigos de recuperação, e as credenciais de entrada das redes e serviços que você conectou.
  • O que um assistente conectado recebe é tratado pela empresa que o fornece, sob os próprios termos e política de privacidade dessa empresa. Consulte a Política de Privacidade da Xorventa, seção 6, Assistente de IA Conectados.

Retenção

O que mantemos, e por quanto tempo

  • Entrada: a credencial de acesso do assistente dura 15 minutos e é renovada com uma credencial de atualização que dura 30 dias e é substituída a cada uso. Armazenamos apenas um hash unidirecional de cada credencial.
  • Conversa com a Xora: as últimas oito perguntas e respostas para cada conexão, criptografadas, para que o assistente possa continuar a conversa. Ela deixa de ser usada 24 horas após a última pergunta e é apagada imediatamente quando você desconecta o assistente.
  • Uma limpeza diária exclui: solicitações de conexão expiradas, códigos de entrada e credenciais de acesso uma hora após expirarem; credenciais de atualização uma hora após expirarem, ou 30 dias após serem substituídas ou canceladas; uploads em espera não utilizados uma hora após expirarem, e os utilizados 24 horas após o uso; conversas expiradas da Xora uma hora após expirarem; credenciais e uploads restantes de um assistente desconectado 30 dias após você desconectá-lo; e o registro do Conector de cada ação concluída, incluindo seu resultado criptografado, após 90 dias.
  • Mantido com sua conta: a entrada para cada ação no que a Xora fez na sua página O que a Xora sabe sobre você, como qualquer outra ação da Xora, e o registro de cada conexão — nome e endereço web do assistente, permissões que você concedeu e quando foi conectado, usado pela última vez e desconectado.

Desconexão

Desconectar um assistente

  • Na Xorventa: abra Configurações de Perfil e encontre Assistente de IA Conectados. Cada conexão mostra o nome do assistente, suas permissões, quando foi conectado e quando foi usado pela última vez. Escolha Revogar e depois Sim, desconectar.
  • Isso entra em vigor imediatamente. Toda credencial que o assistente possui para de funcionar, solicitações que ele fez e que ainda não foram entregues a outro serviço são canceladas, e sua conversa com a Xora é apagada. Trabalho já entregue a outro serviço antes de você desconectar não pode ser recuperado dessa forma.
  • No seu assistente: você também pode remover o conector das configurações do seu assistente. Isso impede que o assistente chame a Xorventa; desconectar na Xorventa é o que encerra o acesso do nosso lado.
  • Para conectar novamente mais tarde, adicione o conector novamente e aprove suas permissões novamente. Se você excluir sua conta Xorventa, todo assistente conectado é desconectado imediatamente.

Solução de problemas

Se algo der errado

O que seu assistente relata, o que significa e o que fazer.

  • “Conecte este assistente a uma conta Xorventa primeiro.” ou uma solicitação para entrar novamente — A conexão não está conectada: a entrada de 30 dias expirou, ou você a desconectou. Reconecte pelo seu assistente e aprove novamente.
  • “Esta conexão não recebeu xorventa:…” — A ação precisa de uma permissão que você não concedeu. Se quiser permitir, desconecte, conecte novamente e marque essa permissão.
  • “O proprietário ainda não permitiu isso. Na página O que a Xora sabe sobre você, ele pode ativar: …” — Seu interruptor para esse tipo de ação está desligado. Ative-o em O que a Xora sabe sobre você se quiser permitir.
  • “… permanece com o proprietário.” — A ação é uma das ações de configuração e dinheiro acima. Faça você mesmo na página que seu assistente indicar.
  • “Dados de contas Google, Meta ou Microsoft não são compartilhados com assistentes conectados.” ou “Prévias de cobrança e cotações não são compartilhadas com assistentes conectados.” — Essa informação não é dada a um assistente na versão anterior do Conector, 1.1.0. Veja na sua conta Xorventa.
  • “Esta conta Xorventa está pedindo mais à Xora do que ela pode responder agora. Aguarde um minuto e tente novamente.” — Sua conta usou suas respostas da Xora para este minuto (o limite é compartilhado com a Xora nas páginas da sua conta). Aguarde um minuto e pergunte novamente.
  • “A Xora está ocupada com outras solicitações nesta conta — tente novamente em um momento.” — A Xora já está respondendo duas perguntas para sua conta, do seu assistente ou das páginas da sua conta. Pergunte novamente em um momento.
  • “Isso foi recusado por agora devido a muitas ações em pouco tempo. Tente novamente em um pouco.” — Sua conta pediu mais de 40 ações em um minuto, ou mais de 60 alterações em 10 minutos. Aguarde e pergunte novamente.
  • Uma ação recusada como ferramenta errada — O assistente enviou a ação para a ferramenta de um tipo diferente de ação. Nada foi executado; o assistente pode enviá-la para a correta.
  • upload_quota_exceeded — Sua conta já tem 20 arquivos em espera, ou 200 MB, aguardando uso. Use os arquivos já em espera, ou aguarde — arquivos não utilizados expiram dentro de uma hora.
  • upload_storage_full — O armazenamento temporário de arquivos da Xorventa está cheio. Tente novamente mais tarde; se continuar, entre em contato com o suporte.
  • too_large ou type_not_allowed — O arquivo é maior que o limite para essa ação, ou de um tipo que ela não aceita. Veja os limites em Arquivos e uploads.
  • size_mismatch, sha256_mismatch ou content_not_… — O arquivo enviado não corresponde ao que foi declarado, ou seu conteúdo não é do tipo declarado. Prepare o upload novamente com os detalhes corretos do arquivo.
  • “Esse upload já foi usado por outra ação, então nada foi feito.” — Cada upload pode ser usado uma vez. Coloque o arquivo em espera novamente.
  • Um upload que expirou — O link de upload de 10 minutos expirou, ou a conexão foi desconectada. Prepare um novo upload.
  • Uma proposta que expirou — Ninguém a confirmou a tempo (10 minutos, ou um minuto na versão anterior do conector, 1.1.0). Peça ao seu assistente para prepará-la novamente se ainda quiser, e confirme prontamente.
  • “A conexão que pediu isso foi revogada, então nada foi feito.” — Você desconectou o assistente antes de a ação começar. Reconecte e pergunte novamente se ainda quiser.
  • indeterminate — A ação começou, mas seu resultado não pôde ser confirmado; ela pode já ter acontecido. Não pergunte novamente até verificar a página na sua conta ou na rede.
  • “Algo deu errado no lado da Xorventa. Nada foi repetido …” — Um problema temporário do nosso lado. Peça ao assistente para verificar o status da ação primeiro e tente novamente em um minuto.
  • A página de aprovação diz que a solicitação expirou, já foi respondida ou não existe — A solicitação de conexão de 10 minutos expirou ou já foi usada. Comece a conectar novamente pelo seu assistente.

Ajuda

Suporte

  • Envie um e-mail para support@xorventa.ai, ou envie-nos uma mensagem em https://xorventa.ai/contact.
  • Diga-nos qual assistente você usa, aproximadamente quando o problema aconteceu e o que o assistente relatou. Nunca nos envie sua senha ou um código de entrada.

Detalhes técnicos

O que cada diretório recebeu.

Detalhes da listagem

Detalhes da listagem

  • Nome — Xorventa
  • Nome do registro — ai.xorventa/xorventa
  • Versão — 1.3.1
  • Transporte — HTTP transmissível
  • Endereço — https://api.xorventa.ai/mcp
  • Entrada — OAuth
  • Documentação — https://xorventa.ai/connector
  • Suporte — support@xorventa.ai
  • Ferramentas — 12
  • Descrição — Conecte a Xora para revisar sua conta Xorventa e solicitar trabalho suportado sob controles do proprietário.

Perguntas sobre o Conector Xorventa?

Envie um e-mail para support@xorventa.ai, ou envie-nos uma mensagem aqui, e ajudaremos você a conectar seu assistente.