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 データを操作できるようにします。

✨ 特徴

自然言語を使用して Merge API エンティティをクエリする
Mergeデータモデルとそのフィールドに関する情報を取得します
会話型インターフェースを通じてエンティティを作成および更新する
複数の Merge API カテゴリ (HRIS、ATS など) のサポート

📦 インストール

前提条件

Merge 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>は 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_TENANT : (オプション) Merge APIテナント(US、EU、APAC)。デフォルトはUS

サーバーを実行する

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