remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Fusionar servidor MCP

Este servidor MCP (Protocolo de contexto de modelo) proporciona integración entre Merge API y cualquier proveedor LLM que admita el protocolo MCP (por ejemplo, Claude for Desktop), lo que le permite interactuar con sus datos de Merge utilizando lenguaje natural.

✨ Características

Consultar entidades de la API de combinación mediante lenguaje natural
Obtenga información sobre sus modelos de datos Merge y sus campos
Crear y actualizar entidades a través de interfaces conversacionales
Compatibilidad con múltiples categorías de API de combinación (HRIS, ATS, etc.)

📦 Instalación

Prerrequisitos

Una clave API de combinación y un token de cuenta
Python 3.10 o superior
ultravioleta

Instalar uv con el instalador independiente:

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

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

o a través de pip:

# With pip.
pip install uv

# With pipx.
pipx install uv

🔌 Integración MCP

Agregue esta configuración a su archivo de configuración de cliente MCP.

En Claude Desktop, puedes acceder a la configuración en Configuración → Desarrollador → Editar configuración :

{
    "mcpServers": {
        "merge-mcp-server": {
            "command": "uvx",
            "args": ["merge-mcp"],
            "env": {
                "MERGE_API_KEY": "your_api_key",
                "MERGE_ACCOUNT_TOKEN": "your_account_token"
            }
        }
    }
}

Nota: Si el comando "uvx" no funciona, intente con la ruta absoluta (es decir, /Users/username/.local/bin/uvx)

🔍 Ámbitos

Los ámbitos determinan qué integraciones de herramientas están habilitadas en el servidor MCP. El servidor Merge MCP utiliza ámbitos para controlar el acceso a diferentes partes de la API Merge. Al iniciar el servidor, puede especificar qué ámbitos habilitar:

{
    "mcpServers": {
        "merge-mcp-server": {
            "command": "uvx",
            "args": [
                "merge-mcp",
                "--scopes",
                "ats.Job:read",
                "ats.Candidate",
                "ats.Application:write"
            ],
            "env": {
                "MERGE_API_KEY": "your_api_key",
                "MERGE_ACCOUNT_TOKEN": "your_account_token"
            }
        }
    }
}

Formato de alcance

Los ámbitos del servidor Merge MCP siguen un formato específico basado en la categoría de la API Merge y los nombres de modelos comunes. Cada ámbito tiene el siguiente formato:

<category>.<CommonModel>:<permission>

Dónde:

<category> es la categoría de la API de combinación (por ejemplo, hris , ats , accounting )
<CommonModel> es el nombre del modelo común de fusión (por ejemplo, Employee , Candidate , Account )
<permission> es read o write (opcional; si no se especifica, se conceden todos los permisos)

Ejemplos de ámbitos válidos:

hris.Employee:read : permite leer datos de empleados de la categoría HRIS
ats.Candidate:write - Permite crear o actualizar datos de candidatos en la categoría ATS
accounting.Account : permite todas las operaciones sobre datos de cuentas en la categoría Contabilidad

Puede combinar varios ámbitos para otorgar diferentes permisos:

Si no se especifica ningún ámbito, se habilitarán todos los ámbitos disponibles. Los ámbitos disponibles dependen de la configuración de su cuenta de Merge API y de los modelos a los que la cuenta vinculada tiene acceso.

Notas importantes sobre la disponibilidad del alcance

Los alcances deben tener referencias cruzadas con los alcances habilitados en su cuenta vinculada:

No coincide con la categoría : si especifica un alcance para una categoría que no coincide con su cuenta vinculada (por ejemplo, si utiliza ats.Job con una cuenta vinculada HRIS), no se devolverán herramientas para ese alcance.
Falta de coincidencia de permisos : si solicita un permiso que no está habilitado para su cuenta vinculada (por ejemplo, usar hris.Employee:write cuando solo está habilitado el acceso de lectura), no se devolverán las herramientas que requieran ese permiso.
Validación : el servidor validará automáticamente los alcances solicitados con lo que esté disponible en su cuenta vinculada y solo habilitará herramientas para alcances válidos y autorizados.

Los alcances generalmente corresponden a diferentes modelos o tipos de entidades en la API de combinación y controlan el acceso de lectura y escritura a estas entidades.

🚀 Herramientas disponibles

El servidor Merge MCP proporciona acceso a varios puntos finales de la API Merge como herramientas. Las herramientas disponibles dependen de la categoría de la API Merge (HRIS, ATS, etc.) y de los ámbitos habilitados.

Las herramientas se generan dinámicamente en función de su esquema de API de combinación e incluyen operaciones para:

Recuperando detalles de la entidad
Entidades de cotización
Creando nuevas entidades
Actualización de entidades existentes
Y más, según su configuración específica de Merge API

Nota: Las herramientas de descarga no son compatibles actualmente. Esta es una limitación conocida y se solucionará en una próxima versión.

🔑 Variables de entorno

El servidor Merge MCP utiliza las siguientes variables de entorno:

MERGE_API_KEY : Su clave API de Merge
MERGE_ACCOUNT_TOKEN : Su token de cuenta vinculada a la fusión
MERGE_TENANT : (Opcional) El inquilino de la API Merge (EE. UU., UE, APAC). El valor predeterminado es EE. UU.

Ejecutar el servidor

uvx merge-mcp

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Proporciona integración entre Merge API y proveedores LLM compatibles con el protocolo MCP, lo que permite la interacción en lenguaje natural con los datos de Merge en HRIS, ATS y otras categorías.

Merge MCP Server