DingTalk

Servidor MCP DingTalk

Implementação do servidor Model Context Protocol (MCP) do DingTalk, permitindo que o Claude interaja com espaços de trabalho do DingTalk.

Ferramentas

1. dingtalk_search_users

   • Pesquisar usuários do DingTalk
   • Parâmetros obrigatórios:
     • query (string): Palavra-chave de pesquisa
   • Parâmetros opcionais:
     • exact_match (boolean, padrão: false): Se deve realizar correspondência exata
   • Retorna: lista de usuários correspondentes e suas informações básicas

2. dingtalk_get_user_info

   • Obter detalhes do usuário
   • Parâmetros obrigatórios:
     • user_id (string): ID do usuário
   • Retorna: informações detalhadas do usuário, incluindo:
     • Nome
     • Número do funcionário
     • Departamento
     • Data de admissão
     • Informações de contato (telefone, e-mail, etc.)

3. dingtalk_send_message

   • Enviar mensagem privada para usuário do DingTalk
   • Parâmetros obrigatórios:
     • user (string): Nome do usuário que receberá a mensagem
     • content (string): Conteúdo da mensagem
   • Retorna: confirmação de envio da mensagem

Configuração

1. Criar aplicativo DingTalk:

   • Acesse o Painel do desenvolvedor DingTalk
   • Clique em "Criar aplicativo"
   • Selecione "Aplicativo interno da empresa"
   • Preencha as informações do aplicativo e crie

2. Configurar permissões do aplicativo: Na página de detalhes do aplicativo, configure as seguintes permissões:

   • userinfo: Obter informações do usuário
   • message: Enviar mensagens
   • user: Obter lista de usuários

3. Obter credenciais do aplicativo:

   • Salve o AppKey e o AppSecret do aplicativo

Uso com Claude Desktop

Adicione a seguinte configuração em claude_desktop_config.json:

Método npx

{
  "mcpServers": {
    "dingtalk": {
      "command": "npx",
      "args": [
        "-y",
        "@darrenyao/server-dingtalk"
      ],
      "env": {
        "DINGTALK_APP_KEY": "your_app_key",
        "DINGTALK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Método docker

{
  "mcpServers": {
    "dingtalk": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DINGTALK_APP_KEY",
        "-e",
        "DINGTALK_APP_SECRET",
        "mcp/dingtalk"
      ],
      "env": {
        "DINGTALK_APP_KEY": "your_app_key",
        "DINGTALK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Variáveis de ambiente

1. DINGTALK_APP_KEY: Obrigatório. AppKey do aplicativo DingTalk
2. DINGTALK_APP_SECRET: Obrigatório. AppSecret do aplicativo DingTalk

Solução de problemas

Se encontrar erros de permissão, verifique:

1. Se o aplicativo configurou corretamente as permissões necessárias
2. Se o aplicativo foi instalado corretamente na empresa
3. Se as credenciais do aplicativo estão configuradas corretamente
4. Se o aplicativo obteve as permissões de acesso necessárias

Build

Build Docker:

docker build -t mcp/dingtalk -f Dockerfile .

Licença

Este projeto é licenciado sob a licença MIT. Isso significa que você pode usar, modificar e distribuir o software livremente, desde que cumpra os termos e condições da licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.