Merge MCP连接器

@merge-api/merge-mcp

0 Stars 14 次浏览 merge-api 更新于 2026-08-23

为Merge API和支持MCP协议的LLM提供商之间提供了集成，允许跨人力资源信息系统（HRIS）、申请人跟踪系统（ATS）和其他类别的Merge数据进行自然语言交互。

交流协作工具开发者工具

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：MERGE_ACCOUNT_TOKEN、MERGE_API_KEY、MERGE_TENANT

服务介绍

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：

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

有效的范围示例：

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

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

如果不指定范围，则将启用所有可用范围。 可用范围取决于您的Merge API账户配置以及链接账户可以访问的模型。

关于范围可用性的注意事项

范围必须与您链接账户上启用的范围交叉引用：

类别不匹配：如果您为不匹配您的链接账户的类别指定了范围（例如，在HRIS链接账户下使用ats.Job），则不会返回该范围的工具。
权限不匹配：如果您请求了链接账户未启用的权限（例如，在只启用了读取权限的情况下使用hris.Employee:write），则需要该权限的工具将不会被返回。
验证：服务器将自动验证您请求的范围是否与链接账户中可用的范围相匹配，并且仅针对有效授权的范围启用工具。

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

🚀 可用工具

Merge MCP 服务器提供了访问各种 Merge API 端点作为工具的功能。可用的工具取决于您的 Merge API 类别（HRIS、ATS 等）以及您已启用的作用域。

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

检索实体详情
列出实体
创建新实体
更新现有实体
以及其他更多基于您的特定 Merge API 配置的操作

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

🔑 环境变量

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

MERGE_API_KEY：您的 Merge API 密钥
MERGE_ACCOUNT_TOKEN：您的 Merge 链接账户令牌
MERGE_TENANT：（可选）Merge API 租户（US, EU, APAC）。默认为 US

运行服务器

uvx merge-mcp

查看源码项目主页