Ligar o DeepSeek ao seu estúdio

O que é

O DeepSeek consulta os dados do seu estúdio (vendas, clientes, agenda, financeiro) através do DeepSeek Harness, a ferramenta do DeepSeek para computador que aceita conectores MCP. A ligação utiliza uma chave de API do sistema, com as permissões do utilizador associado à chave. O DeepSeek só consulta: não altera nada no sistema.

⚠️ O site e a aplicação móvel do DeepSeek (chat.deepseek.com) ainda não aceitam conectores personalizados. Quando passarem a aceitar, este artigo será atualizado.

Quando usar

Já utiliza os modelos do DeepSeek no computador e quer perguntar sobre a atividade do estúdio.
Quer criar análises com os números reais do estúdio usando o DeepSeek.

Antes de começar

Tenha à mão o endereço do conector e uma chave de API com a opção “Permitir utilização como conector de IA”, criados de acordo com o artigo Ligue a sua IA. O DeepSeek Harness tem de estar instalado no computador; ainda está em fase de testes pelo próprio DeepSeek, e a forma de o configurar pode mudar.

Passo a passo

Passo 1 — Adicionar o conector

No ficheiro de configuração do DeepSeek Harness (~/.dsh/profiles/web/cordis.patch.yml), adicione o trecho abaixo, substituindo o endereço pelo que 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 não deve ter uma barra no final.

Passo 2 — Abrir o DeepSeek Harness

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

Passo 3 — Fazer uma pergunta

Por exemplo, pergunte: “quanto vendi esta semana no estúdio?”.

O que acontece depois

O DeepSeek procura a consulta certa, executa-a e responde com os números do sistema, de acordo com as permissões do utilizador associado à chave.
A chave aparece no separador API Key com o Último uso atualizado.
Para cortar o acesso, revogue a chave no separador API Key: o DeepSeek perde o acesso em até 30 segundos.

Erros comuns e dúvidas

P: Posso usar a aplicação do DeepSeek no telemóvel? R: Ainda não. A aplicação e o site do DeepSeek não aceitam conectores personalizados. Utilize o DeepSeek Harness no computador.

P: O conector não liga. O que devo verificar? R: Verifique se o endereço termina em /mcp, sem barra no final, e se a chave foi copiada por inteiro, incluindo Bearer e um espaço a seguir.

P: O DeepSeek diz que a chave tem de ter a opção “Permitir utilização como conector de IA”. Porquê? R: A chave foi criada sem essa opção. Edite a chave no separador API Key e selecione Permitir utilização como conector de IA.

P: Posso guardar a chave num ficheiro partilhado? R: Evite fazê-lo. Quem tiver a chave pode consultar o estúdio com as permissões do utilizador associado a ela. Cada pessoa deve utilizar a sua própria chave.

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