Dvina MCP

Usar o acesso à API

Crie tokens de acesso pessoal para scripts e clientes MCP e envie eventos do seu Livespace aos seus próprios sistemas com webhooks.

Ver em Markdown

Em Ajustes › Acesso à API, você cria tokens de acesso pessoal para que um script ou cliente MCP possa usar Dvina em seu nome. Os administradores também adicionam webhooks nessa seção para enviar eventos do Livespace aos seus próprios sistemas.

O acesso à API está incluído no plano Enterprise. Todos os membros podem criar seus próprios tokens; apenas proprietários e administradores veem Webhooks.

Criar um token

  1. Abra Ajustes e escolha Acesso à API.
  2. Em Tokens de acesso pessoal, escolha Criar token.
  3. Digite um Nome para identificar depois o que usa esse token.
  4. Escolha o Acesso: Somente leitura ou Leitura e gravação.
  5. Escolha quando ele Expira: Em 30 dias, Em 90 dias, Em 365 dias ou Nunca expira.
  6. Escolha Criar token.
  7. Em Copie seu token, copie o token e guarde-o em um local seguro. Ele só é exibido nesse momento.

Um token atua em seu nome, no Livespace em que você o criou, com a função que você tem nele atualmente. Um token de Somente leitura pode ler, mas não pode adicionar nem alterar nada.

Para usar um token com um cliente MCP, consulte Conectar com uma chave de API em vez de OAuth.

Consultar, renovar ou revogar um token

Seus tokens aparecem em Tokens de acesso pessoal, com o acesso de cada um. Escolha um token para ver os campos Começa com, Acesso, Último uso e Expira.

  • Para substituir um token, escolha Renovar… e depois Renovar para confirmar. Um novo token substitui o anterior, que deixa de funcionar imediatamente. Copie o novo token em Copie seu token.
  • Para desativar um token, escolha Revogar… e depois Revogar para confirmar. Tudo o que usa esse token deixa de funcionar imediatamente.

A criação, a renovação e a revogação de um token são registradas no log de auditoria.

Adicionar um webhook

Um webhook envia os eventos do Livespace, os mesmos registros do log de auditoria, para um endereço que você escolhe.

  1. Em Ajustes › Acesso à API, na seção Webhooks, escolha Adicionar webhook.
  2. Digite um Nome e a URL. Use uma URL HTTPS pública.
  3. Em Eventos, deixe o campo vazio para receber todos os eventos ou liste ações e áreas, como member.added ou sharing.*.
  4. Escolha Adicionar.
  5. Em Copie o segredo de assinatura, copie o segredo. Ele só é exibido nesse momento.

Se Dvina exibir Não é possível acessar este endereço a partir de Dvina, use uma URL HTTPS pública.

Verificar a assinatura de cada requisição

Dvina envia eventos em lotes, em formato JSON, e assina cada requisição. Use o segredo de assinatura para verificar se uma requisição veio de Dvina:

  • Cada requisição tem um cabeçalho X-Dvina-Signature no formato t=<timestamp>,v1=<signature>.
  • A assinatura é um HMAC-SHA256, em hexadecimal, do timestamp, seguido de um ponto e do corpo da requisição, gerado com seu segredo de assinatura.
  • Calcule a assinatura e compare. Rejeite uma requisição se a assinatura não corresponder ou se o timestamp for antigo demais.

Consulte ou altere um webhook

Seus webhooks aparecem em Webhooks com o status: Ativo, Pausado ou Com falha. Selecione um para ver os detalhes.

  • Para alterá-lo, edite o Nome, a URL ou os Eventos e selecione Salvar.
  • Para pausá-lo, desative Enviar eventos. Ative essa opção novamente para retomar o envio.
  • Para acompanhar o funcionamento, confira o Status e quantos eventos foram Enviados. Um webhook com falha mostra o Último erro. A Dvina continua tentando e registra a falha no log de auditoria.
  • Para alterar o segredo, selecione Novo segredo de assinatura… e confirme. As solicitações passam a ser assinadas com o novo segredo imediatamente, então atualize o receptor assim que fizer a alteração.
  • Para removê-lo, selecione Excluir… e depois Excluir para confirmar. Nada mais será enviado a ele.