Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
作者提供的说明(英文原文)
HEU Legal e-signature MCP: manage HEU documents and PDFs, prompt signers, download PDFs.
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
选择你使用的 AI 应用,然后复制设置。
通过 1/2 项检查 · 在你的电脑上运行
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude,但需要先准备
需要 Heu MCP 的密钥(在开发者网站注册,可能收费) · 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
SettingsDeveloperEdit Config
{
"mcpServers": {
"heu": {
"command": "uvx",
"args": [
"heu-mcp"
],
"env": {
"HEU_API_KEY": "your-value",
"HEU_BASE_URL": "your-value",
"HEU_DOWNLOAD_DIR": "your-value"
}
}
}
}只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 Heu MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Heu MCP,或回答中出现 Heu MCP 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 Heu MCP
Heu MCP 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器
A · 使用能连接 Heu MCP 的应用
可连接 Claude Code,但需要先准备
需要 Heu MCP 的密钥(在开发者网站注册,可能收费) · 需要先在电脑上安装 Python (uv)(只需一次)
打开开发者网站,注册账户并创建 API 密钥,下一步要用。可能收费。
获取密钥的方法见下方开发者的 README
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
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按 Enter 前,把“your-value”改成你的密钥
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
应能看到 Heu MCP 在列表中并显示已连接
用 Heu MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Heu MCP,或回答中出现 Heu MCP 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor,但需要先准备
需要 Heu MCP 的密钥(在开发者网站注册,可能收费) · 需要先在电脑上安装 Python (uv)(只需一次)
打开开发者网站,注册账户并创建 API 密钥,下一步要用。可能收费。
获取密钥的方法见下方开发者的 README
在 Heu MCP 的设置中,HEU_API_KEY, HEU_BASE_URL, HEU_DOWNLOAD_DIR 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 Heu MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Heu MCP,或回答中出现 Heu MCP 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code,但需要先准备
需要 Heu MCP 的密钥(在开发者网站注册,可能收费) · 需要先在电脑上安装 Python (uv)(只需一次)
打开开发者网站,注册账户并创建 API 密钥,下一步要用。可能收费。
获取密钥的方法见下方开发者的 README
在 Heu MCP 的设置中,HEU_API_KEY, HEU_BASE_URL, HEU_DOWNLOAD_DIR 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 Heu MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Heu MCP,或回答中出现 Heu MCP 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
Claude Code
claude mcp add heu --env HEU_API_KEY=your-value --env HEU_BASE_URL=your-value --env HEU_DOWNLOAD_DIR=your-value -- uvx heu-mcpClaude Desktop (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"
}
}
}
}Cursor (~/.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 (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"
}
}
}
}HEU_API_KEY 机密 必填 envHEU_BASE_URL envHEU_DOWNLOAD_DIR env这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月11日
发布者(Lucav21)不是仓库所有者(heulegal);可能是其他人代为上架的
代码最后更新于3个月前
我们还没有从 GitHub 读取这个仓库
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 2 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
你需要填写:HEU_API_KEY
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于3个月前,最新版本(0.5.2)于3个月前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。
同一分类中有:Puter MCP, XcodeBuildMCP, XcodeBuildMCP
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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.
| 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:
5135e7b2-196b-...).68).create_pdf_template)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
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 mcp add heu heu-mcp -e HEU_API_KEY=la_tua_api_key_qui
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:
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
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
| 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 | 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 |
| 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 |
| Tool | Parametri | Cosa ritorna |
|---|---|---|
get_heu_health | — | { message: "ok", status: 200 } se l'API è operativa |
| 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 |
| 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 |
| 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