Conectar o DeepSeek ao seu estúdio

O que é

O DeepSeek consulta os dados do seu estúdio (vendas, clientes, agenda, financeiro) pelo DeepSeek Harness, a ferramenta do DeepSeek para o computador que aceita conectores MCP. A conexão usa uma chave de API do sistema, com as permissões do usuário da chave. O DeepSeek só consulta: não altera nada no sistema.

⚠️ O site e o aplicativo de celular do DeepSeek (chat.deepseek.com) ainda não aceitam conectores personalizados. Quando aceitarem, este artigo será atualizado.

Quando usar

Você já usa os modelos do DeepSeek no computador e quer perguntar sobre o movimento do estúdio.
Você quer montar análises com os números reais do estúdio usando o DeepSeek.

Antes de começar

Tenha em mãos o endereço do conector e uma chave de API com “Permitir uso como conector de IA”, criados conforme o artigo Conecte sua IA. O DeepSeek Harness precisa estar instalado no computador; ele ainda está em versão de testes do próprio DeepSeek, e a forma de configurar pode mudar.

Passo a passo

Passo 1 — Adicionar o conector

No arquivo de configuração do DeepSeek Harness (~/.dsh/profiles/web/cordis.patch.yml), acrescente o trecho abaixo, trocando o endereço pelo que você copiou em Copiar endereço e hk_... pela sua chave:

- insert:
    - id: mcp-heya
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: heya
        transport: streamable-http
        url: https://seu-dominio/mcp
        headers:
          Authorization: Bearer hk_...

O endereço vai sem barra no fim.

Passo 2 — Abrir o DeepSeek Harness

Abra o DeepSeek Harness de novo. O conector heya aparece com as ferramentas listar_areas, buscar_ferramentas e executar_consulta.

Passo 3 — Perguntar

Pergunte, por exemplo: “quanto vendi esta semana no estúdio?”.

O que acontece depois

O DeepSeek busca a consulta certa, executa e responde com os números do sistema, com as permissões do usuário da chave.
A chave aparece na aba API Key com o Último uso atualizado.
Para cortar o acesso, revogue a chave na aba API Key: o DeepSeek perde o acesso em até 30 segundos.

Erros comuns e dúvidas

P: Consigo usar no aplicativo do DeepSeek no celular? R: Ainda não. O aplicativo e o site do DeepSeek não aceitam conectores personalizados. Use o DeepSeek Harness no computador.

P: O conector não conecta. O que conferir? R: Confira se o endereço termina em /mcp, sem barra no fim, e se a chave foi colada inteira, com Bearer e um espaço antes.

P: O DeepSeek diz que a chave precisa ter “Permitir uso como conector de IA”. Por quê? R: A chave foi criada sem essa opção. Edite a chave na aba API Key e marque Permitir uso como conector de IA.

P: Posso guardar a chave num arquivo compartilhado? R: Evite. Quem tiver a chave consulta o estúdio com as permissões do usuário dela. Cada pessoa deve usar a própria chave.

P: O DeepSeek pode alterar dados do sistema? R: Não. O conector só consulta. Alterações são feitas no sistema.