aml

Este README fornece documentação detalhada sobre a configuração do servidor MCP do AML Watcher, com foco nos argumentos de ambiente usados no arquivo claude_desktop_config.json. Ele explica cada argumento, como definir ou modificar seus valores e como adicionar novos argumentos, se necessário.

Visão Geral

O servidor MCP é configurado para executar um contêiner Docker para triagem de AML (Antilavagem de Dinheiro). A configuração é definida no arquivo claude_desktop_config.json, que especifica o comando Docker, os argumentos e as variáveis de ambiente. As variáveis de ambiente (env) controlam o comportamento do processo de triagem AML, como parâmetros de pesquisa, opções de filtragem e configurações de monitoramento.

⚙️ Configuração

📝 Cadastro

• Se você já tem uma conta, visite o Portal do Desenvolvedor AML Watcher.
• Se você não tem uma conta, por favor clique aqui para entrar em contato conosco.

🔑 Como Gerar Sua Chave de API

• Navegue até o Portal do Desenvolvedor AML Watcher.
• Clique em “API Key” e copie-a.

🖥️ Uso com o Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

🐳 Docker

{
  "mcpServers": {
    "aml": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "API_KEY",
        "-e", "PER_PAGE",
        "-e", "MATCH_SCORE",
        "-e", "CATEGORIES",
        "-e", "ALIAS_SEARCH",
        "-e", "RCA_SEARCH",
        "-e", "COUNTRIES",
        "techamlw/aml-watcher"
      ],
      "env": {
        "API_KEY": "api_key",
        "PER_PAGE": "1"
      }
    }
  }
}

• Após esta integração, o usuário deve fornecer um nome de usuário.

🌐 Argumentos de Ambiente

Abaixo está uma explicação detalhada de cada argumento de ambiente especificado na seção env do claude_desktop_config.json. Cada argumento inclui sua finalidade, tipo, valor padrão, restrições e instruções para definir ou modificar seu valor.

Argumento	Tipo	Obrigatório	Valor Padrão	Descrição
API_KEY	String	Sim	N/A	A chave de API para autenticação.
COUNTRIES	Array	Não	N/A	Matriz de países para filtrar relatórios. Nota: Códigos de país ISO 3166-1 alfa-2 são suportados. Exemplo: [\"CA\", \"IN\"]. Veja os países suportados
PER_PAGE	Inteiro	Não	5	O número máximo de resultados a retornar.
MATCH_SCORE	Inteiro	Não	80	Nível de precisão da correspondência (0–100).
CATEGORIES	Array	Sim	N/A	Filtra relatórios por categorias (por exemplo, [\"SIP\", \"PEP Level 1\"]). Veja as categorias disponíveis
RCA_SEARCH	Booleano	Não	Verdadeiro	Se deve pesquisar em Parentes e Associados Próximos (RCA).
ALIAS_SEARCH	Booleano	Não	Verdadeiro	Se deve pesquisar em aliases.

Você pode definir parâmetros personalizados dentro da seção env do seu arquivo de configuração. Esses parâmetros são passados para o contêiner Docker como variáveis de ambiente.

🛠️ Como Adicionar Variáveis de Ambiente

Cada variável listada na matriz args usando -e deve ter uma chave correspondente na seção env. Se uma variável não estiver definida no bloco env, o sistema pode usar um valor padrão.

Por exemplo, se sua lista args contém:

"args": [
  "-e", "PER_PAGE",
  "-e", "MATCH_SCORE"
]

Então seu ambiente deve incluir:

"env": {
  "PER_PAGE": "1",
  "MATCH_SCORE": "80"
}

💡Dica: Se você quiser definir manualmente o valor de uma variável, certifique-se de usar exatamente o mesmo nome listado na seção de argumentos. Os nomes das variáveis devem corresponder exatamente, caso contrário, o contêiner Docker não receberá o valor corretamente.