Eszerzodes MCP

Eszerződés.hu MCP Szerver

Az Eszerződés.hu MCP szerver lehetővé teszi, hogy AI eszközökkel (Claude, Cursor, stb.) természetes nyelven kezeld a szerződéseidet.

Gyors telepítés

1. Klónozás és build

git clone https://github.com/WiredSign/eszerzodes-mcp.git
cd eszerzodes-mcp
npm install
npm run build

2. Szerver indítása

# Fejlesztéshez (automatikus újratöltés)
npm run dev

# Éles környezetben
npm start

A szerver a http://localhost:3000 címen indul el.

3. Docker (opcionális)

npm run build
docker compose up -d

Beállítás

API kulcs konfigurálása

A szerver az Eszerződés.hu API-val kommunikál a te nevedben. Ehhez szüksége van a Bearer tokenedre, amit az eszerzodes.hu/api-tokens oldalon (Beállítások → API menüben) tudsz generálni.

A) Közvetlen token használat (fejlesztéshez)

Egyszerűen küldd el az Eszerződés.hu API tokenedet az Authorization headerben:

Authorization: Bearer 

B) MCP kulcs leképezés (éles környezethez)

Hozz létre egyedi MCP kulcsokat (ESZ_MCP_ prefixszel), és környezeti változókkal képezd le őket:

# Egyedi kulcsonként
export MCP_KEY_ugyfel1="eszerzodes_hu_bearer_token_ide"

# Vagy JSON map-ként
export MCP_KEY_MAP='{"ESZ_MCP_ugyfel1":"token1","ESZ_MCP_ugyfel2":"token2"}'

Ezután a kliens az ESZ_MCP_ugyfel1 kulcsot küldi, a szerver pedig leképezi a valódi tokenre.

Csatlakozás AI eszközökből

☁️ Felhő Relay (nincs szükség helyi szerverre)

Ha nem akarod saját gépen futtatni a szervert, csatlakozhatsz közvetlenül a felhő relay szerverünkhöz.

Claude Desktop

Szerkeszd a claude_desktop_config.json fájlt (Előfeltétel: Node.js telepítése szükséges):

{ "mcpServers": { "eszerzodes": { "command": "npx", "args": [ "-y", "mcp-remote", "https://api.eszerzodes.hu/mcp/mcp", "--header", "Authorization:Bearer " ] } } }

{ "mcpServers": { "eszerzodes": { "command": "cmd", "args": [ "/c", "npx", "-y", "mcp-remote", "https://api.eszerzodes.hu/mcp/mcp", "--header", "Authorization:Bearer " ] } } }

[!NOTE] Mivel a Claude Desktop UI jelenleg nem támogat egyedi fejléceket (headers), beépített proxy gyanánt az mcp-remote csomagot használjuk a felhő kapcsolathoz is. Ne felejtsd el telepíteni a -t!

Cursor / Windsurf / Cline

Használd a következő végpontot: https://api.eszerzodes.hu/mcp/mcp az Authorization headerrel együtt.

💻 Saját szerver (Helyi futtatás)

Claude Desktop

Szerkeszd a claude_desktop_config.json fájlt (Előfeltétel: Node.js telepítése szükséges):

{ "mcpServers": { "eszerzodes": { "command": "npx", "args": [ "-y", "mcp-remote", "http://localhost:3000/mcp", "--header", "Authorization:Bearer " ] } } }

{ "mcpServers": { "eszerzodes": { "command": "cmd", "args": [ "/c", "npx", "-y", "mcp-remote", "http://localhost:3000/mcp", "--header", "Authorization:Bearer " ] } } }

Fájl helye:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json vagy %LOCALAPPDATA%\Claude\claude_desktop_config.json

Keresés Windows-on: Ha nem találod, futtasd ezt PowerShellben: Get-ChildItem -Path $env:USERPROFILE -Recurse -Filter "claude_desktop_config.json" 2>$null

Mentés után: Teljesen zárd be a Claude Desktop-ot, majd indítsd újra.

Claude Code (CLI)

claude mcp add eszerzodes --transport http http://localhost:3000/mcp \
  -H "Authorization:Bearer "

Cursor / Windsurf / Cline

• URL: http://localhost:3000/mcp
• Header: Authorization:Bearer

Elérhető parancsok

A csatlakozás után természetes nyelven kérdezhetsz. Példák:

Összes elérhető eszköz

Szerződések (22 eszköz)

• contract_list — Szerződések listázása szűréssel és lapozással
• contract_get — Egy szerződés részleteinek lekérése ID alapján
• contract_get_by_own_id — Szerződés lekérése belső azonosító alapján
• contract_create — Új szerződés létrehozása sablonból
• contract_create_from_pdf — Szerződés létrehozása PDF URL-ből
• contract_create_from_html — Szerződés létrehozása HTML tartalomból
• contract_search — Szabad szöveges keresés szerződésekben
• contract_delete — Szerződés törlése
• contract_update_status — Belső státusz módosítása
• contract_sign — Szerződés aláírása
• contract_remove_signature — Aláírás visszavonása
• contract_add_comment — Megjegyzés hozzáadása
• contract_send_invitation — Meghívó küldése partnernek
• contract_cancel_invitation — Meghívó visszavonása
• contract_resend_invitation — Meghívó újraküldése
• contract_add_attachment — Melléklet hozzáadása (számla, link, szerződés)
• contract_remove_attachment — Melléklet eltávolítása
• contract_create_shared_link — Megosztási link létrehozása
• contract_list_shared_links — Megosztási linkek listázása
• contract_delete_shared_link — Megosztási link törlése
• contract_get_expiring — Hamarosan lejáró szerződések
• contract_status_list / create / update / delete — Egyedi státusz címkék kezelése

Partnerek és felhasználók (7 eszköz)

• party_list — Partnerek listázása
• party_search — Partner keresése név/email/cégnév alapján
• party_contracts — Egy partner összes szerződése
• coworker_list — Munkatársak listázása
• coworker_add — Munkatárs hozzáadása
• coworker_remove — Munkatárs eltávolítása
• user_info — Saját felhasználói adatok és előfizetés

Sablonok (11 eszköz)

• template_list — Elérhető sablonok listázása
• template_get — Sablon struktúra/séma lekérése
• template_get_fields — Sablon mezőinek listázása
• template_create — Új sablon létrehozása
• template_update — Sablon módosítása
• template_delete — Sablon törlése
• template_archive — Sablon archiválása/visszaállítása
• template_add_field / update_field / delete_field — Mezők kezelése
• template_reorder_fields — Mezők sorrendjének módosítása

Dokumentumok és AI (2 eszköz)

• document_get_download_url — Véglegesített szerződés PDF letöltési URL-je
• ai_extract — AI-alapú adatkinyerés szerződésből

Tesztelés

MCP Inspector

npx @modelcontextprotocol/inspector --url http://localhost:3000/mcp \
  --header "Authorization: Bearer "

Health check

curl http://localhost:3000/health
# {"status":"ok","service":"eszerzodes-mcp","version":"1.0.0"}

Követelmények

• Node.js 20+
• Érvényes Eszerződés.hu API hozzáférés (Bearer token)