Dvina MCP

Use o Dvina em outros apps com MCP

Conecte um cliente MCP, como Claude Code, ChatGPT ou Cursor, ao Dvina, entre na sua conta e permita que ele leia e adicione conteúdo ao seu Dvina com sua aprovação.

Ver em Markdown

O Dvina tem seu próprio servidor MCP. Conecte um cliente MCP, como Claude Code, ChatGPT ou Cursor, para que esse app possa pesquisar no seu Dvina, ler seus documentos e sua memória e adicionar notas, tarefas e lembretes em seu nome.

Antes de começar

Você precisa do endereço do servidor:

https://api.dvina.ai/mcp

Se sua empresa executa o Dvina em servidores próprios, use o endereço da API do Dvina da sua empresa com /mcp no final. Peça esse endereço ao administrador.

O servidor usa Streamable HTTP. Se o cliente pedir que você escolha um transporte, selecione HTTP.

Conecte um cliente

Claude Code

  1. No terminal, execute:

    claude mcp add --transport http dvina https://api.dvina.ai/mcp

  2. Inicie o Claude Code, execute /mcp, escolha dvina e entre no Dvina.

ChatGPT

  1. Abra a seção do ChatGPT que permite adicionar um servidor MCP.
  2. Insira https://api.dvina.ai/mcp como endereço do servidor e escolha OAuth se for solicitado um método de login.
  3. Entre no Dvina quando o ChatGPT solicitar.

Cursor

  1. Abra a seção do Cursor que permite adicionar um servidor MCP.
  2. Adicione um servidor chamado dvina com o endereço https://api.dvina.ai/mcp.
  3. Entre no Dvina quando o Cursor solicitar.

Você não precisa de um ID de cliente nem de um segredo. O cliente se registra no Dvina na primeira conexão.

Entre na sua conta

O servidor MCP do Dvina usa OAuth para você entrar na sua conta pelo navegador:

  1. Entre no Dvina como de costume.
  2. Se você participa de mais de um espaço de trabalho, escolha um em Selecionar espaço de trabalho e depois escolha Continuar. O cliente funciona apenas nesse espaço de trabalho.
  3. Em Autorizar acesso, confira o nome do app e escolha Permitir acesso. Escolha Negar se não reconhecer o app.

O cliente permanece conectado, então você não precisa entrar na sua conta toda vez.

O que um cliente pode fazer

O cliente tem acesso às ferramentas do Dvina e as usa quando sua solicitação exige:

Área O que o cliente pode fazer
Busca Buscar em suas conversas, documentos, memória e mundo ao mesmo tempo.
Memória Listar e ler seus arquivos de memória, adicionar um novo ou alterar um existente.
Mundo Listar seus tópicos, mostrar o que Dvina sabe sobre um tópico ou qualquer outro assunto e listar seu Feed.
Documentos Listar, ler e buscar em sua Biblioteca, criar notas e pastas, enviar arquivos e substituir, mover ou renomear um documento, ou movê-lo para a lixeira.
Canvas Listar e ler seus canvas, criar um canvas ou reescrever uma página.
Tarefas e objetivos Listar suas tarefas e ler o que elas fizeram, iniciar uma tarefa ou uma tarefa voltada a um objetivo, enviar mais trabalho para uma tarefa ou interrompê-la.
Mensagens agendadas Listar mensagens agendadas, agendar uma mensagem ou um lembrete, uma única vez ou de forma recorrente, ou cancelar um agendamento.
Agentes e habilidades Listar e ler seus agentes e habilidades, criar um agente, adicionar uma habilidade ou alterar qualquer um deles.
Projetos Listar seus projetos e mostrar a pasta e as tarefas recentes de um projeto.
Compartilhamento Ver quem tem acesso a um item e o que outras pessoas compartilharam com você, ou conceder ou remover o acesso de alguém.
Configurações Mostrar suas preferências ou ativar ou desativar a memória.

O cliente não pode excluir nada permanentemente, abrir links públicos, conectar ou desconectar apps nem alterar configurações de administração ou cobrança.

Aprovar alterações

O que o cliente faz segue as mesmas regras de todo o Dvina:

  • A leitura é feita sem pedir confirmação.
  • A adição de algo novo, como uma nota, um arquivo de memória ou uma tarefa, é feita sem pedir confirmação. Ela nunca altera o que já existe.
  • Alterar ou remover algo, como mover um documento para a lixeira, reescrever uma página de canvas, interromper uma tarefa ou compartilhar um item, exige sua confirmação antes. O cliente mostra o resumo da alteração feito pelo próprio Dvina, e você aprova ou recusa. Se você recusar, nada muda.

Nota

Se um cliente não puder pedir sua confirmação, Dvina não fará a alteração solicitada por ele. Faça a alteração no app Dvina ou use um cliente que possa pedir confirmação.

Seu acesso e as regras da sua empresa

O cliente atua em seu nome, com acesso ao que você pode ver e fazer no Dvina:

  • Ele funciona apenas enquanto você for membro do espaço de trabalho e somente dentro do que sua função permite.
  • Se o administrador desativar um recurso, como o envio de arquivos, o cliente também não poderá usá-lo.
  • O que o cliente adiciona ou altera passa pelas regras de proteção de dados da sua empresa, assim como no app.
  • O que ele adiciona ou altera é registrado no seu log de auditoria como uma ação do assistente em seu nome, com a identificação do cliente de origem.
  • O que ele faz conta para o seu uso, dentro dos limites habituais.

Conectar com uma chave de API em vez de OAuth

No plano Enterprise, um cliente pode se conectar com um token de acesso pessoal em vez de fazer login. Use essa opção para um cliente que não possa fazer login com OAuth ou para um script.

  1. Abra Configurações e escolha Acesso à API.
  2. Em Tokens de acesso pessoal, escolha Criar token.
  3. Insira um Nome, escolha o Acesso e quando ele Expira e, em seguida, escolha Criar token.
  4. Em Copie seu token, copie o token. Ele só é exibido nesse momento.

Escolha o acesso de que o cliente precisa:

  • Somente leitura: o cliente vê apenas as ferramentas de leitura. Ele pode buscar e ler no seu Dvina, mas não pode adicionar nem alterar nada.
  • Leitura e gravação: o cliente vê todas as ferramentas, e as alterações continuam exigindo sua aprovação, assim como com OAuth.

Envie o token no cabeçalho Authorization, após Bearer. No Claude Code, por exemplo:

claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"

Em outro cliente, adicione o mesmo cabeçalho no local em que ele permite definir cabeçalhos para um servidor MCP.

O token atua em seu nome, no espaço de trabalho em que você o criou, com a função que você tem lá atualmente. Para substituí-lo, abra-o em Tokens de acesso pessoal e escolha Rotacionar…: um novo token o substitui, e o antigo para de funcionar imediatamente. Para desativá-lo, escolha Revogar…: tudo que usa esse token para de funcionar imediatamente.

Para saber mais sobre tokens, consulte Acesso à API.