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(Model Context Protocol) 서버는 Merge API와 MCP 프로토콜을 지원하는 모든 LLM 공급자(예: 데스크톱용 Claude) 간의 통합을 제공하여 자연어를 사용하여 Merge 데이터와 상호 작용할 수 있도록 합니다.

✨ 특징

자연어를 사용하여 API 엔터티 병합 쿼리
병합 데이터 모델과 해당 필드에 대한 정보를 얻으세요.
대화형 인터페이스를 통해 엔터티를 생성하고 업데이트합니다.
다양한 Merge API 카테고리(HRIS, ATS 등) 지원

📦 설치

필수 조건

API 키와 계정 토큰 병합
Python 3.10 이상
자외선

독립 실행형 설치 프로그램으로 uv 설치하세요:

지엑스피1

또는 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> 은 병합 공통 모델의 이름입니다(예: 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 테넌트(미국, EU, 아시아 태평양). 기본값은 미국입니다.

서버를 실행하세요

uvx merge-mcp

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

MCP 프로토콜을 지원하는 Merge API와 LLM 공급자 간의 통합을 제공하여 HRIS, ATS 및 기타 범주에서 Merge 데이터와 자연어 상호 작용을 허용합니다.

Merge MCP Server