Conectando um servidor MCP ao DeepSeek Harness: o arquivo de configuração que silenciosamente não faz nada

Introdução

Se você executar o DeepSeek Harness (dsh) e seu agente estiver derivando uma visão de mercado a partir de indicadores brutos a cada loop, você está pagando tokens de inferência para reinventar uma roda que já existe. O AlgoVault publica um veredicto composto por chamada, com um histórico ao vivo que você pode auditar: 91,5% de taxa de vitória PFE · 622.857+ chamadas verificadas · Ancorado em Merkle no Base L2. Nós fornecemos a tese; seu agente decide a execução.

Este post é a parte um de três. Ele possui a conexão: o que você já tem, o único arquivo que ativa a ponte e uma chamada real contra o servidor ao vivo. Ler o histórico de dentro do harness e o pacote de um comando são abordados separadamente.

O que você já tem

Não há etapa de instalação para descrever aqui, e isso pega quase todos os leitores de surpresa. O CLI dsh envia @deepseek-ai/dsh-mcp-client como uma dependência direta do próprio pacote CLI. A referência CLI do próprio fornecedor diz isso claramente: o CLI envia o cliente "como uma dependência para camadas de patch, mas nenhum servidor MCP é habilitado por padrão." O guia MCP do fornecedor vai direto para uma entrada de patch quando você traz outro servidor — ele nunca pede que você execute plugin add.

Portanto, a ponte já está dentro da sua instalação. O que está faltando é uma entrada de patch que nomeie o AlgoVault e aponte para o endpoint. Esse único arquivo é o trabalho inteiro deste post.

Se você já configurou um plugin OpenAPI ou uma ferramenta REST para dsh antes, desaprenda a memória muscular. Este não é esse fluxo. Não há manifesto para buscar, nenhum esquema para registrar, nenhum add para executar.

O arquivo de configuração que silenciosamente não faz nada

As entradas de patch vivem em uma camada de patch do usuário. A localização documentada é $DSH_HOME/profiles/<nome>/cordis.patch.yml quando você deseja que o servidor seja restrito a um perfil, ou $DSH_HOME/cordis.patch.yml quando você deseja que ele esteja em todos os perfis da máquina. $DSH_HOME tem como padrão ~/.dsh. Ambos os caminhos são do próprio fornecedor; nenhum é adivinhado.

Aqui está a armadilha, e é a razão pela qual este post existe.

O README do pacote @deepseek-ai/dsh-mcp-client mostra um exemplo de "Configuração mínima". É uma lista de entradas básica — a forma que um arquivo de composição bruto espera. Copie essa forma diretamente para sua camada de patch e ela será lida como uma substituição direcionada a um ID sem alvo. O harness não gerará erro. Ele irá avisar uma vez, não montará nada e começará de qualquer maneira. Seu agente tem todas as ferramentas que tinha ontem, e nenhuma das que você achou que adicionou.

Uma camada de patch precisa das mesmas entradas envoltas em um bloco - insert:, exatamente da maneira que os exemplos de sobreposição enviados pelo harness fazem. Esta é a forma correta:

- insert:
    mcp:
      servers:
        algovault:
          transport: streamable-http
          endpoint: https://api.algovault.com/mcp?src=deepseek_harness
          headers: {}

Compare isso com a forma que o README do pacote mostra verbatim, que é a forma que silenciosamente não faz nada quando colada em um arquivo de patch:

mcp:
  servers:
    algovault:
      transport: streamable-http
      endpoint: https://api.algovault.com/mcp?src=deepseek_harness

A única diferença entre os dois blocos é o wrapper - insert: e a mudança de indentação que ele força. Essa é a diferença total entre um agente que tem ferramentas do AlgoVault em sua próxima execução e um agente que não tem. A string de consulta ?src=deepseek_harness no endpoint é o slug de atribuição registrado para esta superfície — mantenha como está.

O aviso do próprio fornecedor também vale a pena ser levado em conta: não sobrescreva um cordis.patch.yml existente. Ele pode já conter patches de usuário não relacionados de uma sessão anterior ou de um plugin diferente. Anexe o bloco - insert:; não substitua o arquivo.

Passo a passo da implementação: primeira chamada

Uma vez que o arquivo de patch esteja no disco com a forma correta, reinicie dsh e o harness montará o servidor na próxima inicialização. As ferramentas aparecem para o modelo sob a convenção de nomenclatura do harness, mcp__<nomeDoServidor>__<ferramenta>. Com nomeDoServidor: algovault, o conjunto ao vivo é:

• o veredicto composto — mcp__algovault__get_trade_call
• a varredura do universo — mcp__algovault__scan_trade_calls
• a leitura do regime — mcp__algovault__get_market_regime
• o spread de financiamento — mcp__algovault__scan_funding_arb

Confirme a lista exata no seu tempo de rascunho pedindo ao harness por tools/list; a superfície está em desenvolvimento ativo e os nomes são a fonte da verdade do servidor, não de nenhum documento.

O nome do argumento no veredicto composto é coin, não symbol. Leia o esquema de entrada da ferramenta antes de conectá-lo em um loop de agente. Aqui está uma chamada real, e a resposta que veio de volta verbatim:

{
  "call": "HOLD",
  "confidence": 21,
  "price": 79409,
  "regime": "RANGING",
  "reasoning": "O preço caiu nas últimas 24h, o termo de momentum por trás da chamada → baixista. Contra: regime