Atlan

oficial

Servidor MCP oficial de Atlan que te permite llevar el poder de los metadatos a tus herramientas de IA

GitHub

¿Qué puedes hacer con Atlan MCP?

Buscar activos — Encuentre activos de datos usando condiciones con search_assets.
Recuperar activos mediante DSL — Obtenga activos usando una consulta de lenguaje específico del dominio con get_assets_by_dsl.
Explorar linaje de datos — Trace relaciones ascendentes y descendentes de un activo usando traverse_lineage.
Actualizar metadatos de activos — Modifique descripciones de usuario y estado de certificados en activos mediante update_assets.
Gestionar glosarios de negocio — Cree glosarios, categorías y términos usando create_glossaries, create_glossary_categories y create_glossary_terms.
Gobernar reglas de calidad de datos — Cree, actualice, programe y elimine reglas de calidad de datos con create_dq_rules, update_dq_rules, schedule_dq_rules y delete_dq_rules.

Documentación

Servidor MCP de Atlan

[!WARNING] Este servidor MCP local está obsoleto. Utilice el MCP alojado de Atlan en mcp.atlan.com/mcp en su lugar.

La ruta de instalación local (Docker, uv o pip install atlan-mcp-server) está en modo de solo mantenimiento — sin nuevas funcionalidades, soporte no garantizado. El endpoint alojado es la forma recomendada de integrar Atlan con Claude Desktop, Cursor, Codex, Databricks UC y otros clientes MCP. Consulte la descripción general de Atlan MCP para la configuración.

El servidor de Protocolo de Contexto de Modelo de Atlan permite a sus agentes de IA interactuar con los servicios de Atlan.

Inicio Rápido

Genere una clave API de Atlan siguiendo la documentación.
Seleccione uno de los siguientes enfoques según su preferencia:
- Instalar vía Docker - Utiliza contenedores Docker (recomendado)
- Instalar vía uv - Utiliza el gestor de paquetes UV

[!NOTE] Asegúrese de reemplazar <YOUR_API_KEY>, <YOUR_INSTANCE> y <YOUR_AGENT_ID> con su clave API de Atlan, URL de instancia e ID de agente (opcional) reales en el archivo de configuración respectivamente.

Instalar vía Docker

Prerrequisitos:

Siga la guía oficial de instalación de Docker para su sistema operativo
Verifique que Docker esté en ejecución:
```
docker --version
```

Agregar a Claude Desktop

Vaya a Claude > Settings > Developer > Edit Config > claude_desktop_config.json y agregue:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

Agregar a Cursor

Abra Cursor > Settings > Tools & Integrations > New MCP Server para incluir lo siguiente:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

Instalar vía uv

Prerrequisitos:

Instale uv:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Alternative: if you already have Python/pip
pip install uv

Verifique la instalación:
```
uv --version
```

[!NOTE] Con uv, uvx obtiene automáticamente la última versión cada vez que lo ejecuta. Para un comportamiento más predecible, considere usar la opción de Docker.

Agregar a Claude Desktop

Vaya a Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir lo siguiente:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

Agregar a Cursor

Abra Cursor > Settings > Tools & Integrations > New MCP Server para incluir lo siguiente:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

Herramientas Disponibles

Herramienta	Descripción
`search_assets`	Buscar activos basados en condiciones
`get_assets_by_dsl`	Recuperar activos usando una consulta DSL
`traverse_lineage`	Recuperar el linaje de un activo
`update_assets`	Actualizar atributos de activos (descripción de usuario y estado de certificado)
`create_glossaries`	Crear glosarios
`create_glossary_categories`	Crear categorías de glosario
`create_glossary_terms`	Crear términos de glosario
`create_dq_rules`	Crear reglas de calidad de datos en activos de tipo Tabla, Vista, Vista Materializada o Tabla Dinámica de Snowflake (a nivel de columna, tabla, SQL personalizado)
`update_dq_rules`	Actualizar reglas de calidad de datos existentes (umbral, prioridad, condiciones, etc.)
`schedule_dq_rules`	Programar la ejecución de reglas de calidad de datos para activos usando expresiones cron
`delete_dq_rules`	Eliminar una o múltiples reglas de calidad de datos por GUID
`query_asset`	Ejecutar consultas SQL en activos de tabla/vista

Control de Acceso a Herramientas

El Servidor MCP de Atlan incluye un middleware configurable de restricción de herramientas que le permite controlar qué herramientas están disponibles para los usuarios. Esto es útil para implementar control de acceso basado en roles o restringir ciertas operaciones en entornos específicos.

Restringir Herramientas

Puede restringir el acceso a herramientas específicas usando la variable de entorno RESTRICTED_TOOLS. Proporcione una lista separada por comas de los nombres de herramientas que deben bloquearse:

Configuración Docker

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "-e",
        "RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

Configuración uv

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>",
        "RESTRICTED_TOOLS": "get_assets_by_dsl_tool,update_assets_tool"
      }
    }
  }
}

Nombres de Herramientas Disponibles para Restricción

Puede restringir cualquiera de las siguientes herramientas:

search_assets_tool - Funcionalidad de búsqueda de activos
get_assets_by_dsl_tool - Ejecución de consultas DSL
traverse_lineage_tool - Recorrido de linaje
update_assets_tool - Actualizaciones de activos (descripciones, certificados)
create_glossaries - Creación de glosarios
create_glossary_categories - Creación de categorías
create_glossary_terms - Creación de términos
create_dq_rules_tool - Creación de reglas de calidad de datos
update_dq_rules_tool - Actualización de reglas de calidad de datos
schedule_dq_rules_tool - Programación de reglas de calidad de datos
delete_dq_rules_tool - Eliminación de reglas de calidad de datos

Casos de Uso Comunes

Acceso de Solo Lectura

Restringir todas las operaciones de escritura:

RESTRICTED_TOOLS=update_assets_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

Deshabilitar Consultas DSL

Por razones de seguridad o rendimiento:

RESTRICTED_TOOLS=get_assets_by_dsl_tool

Acceso Mínimo

Permitir solo búsqueda básica:

RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool,traverse_lineage_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

Cómo Funciona

Cuando las herramientas están restringidas:

Ocultas de los listados: Las herramientas restringidas no aparecerán cuando los clientes soliciten las herramientas disponibles
Ejecución bloqueada: Si alguien intenta ejecutar una herramienta restringida, recibirá un mensaje de error claro
Registrado: Todas las decisiones de acceso se registran para monitoreo y depuración

Sin Restricciones (Predeterminado)

Si no establece la variable de entorno RESTRICTED_TOOLS, todas las herramientas estarán disponibles de forma predeterminada.

Modos de Transporte

El Servidor MCP de Atlan soporta tres modos de transporte, cada uno optimizado para diferentes escenarios de despliegue. Para más detalles sobre los modos de transporte MCP, consulte la documentación oficial de MCP.

Modo de Transporte	Caso de Uso	Beneficios	Cuándo Usarlo
stdio (Predeterminado)	Desarrollo local, integraciones IDE	Comunicación simple y directa	Claude Desktop, Cursor IDE
SSE (Eventos Enviados por el Servidor)	Despliegues remotos, navegadores web	Transmisión en tiempo real, compatible con web	Despliegues en la nube, clientes web
streamable-http	Conexiones remotas basadas en HTTP	HTTP estándar, compatible con balanceadores de carga	Kubernetes, despliegues en contenedores

Para instrucciones completas de despliegue, ejemplos de configuración y mejores prácticas de producción, consulte nuestra Guía de Despliegue.

Despliegue en Producción

Aloje la imagen del contenedor MCP de Atlan en la nube/plataforma de su elección
Asegúrese de agregar todas las variables de entorno requeridas
Elija el modo de transporte apropiado para su escenario de despliegue. Se recomienda el Transporte SSE para producción (-e MCP_TRANSPORT=sse)
Para escenarios de despliegue detallados y configuraciones, consulte la Guía de Despliegue

Configuración MCP Remota

Actualmente no tenemos un servidor MCP remoto para Atlan disponible de forma general.

Puede usar la herramienta proxy local mcp-remote para conectarlo a su servidor MCP remoto.

Esto le permite probar cómo sería una interacción con su servidor MCP remoto con un cliente MCP del mundo real.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": ["mcp-remote", "https://hosted-domain"]
    }
  }
}

Desarrollar Localmente

¿Quiere desarrollar localmente? ¡Consulte nuestra Guía de Compilación Local para un recorrido paso a paso!

¿Necesita Ayuda?

Contacte a support@atlan.com para cualquier pregunta o comentario
También puede crear directamente un issue en GitHub y le responderemos

Preguntas Frecuentes

¿Necesito tener Python instalado?

Respuesta corta: Depende de su método de instalación.

Docker (Recomendado): No se requiere instalación de Python en su máquina host. El contenedor incluye todo lo necesario.
uv: Se necesita un entorno de ejecución de Python, pero uv descargará y gestionará automáticamente Python 3.11+ por usted si aún no está disponible.

Detalles técnicos: El servidor MCP de Atlan está implementado como una aplicación Python. El Protocolo de Contexto de Modelo en sí es independiente del lenguaje, pero nuestra implementación actual requiere Python 3.11+ para ejecutarse.

Solución de Problemas

Si Claude Desktop muestra un error similar a spawn uv ENOENT {"context":"connection","stack":"Error: spawn uv ENOENT\n at ChildProcess._handle.onexit, lo más probable es que sea este problema donde Claude no puede encontrar uv. Para solucionarlo:
- Asegúrese de que uv esté instalado y disponible en su PATH
- Ejecute which uv para verificar la ruta de instalación
- Actualice la configuración de Claude para apuntar a la ruta exacta de uv ejecutando whereis uv y use esa ruta