# 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.

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:

```text
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

::: tabs

=== Claude Code

1. No terminal, execute:

    ```sh
    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.

> [!NOTE]
> 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](/docs/teams/audit-log) 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:

```sh
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](/docs/dvina-mcp/api-access).

## Relacionado

- [Aplicações personalizadas e servidores MCP](/docs/connectors/custom-apps)
- [Acesso à API](/docs/dvina-mcp/api-access)
- [Usar o comando dvina](/docs/dvina-mcp/cli)
- [Visão geral das equipas](/docs/teams/overview)