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.

合并 MCP 服务器

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

✨ 特点

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

📦安装

先决条件

合并 API 密钥和帐户令牌
Python 3.10 或更高版本
紫外线

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

# 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"

或者通过 pip：

# With pip.
pip install uv

# With pipx.
pipx install uv

🔌 MCP 集成

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

在 Claude Desktop 中，您可以通过**“设置”→“开发人员”→“编辑配置”**访问配置：

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

有效范围的示例：

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

您可以组合多个范围来授予不同的权限：

**如果未指定范围，则将启用所有可用范围。**可用范围取决于您的合并 API 帐户配置以及关联帐户可以访问的模型。

关于范围可用性的重要说明

范围必须与链接帐户上启用的范围进行交叉引用：

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

范围通常对应于 Merge API 中的不同模型或实体类型，它们控制对这些实体的读取和写入访问。

🚀 可用工具

合并 MCP 服务器提供对各种合并 API 端点的访问，这些端点以工具形式提供。可用的工具取决于您的合并 API 类别（HRIS、ATS 等）以及您启用的范围。

工具是根据您的合并 API 模式动态生成的，并包括以下操作：

检索实体详细信息
列出实体
创建新实体
更新现有实体
更多内容取决于您的具体合并 API 配置

**注意：**目前不支持下载工具。这是一个已知限制，将在后续版本中解决。

🔑 环境变量

Merge MCP 服务器使用以下环境变量：

MERGE_API_KEY ：您的合并 API 密钥
MERGE_ACCOUNT_TOKEN ：您的合并关联账户令牌
MERGE_TENANT ：（可选）合并 API 租户（美国、欧盟、亚太地区）。默认为美国

运行服务器

uvx merge-mcp

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

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

Merge MCP Server