Heu MCP

Name: Heu MCP
Author: lucavisconti211-debug

제작자: lucavisconti211-debug버전 0.1.2i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.lucavisconti211-debug/heu-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

HEU Legal e-signature MCP: manage HEU documents and PDFs, prompt signers, download PDFs.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 문서, 시트 및 사무 업무
입력해야 할 값: HEU_API_KEY

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
직접 입력할 값: HEU_API_KEY, HEU_BASE_URL, HEU_DOWNLOAD_DIR

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

PyPIPython의 uv 설치(uvx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "heu": {
      "command": "uvx",
      "args": [
        "heu-mcp"
      ],
      "env": {
        "HEU_API_KEY": "your-value",
        "HEU_BASE_URL": "your-value",
        "HEU_DOWNLOAD_DIR": "your-value"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add heu --env HEU_API_KEY=your-value --env HEU_BASE_URL=your-value --env HEU_DOWNLOAD_DIR=your-value -- uvx heu-mcp

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "heu": {
      "command": "uvx",
      "args": [
        "heu-mcp"
      ],
      "env": {
        "HEU_API_KEY": "your-value",
        "HEU_BASE_URL": "your-value",
        "HEU_DOWNLOAD_DIR": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "heu": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "heu-mcp"
      ],
      "env": {
        "HEU_API_KEY": "your-value",
        "HEU_BASE_URL": "your-value",
        "HEU_DOWNLOAD_DIR": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

HEU_API_KEY 비밀 필수 env
HEU Legal API key (Profile > API Keys, Enterprise plan required)
HEU_BASE_URL env
API base URL. Default: https://api.heulegal.com/v1
HEU_DOWNLOAD_DIR env
Directory where downloaded PDFs are saved. Default: /tmp

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 lucavisconti211-debug 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

문서, 시트 및 사무 업무 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 3531개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 3531개 중 9%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 3531개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Heu MCP, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: HEU_API_KEY

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.1.2)은 6개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Agent-Native Calendar

제작자: BuilderIO

Agent-Native Google Calendar - manage events, sync, and public booking

클라우드에서 실행★ 7,620MIT2개월 전 업데이트

설치

Excel MCP Server

제작자: haris-musa

Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.

내 컴퓨터에서 실행★ 4,276MIT7일 전 업데이트

설치

MCP Server for Excel

제작자: sbroenne

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

내 컴퓨터에서 실행★ 847MIT4일 전 업데이트

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

HEU Legal MCP Server

MCP server (Model Context Protocol) che collega l'API HEU Legal a Claude e a qualsiasi client MCP. Gestisce l'intero ciclo di vita dei documenti con firma elettronica (valida in 180+ paesi) direttamente in conversazione: dalla creazione all'invio in firma, dal sollecito al download del fascicolo legale completo.

Cosa puoi fare

Voglio...	Il server lo fa con...
📄 Vedere i miei documenti e templates	`list_heu_documents`, `list_pdf_documents`
✍️ Mandare un contratto in firma da un template	`create_heu_document`, `create_pdf_document`
🚀 Mandare in firma un PDF che ho sul computer, senza passare dalla piattaforma	`create_pdf_document_from_upload`
🤖 Far mappare i campi firma all'AI (analizza il PDF, posiziona i campi, invia)	`locate_pdf_text` + `create_pdf_document_from_upload`
🔔 Sollecitare chi non ha ancora firmato	`prompt_heu_document_signature`, `prompt_pdf_document_signature`
👀 Far leggere un contratto all'AI (riassunti, clausole, confronti) senza scaricarlo	`read_heu_document`, `read_pdf_document`
🪪 Estrarre i dati delle parti (P.IVA, codice fiscale, SDI, PEC, indirizzi)	`extract_heu_document_parties`, `extract_pdf_document_parties`
💾 Scaricare il PDF firmato	`download_heu_document_pdf`, `download_pdf_document`
⚖️ Scaricare il fascicolo legale completo (documento + audit trail + artefatti FES)	`download_pdf_bundle`, `download_pdf_audit_trail`
🧩 Creare/modificare templates PDF riutilizzabili via API	`create_pdf_template`, `update_pdf_template`, `preview_pdf_template`, `delete_pdf_template`
❌ Annullare una richiesta di firma inviata per errore	`cancel_pdf_document`
🩺 Controllare che l'API sia raggiungibile	`get_heu_health`

Due famiglie di oggetti:

Documenti nativi HEU — creati con l'editor in-app della piattaforma (ID a forma di UUID, es. 5135e7b2-196b-...).
PDF caricati — file PDF con firmatari e campi firma posizionati sopra (ID numerici, es. 68).

Requisiti

Python ≥ 3.10
API key HEU Legal — nella UI: Profile → API Keys → Generate API Key (richiede subscription Enterprise; massimo 2 chiavi attive)
Per i flussi da template: almeno un template creato sulla piattaforma (oppure crealo via API con create_pdf_template)

Installazione

Da PyPI:

pip install heu-mcp

Da sorgenti:

git clone https://github.com/heulegal/heu-mcp.git

cd heu-mcp python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

Configurazione

Claude Desktop

Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

"mcpServers": { "heu": { "command": "heu-mcp", "args": [], "env": { "HEU_API_KEY": "la_tua_api_key_qui" } } } }

Se installato da sorgenti con venv:

"mcpServers": { "heu": { "command": "/path/assoluto/heu-mcp/venv/bin/python", "args": ["/path/assoluto/heu-mcp/server.py"], "env": { "HEU_API_KEY": "la_tua_api_key_qui" } } } }

Riavvia Claude Desktop dopo la modifica.

Claude Code (CLI)

claude mcp add heu heu-mcp -e HEU_API_KEY=la_tua_api_key_qui

Server remoto (multi-utente)

Oltre alla modalità locale (stdio) descritta sopra, il progetto include un server remoto che espone gli stessi 28 tool via HTTPS, così gli utenti si collegano senza installare nulla: inseriscono la propria API key HEU una volta, in un flusso OAuth.

Caratteristiche:

Transport Streamable HTTP, autenticazione OAuth 2.1 con PKCE S256, Dynamic Client Registration e Client ID Metadata Document
Multi-utente: ogni connessione usa la API key del proprio utente, conservata cifrata (Fernet) e mai in chiaro nel database
Refresh token con rotazione e revoca automatica della sessione in caso di riuso sospetto
I/O di rete asincrono e parsing PDF su threadpool: una richiesta lenta non blocca gli altri utenti

Avvio locale

pip install -e ".[remote]"

export HEU_MCP_SECRET_KEY="$(python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')" export PUBLIC_URL="http://localhost:8080" export HEU_MCP_DB="./heu-mcp.db" heu-mcp-remote

Deploy su Fly.io

fly launch --no-deploy

fly volumes create heu_data --size 1 fly secrets set HEU_MCP_SECRET_KEY="$(python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')" fly secrets set PUBLIC_URL="https:// .fly.dev" fly deploy

Variabili d'ambiente del server remoto

Variabile	Descrizione	Default
`HEU_MCP_SECRET_KEY`	Chiave Fernet per cifrare le API key degli utenti (richiesta)	—
`PUBLIC_URL`	URL pubblico del servizio, senza slash finale (richiesta in produzione)	`http://localhost:8080`
`MCP_PATH`	Path dell'endpoint MCP	`/mcp`
`HEU_MCP_DB`	Percorso del database SQLite	`/data/heu-mcp.db`
`ACCESS_TOKEN_TTL` / `REFRESH_TOKEN_TTL`	Durata token in secondi	1 ora / 60 giorni

Endpoint esposti

Endpoint	Scopo
`/mcp`	Endpoint MCP (richiede bearer token)
`/.well-known/oauth-protected-resource`	Metadati risorsa protetta (RFC 9728)
`/.well-known/oauth-authorization-server`	Metadati authorization server (RFC 8414)
`/register` · `/authorize` · `/token`	Flusso OAuth 2.1
`/healthz`	Liveness probe

Variabili d'ambiente

Variabile	Descrizione	Default
`HEU_API_KEY`	API key HEU Legal (richiesta)	—
`HEU_BASE_URL`	URL base dell'API	`https://api.heulegal.com/v1`
`HEU_DOWNLOAD_DIR`	Cartella dove salvare i file scaricati	`/tmp`

Riferimento completo dei tool (28)

🩺 Health

Tool	Parametri	Cosa ritorna
`get_heu_health`	—	`{ message: "ok", status: 200 }` se l'API è operativa

📄 Documenti nativi HEU

Tool	Parametri	Cosa fa
`list_heu_documents`	`type` (document/template), `sort` (asc/desc), `created_from` + `created_to` (ISO 8601), `have_editors_signed` — tutti opzionali	Lista documenti/template con stato, membri, firme. ⚠️ Le due date vanno passate sempre insieme, altrimenti l'API può restituire risultati incompleti
`get_heu_document`	`document_id`	Dettaglio completo: nome, stato (`to_sign`/`in_progress`/`in_review`/`completed`/`signed`), owner, editors, members con `has_signed` e `signed_at`, tags
`list_heu_document_placeholders`	`document_id`	Elenco delle chiavi placeholder sostituibili nel testo del template
`create_heu_document` ✋	`source_document_id`, `email_subject`, `email_text`, `email_to` (lista), `document_name`, `document_type`, `placeholders` (mappa chiave→valore)	Crea un documento da un template, sostituisce i placeholder e lo condivide via email ai destinatari
`prompt_heu_document_signature` ✋	`document_id`	Invia il sollecito di firma. Limite: 1 ogni 24h per documento (429 con `Retry-After` se superato)
`read_heu_document`	`document_id`, `pages` (es. `"1-3"`, `"5"`, `"1,3,5-7"`), `layout`, `has_index`, `has_footer`	Estrae il testo del documento e lo restituisce in conversazione, senza salvare nulla su disco. Max 100 pagine se `pages` è omesso
`extract_heu_document_parties`	`document_id`, `pages`, `include_text`	Dati delle parti: combina i firmatari registrati con l'estrazione dal testo di codici fiscali, P.IVA, codice univoco SDI, email, PEC, luogo+data di nascita, indirizzi, CAP. Pattern ottimizzati per contratti italiani
`download_heu_document_pdf`	`document_id`, `layout` (codici UI: 100, 200-204, 210-214, 220-224, 230-234), `has_index`, `has_footer`, `output_path`	Genera e salva il PDF su disco; ritorna il path

📎 PDF caricati

Tool	Parametri	Cosa fa
`list_pdf_documents`	`type` (richiesto: document/template), `sort`	Lista PDF con stato (`to_sign`/`in_progress`/`signed`), tipo firma (FES/FEA), firmatari
`get_pdf_document`	`document_id`	Dettaglio: nome, stato, `signature_type`, date, firmatari con `has_read`/`has_signed`
`list_pdf_document_signers`	`document_id`	Firmatari del PDF: id, nome, email, ha letto, ha firmato
`list_pdf_document_signer_placeholders`	`document_id`, `signer_id`	Campi (firma/testo/checkbox) assegnati a un firmatario specifico, con posizione e stato di compilazione
`list_pdf_document_placeholders`	`document_id`	Tutti i campi del PDF
`create_pdf_document` ✋	`source_document_id`, `email_subject`, `email_body`, `signers` (con `source_id`, `full_name`, `email`), `document_name`, `signature_type` (fes/fea), `placeholders` precompilabili	Crea un PDF firmabile da un template esistente e invia gli inviti. Con `fea` servono crediti sufficienti (422 altrimenti)
`prompt_pdf_document_signature` ✋	`document_id`	Sollecito di firma per il PDF
`read_pdf_document`	`document_id`, `pages`	Estrae il testo del PDF (incluso quello firmato) e lo restituisce in conversazione
`extract_pdf_document_parties`	`document_id`, `pages`, `include_text`	Dati delle parti (come sopra) per i PDF caricati
`download_pdf_document`	`document_id`, `output_path`	Scarica il PDF — versione firmata se disponibile — e ritorna il path
`download_pdf_audit_trail`	`document_id`, `output_path`	Scarica l'audit trail: il registro PDF di chi ha letto/firmato e quando
`download_pdf_bundle`	`document_id`, `output_path`	Scarica lo ZIP del fascicolo legale: PDF firmato + audit trail + artefatti FES. Ideale per archiviazione a valore probatorio
`cancel_pdf_document` ✋	`document_id`	Annulla una richiesta di firma inviata: il documento sparisce dagli elenchi e i link di firma vengono invalidati. Rifiutato con 409 se qualcuno ha già firmato

🧩 Template PDF (gestione via API)

Tool	Parametri	Cosa fa
`create_pdf_template` ✋	`file_path` (PDF locale ≤ 5 MB), `document_name`, `signers` (`source_id`, `full_name`), `placeholders` (tipo, posizione %, pagina)	Crea un template riutilizzabile caricando un PDF dal computer. L'ID restituito si usa come `source_document_id` in `create_pdf_document`
`create_pdf_document_from_upload` ✋	`file_path`, `document_name`, `email_subject`, `email_body`, `signers` (con email), `placeholders`, `signature_type`	Scorciatoia completa: carica un PDF e lo manda subito in firma, senza creare prima il template. Il documento nasce `to_sign` e i firmatari ricevono l'email immediatamente
`locate_pdf_text`	`file_path` oppure `document_id`, `search_terms` (default: parole chiave firma), `pages`, `include_all_lines`	Trova le coordinate di testi nel PDF (in %, origine in basso a sinistra — lo stesso sistema dei placeholder). È il tool che permette all'AI di posizionare i campi da sola: cerca "Firma", i nomi delle parti o qualsiasi ancora, e ottiene pagina + posizione di ognuna
`preview_pdf_template`	`document_id`, `output_path`	Scarica un'anteprima annotata: ogni campo è disegnato come riquadro etichettato con tipo e firmatario. Per verificare le posizioni prima dell'invio

| update_pdf_template ✋ | document_id, signers (set completo sostitutivo), placeholders (idem; [] li ca

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

Heu MCP

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

문서, 시트 및 사무 업무 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Agent-Native Calendar

Excel MCP Server

MCP Server for Excel

제작자의 README

HEU Legal MCP Server

Cosa puoi fare

Requisiti

Installazione

Configurazione

Claude Desktop

Claude Code (CLI)

Server remoto (multi-utente)

Avvio locale

Deploy su Fly.io

Variabili d'ambiente del server remoto

Endpoint esposti

Variabili d'ambiente

Riferimento completo dei tool (28)

🩺 Health

📄 Documenti nativi HEU

📎 PDF caricati

🧩 Template PDF (gestione via API)