# 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. 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: ```text 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 ::: 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 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. > [!NOTE] > 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](/docs/teams/audit-log) 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: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer " ``` 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](/docs/dvina-mcp/api-access). ## Conteúdo relacionado - [Apps personalizados 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 equipes](/docs/teams/overview)