ã€ã³ã¹ããŒã«äžèŠã2å以å ã«åããŸãã
cloud.anythingmcp.com ã§ç¡æãã©ã€ã¢ã«ãéå§ããSmartHR ãã¯ã³ã¯ãªãã¯ã§è¿œå ããŠãAI ã¯ã©ã€ã¢ã³ãïŒClaudeãChatGPTãCopilotãCursorïŒãçæããã MCP ãšã³ããã€ã³ãã«åããã ããDocker ã git clone ããéçºçµéšãäžèŠã§ãã
æŠèŠ
人äºåŽåã¯ã©ãŠãã® SmartHR ããããã AI ãšãŒãžã§ã³ãããæäœïŒéšçœ²ã圹è·ãéçšåœ¢æ ãççŽãå€åå°ãã«ã¹ã¿ã é ç®ãå«ãåŸæ¥å¡æ å ±ãå®¶æãšç£äŒè²äŒããŠãŒã¶ãŒãšæåŸ ãçµŠäžæçŽ°ã°ã«ãŒããšçµŠäžæçްã管çè ãçºè¡ããã¢ã¯ã»ã¹ããŒã¯ã³ã§åŸæ¥å¡ãšéšçœ²ã®ç»é²ã»æŽæ°ãã§ããåŸæ¥å¡ã®åé€ã¯ã€ã³ã¹ããŒã«æã«ãªãã§ãã
ããèããŠã¿ãã
SmartHR ã®ãµã³ãã«ããã³ãã
ããã³ãããã¯ãªãã¯ã§ã³ããŒãClaude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw ã«è²Œãä»ããŠããã®ã³ãã¯ã¿ãŒã§å®è¡ã§ããŸãã
Claude 㯠AI ã®ãã誀ãããšããããŸããåçãã確èªãã ããã
ð¡ ã€ã³ã¹ããŒã«äžèŠ? cloud.anythingmcp.com ãçŽæ¥å©çšããŠãã ããã ãµã€ã³ã€ã³ããConnectors â SmartHR ãã¯ãªãã¯ãèªèšŒæ å ±ã貌ãä»ããMCP API ããŒãçºè¡ããã°å®äºã§ããDocker ã
git cloneãããŒã«ã«ãµãŒããŒãäžèŠã
SmartHR + Microsoft Copilot
人äºåŽåã¯ã©ãŠãã® SmartHR ããããã AI ãšãŒãžã§ã³ãããæäœïŒéšçœ²ã圹è·ãéçšåœ¢æ ãççŽãå€åå°ãã«ã¹ã¿ã é ç®ãå«ãåŸæ¥å¡æ å ±ãå®¶æãšç£äŒè²äŒããŠãŒã¶ãŒãšæåŸ ãçµŠäžæçŽ°ã°ã«ãŒããšçµŠäžæçްã管çè ãçºè¡ããã¢ã¯ã»ã¹ããŒã¯ã³ã§åŸæ¥å¡ãšéšçœ²ã®ç»é²ã»æŽæ°ãã§ããåŸæ¥å¡ã®åé€ã¯ã€ã³ã¹ããŒã«æã«ãªãã§ãã
åææ¡ä»¶
å®å šãªã»ããã¢ããæé ã¯ã³ãã¯ã¿èªäœã«çµã¿èŸŒãŸããŠããŸã (ã¹ãã¢ã§ã³ãã¯ã¿ãéžæãããšè¡šç€º)ãå¿ èŠãªç°å¢å€æ°:
SMARTHR_HOST, SMARTHR_ACCESS_TOKEN
ã¹ããã 1 â èªèšŒæ å ±ãååŸ
èšå®ã¯çŽ 5 åã§ãSmartHR ã®ç®¡çè
æš©éãå¿
èŠã§ããã³ãã¯ã¿ã¯ SmartHR API v1ïŒhttps://<tenant>.smarthr.jp/api/v1ïŒã䜿ããŸãããµã³ãããã¯ã¹ç°å¢ïŒ<tenant>.daruma.spaceïŒã§ãåãããã«åäœããŸãã
- 管çè ãšã㊠SmartHR ã«ãã°ã€ã³ããå ±éèšå® ã® å€éšã·ã¹ãã 飿º ãã ã¢ã¯ã»ã¹ããŒã¯ã³ ãéã㊠æ°èŠçºè¡ ãã¯ãªãã¯ããŸãã
- ããŒã¯ã³ã®ååãä»ããæš©éãéžã³ãŸããAI ã«èŠããããŒã¿ïŒåŸæ¥å¡ãéšçœ²ã圹è·ãéçšåœ¢æ ãã«ã¹ã¿ã é ç®ãå®¶æããŠãŒã¶ãŒãçµŠäžæçŽ°ã®ãã¡å¿ èŠãªãã®ïŒã«ã¯åç §ãããªã³ã®ãŸãŸã«ããæžã蟌ã¿ããŒã«ã«å¿ èŠãªãã®ã ãæŽæ°ãä»äžããŸããæš©éãçµãã»ã©ãå ¬éãããå人æ å ±ã¯å°ãªããªããŸãã
- ããŒã¯ã³ã
SMARTHR_ACCESS_TOKENã«ã³ããŒããŸãïŒBearer ãšããèªã¯ä»ããŸããïŒãããŒã¯ã³ã¯äžåºŠãã衚瀺ãããªãã®ã§ãå€éšã«æŒããªããã管çããŠãã ããã SMARTHR_HOSTã« SmartHR ã® URL ã®ãã¹ãåãå ¥åããŸããhttps://example.smarthr.jp ãªãexample.smarthr.jpããµã³ãããã¯ã¹ãªãexample.daruma.spaceã§ãïŒãµã³ãããã¯ã¹ã¯ https://developer.smarthr.jp/api/about_sandbox ããç³è«ããŸãïŒã- ã€ã³ã¹ããŒã«ããŸããã€ã³ã¹ããŒã«æã®ãã§ãã¯ã§ã¯
smarthr_list_companiesãå®è¡ãããŸãã
å人æ
å ±ã«ã€ããŠ: SmartHR ã«ã¯ãå®¶æãäœæãçå¹Žææ¥ãä¿éºã幎éã®çªå·ãå£åº§ã絊äžãšãã£ãæ©åŸ®ãªå人æ
å ±ãå«ãŸããŸãããã®ã³ãã¯ã¿ã䜿ãå
šå¡ããããŒã¯ã³ã§åç
§ã§ããç¯å²ã®ããŒã¿ã«å±ããããããŒã¯ã³ã«ã¯ããŒã ã«å¿
èŠãªæš©éã ããä»äžããŠãã ãããAI ã¯ã¿ã¹ã¯ã«å¿
èŠãªæ
å ±ã ããèªã¿åããŸããsmarthr_list_crews ã¯æ¢å®ã§ç°¡æçãªãããã£ãŒã«ã ããè¿ããsmarthr_get_crew ã fields ã§è¿ãé
ç®ãçµããŸããæç€ºçã«äŸé Œãããªãéããå人æ
å ±ãã»ãã®ã·ã¹ãã ãã¡ãã»ãŒãžã«æžãåãããšã¯ããŸããã
èªã¿åããããŒã¿: æ³äººçªå·ãšä»£è¡šè
ãå«ãäŒç€Ÿãä¿éºé¢ä¿ã®çªå·ãå«ãäºæ¥æãã³ãŒãã芪éšçœ²ããã«ãã¹ãå«ãéšçœ²ã圹è·ãéçšåœ¢æ
ãççŽãå€åå°ãçµŠäžæ¯çµŠåœ¢æ
ãã«ã¹ã¿ã åŸæ¥å¡é
ç®ãšãã®ã°ã«ãŒããåŸæ¥å¡ïŒAPI ã§ã¯ crewsïŒã¯ã瀟å¡çªå·ãåšç±ç¶æ³ïŒemployedãabsentãretiredïŒãéçšåœ¢æ
ãéšçœ²ã圹è·ãå
¥ç€Ÿæ¥ãéè·æ¥ãIDãããªãŒã¯ãŒãã§æ€çŽ¢ã§ããŸããå®¶æãšç¶æã®çš®é¡ãç£äŒè²äŒãããŒã«ã管çè
ãã©ã°ãæåŸ
ç¶æ³ãå«ããŠãŒã¶ãŒïŒãŠãŒã¶ãŒã¯ãã°ã€ã³ã¢ã«ãŠã³ããcrew ã¯åŸæ¥å¡æ
å ±ã§ãembed=crew ã§äž¡è
ãçŽã¥ããŸãïŒãåŸæ¥å¡æ
å ±åéãã©ãŒã ãæåœãæ§é€ã倿 ãåèšãå«ãçµŠäžæçŽ°ã°ã«ãŒããšçµŠäžæçްïŒSmartHR ã®çµŠäžæçްæ©èœãå¿
èŠã§ãïŒã
æžã蟌ããæäœ: åŸæ¥å¡ã®ç»é²ïŒæ°åãæ°åã®ããªã¬ããæ§å¥ãåšç±ç¶æ³ã¯å¿
é ïŒãåŸæ¥å¡ã®éšåæŽæ°ïŒéã£ãé
ç®ã ããå€ãããå
¥åæžã¿ã®æ°åãããªã¬ããæ§å¥ãçå¹Žææ¥ãäœæã空ã«ããããšã¯ã§ããŸããïŒãåŸæ¥å¡ãžã®ã¡ãŒã«ã§ã®æåŸ
ïŒåŸæ¥å¡æ
å ±åéãã©ãŒã ãæ·»ããããšãã§ãã2 åç®ã®åŒã³åºãã§åæåŸ
ã«ãªããŸãïŒãéšçœ²ã®äœæãååã®å€æŽãç§»åãç»é²ããåŸæ¥å¡ã¯ smarthr_invite_crew ãå®è¡ãããŸã§æåŸ
ãããŸãããéè·ã¯åé€ã§ã¯ãªãæŽæ°ïŒemp_status ã retired ã«ã㊠resigned_at ãèšå®ïŒã§èšé²ããŸããæžã蟌ã¿ãæåŸ
ã®åã«ã¯ãAI ã倿Žå
容ã瀺ããŠããªãã®åæãåŸ
ã¡ãŸãã
ã€ã³ã¹ããŒã«æã¯ãªã: smarthr_delete_crewãåŸæ¥å¡ãšãã®ãã¹ãŠã®ããŒã¿ãå®å
šã«åé€ãããããããŒã ã«å¿
èŠã«ãªã£ãã管çè
ããªã³ã«ããŸãã
ããŒã¿åœ¢åŒãšããŒãžã³ã°: ID 㯠UUID ã®æååãæ¥ä»ã¯ YYYY-MM-DDãæ¥æã¯ ISO 8601 ã§ããäžèŠ§ã¯ page ãš per_pageïŒæå€§ 100ãæ¢å® 10ïŒãåãåããã¬ã¹ãã³ã¹ã«ã¯ç·ä»¶æ°ã® _headers.x-total-count ãšãæåŸã®ããŒãžãŸã§ _pagination.nextCursor ãå«ãŸããŸããæŽæ°æ¥æã§çµã蟌ããã£ã«ã¿ãŒã¯ãªããããããæ¥ä»ä»¥éã®å€æŽã調ã¹ããšãã¯ãAI ã -updated_at ã§äžŠã¹æ¿ããŠå€ãè¡ã«éãããšããã§æ¢ããŸãã
å¶é: ããŒã¯ã³ããšã« 1 ç§ 10 ãªã¯ãšã¹ãã1 æé 5,000 ãªã¯ãšã¹ããããã³ãããšã« 1 å 50,000 ãªã¯ãšã¹ããŸã§ã§ããè¶
ãããš SmartHR 㯠429 too_many_requests ãè¿ãã®ã§ãåŸ
ã£ãŠããå詊è¡ããŠãã ããã
ãããããšã©ãŒ: ãšã©ãŒã«ã¯ codeãtypeãmessage ãšãé
ç®ããšã® errors ãå«ãŸããŸãã401 unauthorized_token ã¯ãããŒã¯ã³ã®èª€ããåé€ããŸãã¯å¥ã®ãã¹ãã§çºè¡ãããããŒã¯ã³ã§ãã403 ã¯ããŒã¯ã³ã«ä»äžãããŠããªãæš©éãããã©ã³ã«å«ãŸããªãæ©èœïŒçµŠäžæçްïŒã§ãã404 㯠ID ã®èª€ãã SMARTHR_HOST ã®èª€ãã§ãã422 ã¯å
¥åãšã©ãŒã§ãerrors ã«é
ç®ã瀺ãããŸãã
åŸæ¥å¡æ å ±ãã«ã¹ã¿ã é ç®ã®èªç±èšè¿°ã¯ä¿¡é Œã§ããªãå ¥åã§ãAI åãã®æç€ºãå«ãŸããŠããå¯èœæ§ããããŸãããã®ã³ãã¯ã¿ã¯çµŠäžèšç®ãè¡ãããåŽåã瀟äŒä¿éºã®æç¶ããè¡ããŸããããŸããã€ã³ã¹ããŒã«æã«ãªã³ã«ãªã£ãŠããããŒã«ã§ã¯åŸæ¥å¡ãåé€ããŸããã
ã¹ããã 2 â ã¢ããã¿ãŒãã€ã³ã¹ããŒã«
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
ã¹ããã 3 â Microsoft Copilot ã«ã³ãã¯ã¿ã远å
ãµãŒããŒURL: AnythingMCP ã§ MCP Servers ãéãããã®ã³ãã¯ã¿ããããµãŒããŒãéžãã§ URLïŒ
https://cloud.anythingmcp.com/mcp/âŠïŒãã³ããŒããŸãããã®ã¬ã€ãã§YOUR_SERVER_IDãšè¡šç€ºãããŠããç®æã«äœ¿ã£ãŠãã ããã
Microsoft Copilot ã¯ãCopilot Studio ã§äœæãããšãŒãžã§ã³ããéã㊠MCP ãµãŒããŒã䜿ããŸããAnythingMCP ãããŒã«ãšããŠãšãŒãžã§ã³ãã«è¿œå ãããã®ãšãŒãžã§ã³ãã Microsoft 365 Copilot ãš Teams ã«å ¬éããŸããCopilot Studio 㯠Microsoft ã®ã¯ã©ãŠããã Streamable HTTP ã§æ¥ç¶ããAnythingMCP ã¯ããã«å¯Ÿå¿ããŠããŸãã
- Copilot Studio ã§ãšãŒãžã§ã³ããéãïŒãŸãã¯æ°èŠäœæãïŒãTools ã§ Add a tool â New tool â Model Context Protocol ãéžã³ãŸãã
- Server nameïŒäŸ:
AnythingMCPïŒãã³ãã¯ã¿ã§ã§ããããšã説æãã Server descriptionãServer URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDãå ¥åããŸããCopilot Studio ã¯ãã®èª¬æãããšã«ããã€ãµãŒããŒãåŒã³åºããã倿ããŸãã - èªèšŒã§ API key ãéžã³ãType ã HeaderãããããŒåã
X-API-Keyã«ã㊠Create ãéžã³ãŸãã - Add tool ã§ Create a new connection ãéžã³ãAnythingMCP ã® MCP API ããŒïŒMCP Servers â 察象ã®ãµãŒã㌠â API keysïŒã貌ãä»ã㊠Add to agent ãéžã³ãŸãã
- ãšãŒãžã§ã³ãã® Test ãŠã£ã³ããŠã§è©ŠããŸãã
SmartHRã®ããŒã«ãå¿ èŠã«ãªãäŸé ŒãããŠã¿ãŸãããã - Publish ãéžã³ãChannels â Microsoft 365 and Microsoft Teams ã§ Make agent available in Microsoft Copilot ãéžæãããŸãŸ Add channel ãéžã³ãŸããSee agent in Teams ã§èªåçšã«ã€ã³ã¹ããŒã«ãããŸããMicrosoft 365 Copilot ã§ã¯ @ ãå ¥åããŠãšãŒãžã§ã³ããéžã³ãŸãã
ãŠãŒã¶ãŒããšã«ãµã€ã³ã€ã³ããããå Žåã¯ãAPI ããŒã®ä»£ããã« OAuth 2.0 â Dynamic discovery ãéžã³ãŸããåãŠãŒã¶ãŒã¯ããšãŒãžã§ã³ããåããŠåŒã³åºããšãã« AnythingMCP ã«ãµã€ã³ã€ã³ããŸãã
ã»ã«ããã¹ãã®å Žåã¯ãhttps://cloud.anythingmcp.com ã®ä»£ããã«ã€ã³ã¹ã¿ã³ã¹ã®å
¬é HTTPS ã¢ãã¬ã¹ã䜿ã£ãŠãã ãããCopilot Studio 㯠Microsoft ã®ã¯ã©ãŠãããæ¥ç¶ãããããlocalhost ã¯äœ¿ããŸããã
å©çšå¯èœãªããŒã«
| 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 |
ããã³ããã®äŸ
- ãåšç±ç¶æ³ã employed ã®åŸæ¥å¡ã¯ãããŸåéšçœ²ã«äœäººããŸããïŒã
- ã10 æã«å ¥ç€Ÿããã®ã¯èª°ã§ããïŒæ°åãéšçœ²ãéçšåœ¢æ ãå ¥ç€Ÿæ¥ã ããèŠããŠãã ãããã
- ãæ°å ¥ç€Ÿå¡ã® å±±ç° è±åïŒã€ãã ããã³ïŒããã女æ§ã11 æ 1 æ¥ãã å¶æ¥éš ã®æ£ç€Ÿå¡ãšããŠç»é²ãããã®ããšå ¥ç€Ÿæç¶ãçšã®ãã©ãŒã ãä»ããŠæåŸ ããŠãã ãããä¿åããåã«å 容ããã¹ãŠèŠããŠãã ãããã
- ã瀟å¡çªå· 1042 ã®æ¹ã 11 æ 30 æ¥ä»ã§éè·ããŸããéè·ãèšé²ããŠãã ãããã
- ã10 æã®çµŠäžæçްã°ã«ãŒãããã瀟å¡çªå· 1042 ã®æ¹ã®æåœãšæ§é€ã®åèšã ããèŠããŠãã ãããã
FAQ
ã©ã® Copilot ã察象ã§ãã? è·å Žã§äœ¿ã Microsoft 365 Copilot ã§ãCopilot Studio ã®ãšãŒãžã§ã³ããéããŠå©çšããŸããå人ã¢ã«ãŠã³ãåãã® Microsoft Copilot ã¢ããªã§ã¯ãç¬èªã® MCP ãµãŒããŒã远å ã§ããŸããã
äœãå¿ èŠã§ãã? ãšãŒãžã§ã³ããäœæããããã«ãCopilot Studio ãå©çšã§ããè·å Žã¢ã«ãŠã³ãïŒã©ã€ã»ã³ã¹ãŸãã¯è©ŠçšçïŒãå¿ èŠã§ããMicrosoft 365 Copilot ã Teams ã§ãšãŒãžã§ã³ãã䜿ã人ã«ã¯ããšãŒãžã§ã³ããžã®ã¢ã¯ã»ã¹æš©ãå¿ èŠã§ããå ±æãããã管çè ã«çµç¹åãã«å ¬éããŠããã£ãŠãã ãããçµç¹ã Power Platform ã³ãã¯ã¿ã«ããŒã¿ ããªã·ãŒãé©çšããŠããå Žåã¯ãMCP ãµãŒããŒã«ãé©çšãããŸãã
ãšãŒãžã§ã³ããããŒã«ãåŒã³åºããŸããã ããããŒåãæ£ç¢ºã« X-API-Key ã§ããããšãããŒã URL ãšåã MCP ãµãŒããŒã®ãã®ã§ããããšã確èªããServer description ãå
·äœçã«æžããŠãã ãããCopilot Studio ã¯ãã®èª¬æãããšã«ãµãŒããŒãåŒã³åºããã©ããã倿ããŸãã倿Žã®ãã³ã«ãšãŒãžã§ã³ããåå
¬éããéããŠãããã£ããã§ã¯ "start over" ãšå
¥åãããšæ°ããããŒãžã§ã³ã«ãªããŸãã
次ã®ã¹ããã
- ã³ãã¯ã¿ã®ã©ã³ãã£ã³ã°
- Claude ã«æ¥ç¶
- ChatGPT ã«æ¥ç¶
- Cursor ã«æ¥ç¶
- Gemini ã«æ¥ç¶
- Meta Muse ã«æ¥ç¶
ãã®ã¬ã€ãã¯åœ¹ã«ç«ã¡ãŸããã?