Dvina MCP

Use o Dvina a partir de outras aplicações com MCP

Ligue um cliente MCP, como o Claude Code, o ChatGPT ou o Cursor, ao Dvina, inicie sessão e permita que leia e adicione conteúdo ao seu Dvina com a sua aprovação.

Ver em Markdown

O Dvina tem o seu próprio servidor MCP. Ligue um cliente MCP, como o Claude Code, o ChatGPT ou o Cursor, e essa aplicação poderá pesquisar no seu Dvina, ler os seus documentos e a sua memória, e adicionar notas, tarefas e lembretes em seu nome.

Antes de começar

Precisa do endereço do servidor:

https://api.dvina.ai/mcp

Se a sua empresa alojar o Dvina nos seus próprios servidores, use o endereço da API do Dvina da empresa com /mcp no final. Peça-o ao seu administrador.

O servidor usa Streamable HTTP. Se o cliente pedir um protocolo de transporte, escolha HTTP.

Ligar 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 inicie sessão no Dvina.

ChatGPT

  1. Abra a secção do ChatGPT onde pode adicionar um servidor MCP.
  2. Introduza https://api.dvina.ai/mcp como endereço do servidor e escolha OAuth se lhe for pedido o método de início de sessão.
  3. Inicie sessão no Dvina quando o ChatGPT pedir.

Cursor

  1. Abra a secção do Cursor onde pode adicionar um servidor MCP.
  2. Adicione um servidor com o nome dvina e o endereço https://api.dvina.ai/mcp.
  3. Inicie sessão no Dvina quando o Cursor pedir.

Não precisa de um ID de cliente nem de um segredo. O cliente regista-se automaticamente no Dvina na primeira ligação.

Iniciar sessão

O servidor MCP do Dvina usa OAuth para iniciar a sua sessão no navegador:

  1. Inicie sessão no Dvina como habitualmente.
  2. Se pertencer a 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, verifique o nome da aplicação e depois escolha Permitir acesso. Escolha Negar se não reconhecer a aplicação.

O cliente mantém-se ligado, pelo que não precisa de iniciar sessão sempre que o utiliza.

O que um cliente pode fazer

O cliente tem acesso às ferramentas do Dvina e usa-as quando o seu pedido assim o exige:

Área O que o cliente pode fazer
Pesquisa Pesquisar nas tuas conversas, documentos, memória e mundo ao mesmo tempo.
Memória Listar e ler os teus ficheiros de memória, adicionar um novo ou alterar um existente.
Mundo Listar os teus tópicos, mostrar o que Dvina sabe sobre um tópico ou qualquer outro assunto e listar o teu Feed.
Documentos Listar, ler e pesquisar na tua Biblioteca, criar notas e pastas, carregar ficheiros e substituir, mover ou mudar o nome de um documento, ou movê-lo para o lixo.
Canvas Listar e ler os teus canvas, criar um canvas ou reescrever uma página.
Tarefas e objetivos Listar as tuas tarefas e ler o que fizeram, iniciar uma tarefa ou uma tarefa que contribui para um objetivo, dar mais trabalho a uma tarefa ou pará-la.
Mensagens agendadas Listar as mensagens agendadas, agendar uma mensagem ou um lembrete, uma única vez ou com repetição, ou cancelar um agendamento.
Agentes e competências Listar e ler os teus agentes e competências, criar um agente, adicionar uma competência ou alterar qualquer um deles.
Projetos Listar os teus projetos e mostrar a pasta e as tarefas recentes de um projeto.
Partilha Ver quem tem acesso a um item e o que outras pessoas partilharam contigo, ou conceder ou remover o acesso de alguém.
Definições Mostrar as tuas preferências ou ativar ou desativar a memória.

O cliente não pode eliminar nada de forma permanente, abrir ligações públicas, ligar ou desligar aplicações, nem alterar definições de administração ou faturação.

Aprovar alterações

As ações do cliente seguem as mesmas regras que se aplicam em todo o Dvina:

  • A leitura é feita sem pedir autorização.
  • A adição de algo novo, como uma nota, um ficheiro de memória ou uma tarefa, é feita sem pedir autorização. Nunca altera o que já existe.
  • A alteração ou remoção de algo, como mover um documento para o lixo, reescrever uma página de um canvas, parar uma tarefa ou partilhar um item, exige a tua aprovação prévia. O cliente mostra o resumo da alteração feito pelo próprio Dvina, e tu aprovas ou recusas. Se recusares, nada muda.

Nota

Se um cliente não te conseguir pedir confirmação, Dvina não faz a alteração através desse cliente. Faz a alteração na aplicação Dvina ou usa um cliente que consiga pedir confirmação.

O teu acesso e as regras da tua empresa

O cliente atua em teu nome, com acesso ao que podes ver e fazer no Dvina:

  • Só funciona enquanto fores membro do espaço de trabalho e apenas dentro do que a tua função permite.
  • Se o teu administrador desativar uma funcionalidade, como o carregamento de ficheiros, o cliente também não a pode usar.
  • O que o cliente adiciona ou altera passa pelas regras de proteção de dados da tua empresa, tal como na aplicação.
  • O que adiciona ou altera fica registado no teu registo de auditoria como uma ação do assistente em teu nome, com indicação do cliente de origem.
  • As ações do cliente contam para a tua utilização, dentro dos teus limites habituais.

Ligar com uma chave de API em vez de OAuth

No plano Enterprise, um cliente pode ligar-se com um token de acesso pessoal em vez de iniciar sessão. Usa esta opção para um cliente que não consiga iniciar sessão com OAuth ou para um script.

  1. Abre as Definições e escolhe Acesso à API.
  2. Em Tokens de acesso pessoal, escolhe Criar token.
  3. Introduz um Nome, escolhe o Acesso e quando Expira e, em seguida, escolhe Criar token.
  4. Em Copiar o teu token, copia o token. Só é mostrado desta vez.

Escolhe o acesso de que o cliente precisa:

  • Só de leitura: o cliente só vê as ferramentas de leitura. Pode pesquisar e ler o teu Dvina, mas não pode adicionar nem alterar nada.
  • Leitura e escrita: o cliente vê todas as ferramentas, e as alterações continuam a exigir a tua aprovação, tal como com OAuth.

Envia o token no cabeçalho Authorization, a seguir a Bearer. No Claude Code, por exemplo:

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

Noutro cliente, adiciona o mesmo cabeçalho no local onde podes definir cabeçalhos para um servidor MCP.

O token atua em teu nome, no espaço de trabalho onde o criaste, com a função que tens atualmente nesse espaço. Para o substituir, abre-o em Tokens de acesso pessoal e escolhe Rodar…: um novo token substitui o anterior, que deixa de funcionar imediatamente. Para o desativar, escolhe Revogar…: tudo o que o utiliza deixa de funcionar imediatamente.

Para saberes mais sobre tokens, consulta Acesso à API.