MCP 服务器

Merge MCP Server

提供 Merge API 和支持 MCP 协议的 LLM 提供商之间的集成，从而实现与 HRIS、ATS 和其他类别中的 Merge 数据进行自然语言交互。

README

Merge MCP 服务器

此 MCP (模型上下文协议) 服务器提供 Merge API 和任何支持 MCP 协议的 LLM 提供商（例如，Claude for Desktop）之间的集成，使您可以使用自然语言与您的 Merge 数据进行交互。

✨ 功能

使用自然语言查询 Merge API 实体
获取有关您的 Merge 数据模型及其字段的信息
通过对话界面创建和更新实体
支持多个 Merge API 类别（HRIS、ATS 等）

📦 安装

前提条件

一个 Merge API 密钥和帐户令牌
Python 3.10 或更高版本
uv

使用独立安装程序安装 uv：

# 在 macOS 和 Linux 上。
curl -LsSf https://astral.sh/uv/install.sh | sh

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

或通过 pip：

# 使用 pip。
pip install uv

# 使用 pipx。
pipx install uv

🔌 MCP 集成

将此配置添加到您的 MCP 客户端配置文件。

在 Claude Desktop 中，您可以在 Settings → Developer → Edit Config 中访问配置：

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

注意：如果 "uvx" 命令不起作用，请尝试绝对路径（例如 /Users/username/.local/bin/uvx）

🔍 作用域

作用域确定在 MCP 服务器上启用哪些工具集成。 Merge MCP 服务器使用作用域来控制对 Merge API 不同部分的访问。启动服务器时，您可以指定要启用哪些作用域：

{
    "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"
            }
        }
    }
}

作用域格式

Merge MCP 服务器中的作用域遵循基于 Merge API 类别和通用模型名称的特定格式。每个作用域的格式如下：

<category>.<CommonModel>:<permission>

其中：

<category> 是 Merge API 类别（例如，hris、ats、accounting）
<CommonModel> 是 Merge 通用模型的名称（例如，Employee、Candidate、Account）
<permission> 是 read 或 write（可选 - 如果未指定，则授予所有权限）

有效作用域的示例：

hris.Employee:read - 允许从 HRIS 类别读取员工数据
ats.Candidate:write - 允许在 ATS 类别中创建或更新候选人数据
accounting.Account - 允许对 Accounting 类别中的帐户数据执行所有操作

您可以组合多个作用域以授予不同的权限：

如果未指定任何作用域，则将启用所有可用作用域。 可用作用域取决于您的 Merge API 帐户配置以及链接帐户有权访问的模型。

关于作用域可用性的重要说明

作用域必须与您的链接帐户上启用的作用域进行交叉引用：

类别不匹配：如果您为与您的链接帐户不匹配的类别指定作用域（例如，将 ats.Job 与 HRIS 链接帐户一起使用），则不会返回该作用域的任何工具。
权限不匹配：如果您请求未为您的链接帐户启用的权限（例如，在仅启用读取访问权限时使用 hris.Employee:write），则不会返回需要该权限的工具。
验证：服务器将自动根据您的链接帐户中可用的内容验证您请求的作用域，并且仅为有效、授权的作用域启用工具。

作用域通常对应于 Merge API 中的不同模型或实体类型，并且它们控制对这些实体的读取和写入访问权限。