aml

Este README proporciona documentación detallada sobre la configuración del servidor MCP de AML Watcher, centrándose en los argumentos de entorno utilizados en el archivo claude_desktop_config.json. Explica cada argumento, cómo establecer o modificar sus valores y cómo agregar nuevos argumentos si es necesario.

Descripción general

El servidor MCP está configurado para ejecutar un contenedor Docker para el cribado AML (Anti-Lavado de Dinero). La configuración se define en el archivo claude_desktop_config.json, que especifica el comando de Docker, los argumentos y las variables de entorno. Las variables de entorno (env) controlan el comportamiento del proceso de cribado AML, como los parámetros de búsqueda, las opciones de filtrado y la configuración de monitoreo.

⚙️ Configuración

📝 Registro

• Si ya tienes una cuenta, visita el Portal de Desarrolladores de AML Watcher.
• Si no tienes una cuenta, por favor haz clic aquí para contactarnos.

🔑 Cómo generar tu clave de API

• Navega al Portal de Desarrolladores de AML Watcher.
• Haz clic en "API Key" y cópiala.

🖥️ Uso con Claude Desktop

Agrega esto a tu 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"
      }
    }
  }
}

• Después de esta integración, el usuario debe proporcionar un nombre de usuario.

🌐 Argumentos de entorno

A continuación se presenta una explicación detallada de cada argumento de entorno especificado en la sección env del claude_desktop_config.json. Cada argumento incluye su propósito, tipo, valor predeterminado, restricciones e instrucciones para establecer o modificar su valor.

Argumento	Tipo	Requerido	Valor predeterminado	Descripción
API_KEY	Cadena	Sí	N/A	La clave de API para la autenticación.
COUNTRIES	Matriz	No	N/A	Matriz de países para filtrar informes. Nota: Se admiten códigos de país ISO 3166-1 alfa-2. Ejemplo: [\"CA\", \"IN\"]. Ver países admitidos
PER_PAGE	Entero	No	5	El número máximo de resultados a devolver.
MATCH_SCORE	Entero	No	80	Nivel de precisión de coincidencia (0–100).
CATEGORIES	Matriz	Sí	N/A	Filtra informes por categorías (p. ej., [\"SIP\", \"PEP Level 1\"]). Ver categorías disponibles
RCA_SEARCH	Booleano	No	Verdadero	Si se debe buscar dentro de Familiares y Asociados Cercanos (RCA).
ALIAS_SEARCH	Booleano	No	Verdadero	Si se debe buscar dentro de alias.

Puedes definir parámetros personalizados dentro de la sección env de tu archivo de configuración. Estos parámetros se pasan al contenedor Docker como variables de entorno.

🛠️ Cómo agregar variables de entorno

Cada variable listada en la matriz args usando -e debe tener una clave correspondiente en la sección env. Si una variable no está definida en el bloque env, el sistema puede usar un valor predeterminado.

Por ejemplo, si tu lista de args contiene:

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

Entonces tu entorno debe incluir:

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

💡Consejo: Si deseas establecer manualmente el valor de una variable, asegúrate de usar exactamente el mismo nombre que aparece en la sección de argumentos. Los nombres de las variables deben coincidir exactamente; de lo contrario, el contenedor Docker no recibirá el valor correctamente.