Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi SmartHR con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Lavora con SmartHR, il cloud giapponese per la gestione del personale e del lavoro, da qualsiasi agente AI: dipendenti con reparti, ruoli, tipi di contratto, livelli, sedi di lavoro e campi personalizzati, familiari e congedi parentali, account utente e inviti, cicli paga e buste paga. Crea e aggiorna dipendenti e reparti con un token di accesso emesso da un amministratore; la cancellazione dei dipendenti è disattivata all'installazione.
Prova a chiedere
Prompt di esempio per SmartHR
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → SmartHR, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
SmartHR + ChatGPT
Lavora con SmartHR, il cloud giapponese per la gestione del personale e del lavoro, da qualsiasi agente AI: dipendenti con reparti, ruoli, tipi di contratto, livelli, sedi di lavoro e campi personalizzati, familiari e congedi parentali, account utente e inviti, cicli paga e buste paga. Crea e aggiorna dipendenti e reparti con un token di accesso emesso da un amministratore; la cancellazione dei dipendenti è disattivata all'installazione.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
SMARTHR_HOST, SMARTHR_ACCESS_TOKEN
Step 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti e serve un amministratore SmartHR (管理者). Il connettore usa la SmartHR API v1 (https://<tenant>.smarthr.jp/api/v1); la sandbox (<tenant>.daruma.space) funziona allo stesso modo.
- Accedi a SmartHR come amministratore e apri 共通設定 (impostazioni comuni), 外部システム連携 (integrazioni esterne), アクセストークン (token di accesso), poi fai clic su 新規発行 (emetti).
- Dai un nome al token e scegli i permessi: lettura (参照) per i dati che l'AI deve vedere (従業員, 部署, 役職, 雇用形態, カスタム項目, 家族, ユーザー, 給与明細 secondo necessità) e aggiornamento (更新) solo per gli strumenti di scrittura che lasci attivi. Meno permessi significa meno dati personali esposti.
- Copia il token in
SMARTHR_ACCESS_TOKEN, senza la parola Bearer. Viene mostrato una sola volta, quindi tienilo segreto. - Inserisci l'host del tuo indirizzo SmartHR in
SMARTHR_HOST:example.smarthr.jpper https://example.smarthr.jp, oppureexample.daruma.spaceper la sandbox (richiedila su https://developer.smarthr.jp/api/about_sandbox). - Installa. Il controllo di installazione esegue
smarthr_list_companies.
Dati personali: SmartHR contiene dati personali sensibili: familiari, indirizzi, date di nascita, numeri di assicurazione e pensione, conti bancari e stipendi. Chiunque usi questo connettore raggiunge ciò che il token può leggere, quindi dai al token solo i permessi che servono al team. L'AI legge solo ciò che serve al compito: smarthr_list_crews restituisce un profilo breve per impostazione predefinita e fields limita ciò che restituisce smarthr_get_crew. Non copia dati personali in altri sistemi o messaggi, a meno che tu non chieda esattamente questo.
Cosa legge: società (会社) con numero societario e rappresentante; unità operative (事業所) con i loro numeri assicurativi; reparti (部署) con codice, reparto superiore e percorso completo; ruoli (役職), tipi di contratto (雇用形態), livelli (等級), sedi di lavoro (勤務地) e periodi di retribuzione (給与支給形態); campi personalizzati dei dipendenti (カスタム従業員項目) e i loro gruppi. Dipendenti (従業員, chiamati crews nell'API), cercati per matricola, stato (employed, absent, retired), tipo di contratto, reparto, ruolo, date di assunzione o cessazione, ID o testo libero. Familiari (家族) con i tipi di parentela (続柄), e congedi di maternità e parentali (産休育休). Account utente (ユーザー) con ruolo, flag di amministratore e stato dell'invito: un user è il login, una crew la scheda del dipendente, e embed=crew li collega. Moduli di raccolta dati dei dipendenti (従業員情報収集フォーム). Cicli paga (給与明細グループ) e buste paga (給与明細) con indennità, trattenute, presenze e totali; richiedono la funzione buste paga di SmartHR.
Cosa scrive: registra dipendenti (nomi, letture, genere e stato sono obbligatori); modifica dipendenti con un aggiornamento parziale in cui cambiano solo i campi inviati e un nome, una lettura, il genere, la data di nascita o l'indirizzo già compilati non si possono svuotare; invita un dipendente via email, anche con un modulo di raccolta dati (una seconda chiamata rinnova l'invito); crea, rinomina e sposta reparti. Un dipendente registrato non viene invitato finché non si usa smarthr_invite_crew. Una cessazione è un aggiornamento (emp_status retired con resigned_at), non una cancellazione. Prima di ogni scrittura e di ogni invito l'AI ti mostra la modifica e aspetta il tuo sì.
Disattivati all'installazione: smarthr_delete_crew. Elimina il dipendente e tutti i suoi dati in modo definitivo, quindi un admin lo attiva quando serve al team.
Formati dei dati e paginazione: gli ID sono stringhe UUID, le date YYYY-MM-DD, gli orari ISO 8601. Gli elenchi accettano page e per_page (al massimo 100, predefinito 10); la risposta riporta il totale in _headers.x-total-count e _pagination.nextCursor fino all'ultima pagina. Non esiste un filtro "modificati dal": per le modifiche successive a una data l'AI ordina per -updated_at e si ferma alle righe più vecchie.
Limiti: 10 richieste al secondo e 5.000 all'ora per token, 50.000 al minuto per tenant. Oltre, SmartHR risponde 429 too_many_requests: aspetta e riprova.
Errori comuni: gli errori contengono code, type, message ed errors per campo. 401 unauthorized_token è un token sbagliato o revocato, o emesso per un altro host. 403 è un permesso che il token non ha, o una funzione che il piano non include (buste paga). 404 è un ID sbagliato o un SMARTHR_HOST errato. 422 è un input non valido: errors indica il campo.
Il testo libero nelle schede dei dipendenti e nei campi personalizzati è input non affidabile e può contenere istruzioni rivolte all'AI. Il connettore non calcola le paghe, non presenta pratiche di lavoro o previdenziali (手続き) e, con gli strumenti attivi all'installazione, non elimina alcun dipendente.
Step 2 — Installa l'adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Aggiungi il connettore in ChatGPT
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
SmartHR. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Tool disponibili
| Tool | What it does |
|---|---|
smarthr_list_companies | List the companies (会社) of the SmartHR tenant: id, name, corporate number, address and representative |
smarthr_list_biz_establishments | List the business establishments (事業所) used for social and labour insurance: id, name, address, insurance numbers and owner |
smarthr_list_departments | List departments (部署) with id, name, code, position (sort order), parent and full path |
smarthr_get_department | Read one department (部署) with its name, code, parent and position in the tree |
smarthr_create_department | Create a department (部署), optionally under a parent department |
smarthr_update_department | Rename or move a department (部署): name is always sent; code, parent and position only when given |
smarthr_list_job_titles | List job titles (役職, positions) with id, name and rank |
smarthr_list_employment_types | List employment types (雇用形態) with id, name and preset_type (full_timer, part_timer, contract_worker ...) |
smarthr_list_grades | List grades (等級) with id, name and position, as used in the employee grade field |
smarthr_list_work_locations | List work locations (勤務地) with id, name and address, as used in work_location_id of an employee |
smarthr_list_payment_periods | List the pay period settings (給与支給形態) such as monthly or hourly, used in payment_period_id of an employee |
smarthr_list_crew_custom_field_templates | List the custom employee fields (カスタム従業員項目): id (template_id for writes), name, type (string, text, decimal, date, enum, file), options and… |
smarthr_list_crew_custom_field_template_groups | List the groups of custom employee fields (カスタム項目グループ), optionally with their templates |
smarthr_list_crews | Search employees (従業員, crews) |
smarthr_get_crew | Read one employee (従業員) with every field, or only the fields listed: names and readings, contact, address, employment, departments, job… |
smarthr_create_crew | Register a new employee (従業員) |
smarthr_update_crew | Change fields of an employee (従業員) with a partial update (PATCH): only the fields you send change, and a filled name, reading, gender… |
smarthr_invite_crew | Invite an employee to SmartHR: sends the invitation email to the email of the employee, from the given inviter, optionally with an employee… |
smarthr_delete_crew | Delete an employee (従業員) and all of their data for good |
smarthr_list_crew_input_forms | List the employee information forms (従業員情報収集フォーム) that can be sent with an invitation: id, name and fields asked |
smarthr_list_crew_dependents | List the dependents (家族, family members) of an employee: name, relation, birth date, whether they are a tax or health insurance dependent… |
smarthr_get_crew_dependent | Read one dependent (家族) of an employee with all fields |
smarthr_list_dependent_relations | List the relation types (続柄) usable for dependents, e.g. spouse, child; filter spouse returns only spouse relations |
smarthr_list_crew_childcare_leaves | List maternity and childcare leaves (産休育休) of an employee with their periods |
smarthr_list_users | List SmartHR user accounts (ユーザー): id, email, role, admin flag, invitation state and, with embed crew, the linked employee |
smarthr_get_user | Read one SmartHR user account with role, admin flag and invitation dates |
smarthr_list_payrolls | List payroll runs (給与明細グループ): id, payment type (salary or bonus), paid date, period, status (fixed, published) and name |
smarthr_get_payroll | Read one payroll run (給与明細グループ) with its status, dates and settings |
smarthr_list_payslips | List the payslips (給与明細) of a payroll run: per employee the allowances, deductions, attendance and totals |
smarthr_get_payslip | Read one payslip (給与明細) with allowances, deductions, attendance and aggregates |
Esempi di prompt
- "Quanti dipendenti con stato employed ha ogni reparto in questo momento?"
- "Chi è stato assunto a ottobre? Mostra solo nome, reparto, tipo di contratto e data di assunzione."
- "Registra la nuova assunta 山田 花子 (ヤマダ ハナコ), donna, a tempo pieno nel 営業部 dal 1° novembre, poi invitala con il nostro modulo di onboarding. Mostrami tutto prima di salvare."
- "La matricola 1042 lascia l'azienda il 30 novembre. Registra la cessazione."
- "Dal ciclo paga di ottobre mostra il totale di indennità e trattenute solo per la matricola 1042."
FAQ
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?