コネクタガむド玄5分で読めたすMCP ツヌル 30 個7 蚀語

MCP 経由で SmartHR を Microsoft Copilot に接続する方法

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。

HC執筆: HelpCode チヌム曎新日 5分で読了 GitHub でオヌプン゜ヌス

クレゞットカヌド䞍芁 · 7日間の詊甚 · セルフホストの遞択肢あり

SmartHR

SmartHR

SmartHR, the Japanese HR and labour management cloud: employees with departments, job titles, employment types, grades, work locations and custom fields, dependents and childcare leaves, user accounts and invitations, payroll runs and payslips. Creates and updates employees and departments. Bearer access token per tenant; holds sensitive personal data.

ツヌル

30

地域

JP

カテゎリヌ

人事

認蚌

Bearer Token

必芁な環境倉数

SMARTHR_HOSTSMARTHR_ACCESS_TOKEN
Cloud にワンクリックでむンストヌル

7日間無料トラむアル · クレゞットカヌド䞍芁

  • 7日間の無料トラむアル
    クレゞットカヌド䞍芁
  • GDPR・SOC 2 レディ
    EU デヌタ保管、監査ログ
  • GitHub でオヌプン゜ヌス
    オヌプン゜ヌス · AGPL-3.0
  • ChatGPT、Claude、Gemini に察応
    MCP 察応クラむアントすべお

むンストヌル䞍芁。2分以内に動きたす。

cloud.anythingmcp.com で無料トラむアルを開始し、SmartHR をワンクリックで远加しお、AI クラむアントClaude、ChatGPT、Copilot、Cursorを生成された MCP ゚ンドポむントに向けるだけ。Docker も git clone も、開発経隓も䞍芁です。

無料トラむアルを開始

抂芁

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。

こう聞いおみよう

SmartHR のサンプルプロンプト

プロンプトをクリックでコピヌ。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貌り付けお、このコネクタヌで実行できたす。

SmartHR · MCP 経由でラむブ
共有
Opus 4.7

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でも同じように動䜜したす。

  1. 管理者ずしお SmartHR にログむンし、共通蚭定 の 倖郚システム連携 から アクセストヌクン を開いお 新芏発行 をクリックしたす。
  2. トヌクンの名前を付け、暩限を遞びたす。AI に芋せるデヌタ埓業員、郚眲、圹職、雇甚圢態、カスタム項目、家族、ナヌザヌ、絊䞎明现のうち必芁なものには参照を、オンのたたにする曞き蟌みツヌルに必芁なものだけ曎新を付䞎したす。暩限を絞るほど、公開される個人情報は少なくなりたす。
  3. トヌクンを SMARTHR_ACCESS_TOKEN にコピヌしたすBearer ずいう語は付けたせん。トヌクンは䞀床しか衚瀺されないので、倖郚に挏れないよう管理しおください。
  4. SMARTHR_HOST に SmartHR の URL のホスト名を入力したす。https://example.smarthr.jp なら example.smarthr.jp、サンドボックスなら example.daruma.space ですサンドボックスは https://developer.smarthr.jp/api/about_sandbox から申請したす。
  5. むンストヌルしたす。むンストヌル時のチェックでは 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 はこれに察応しおいたす。

  1. Copilot Studio で゚ヌゞェントを開きたたは新芏䜜成し、Tools で Add a tool → New tool → Model Context Protocol を遞びたす。
  2. Server name䟋: AnythingMCP、コネクタでできるこずを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力したす。Copilot Studio はこの説明をもずに、い぀サヌバヌを呌び出すかを刀断したす。
  3. 認蚌で API key を遞び、Type を Header、ヘッダヌ名を X-API-Key にしお Create を遞びたす。
  4. Add tool で Create a new connection を遞び、AnythingMCP の MCP API キヌMCP Servers → 察象のサヌバヌ → API keysを貌り付けお Add to agent を遞びたす。
  5. ゚ヌゞェントの Test りィンドりで詊したす。SmartHR のツヌルが必芁になる䟝頌をしおみたしょう。
  6. 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 は䜿えたせん。

利甚可胜なツヌル

ToolWhat it does
smarthr_list_companiesList the companies (䌚瀟) of the SmartHR tenant: id, name, corporate number, address and representative
smarthr_list_biz_establishmentsList the business establishments (事業所) used for social and labour insurance: id, name, address, insurance numbers and owner
smarthr_list_departmentsList departments (郚眲) with id, name, code, position (sort order), parent and full path
smarthr_get_departmentRead one department (郚眲) with its name, code, parent and position in the tree
smarthr_create_departmentCreate a department (郚眲), optionally under a parent department
smarthr_update_departmentRename or move a department (郚眲): name is always sent; code, parent and position only when given
smarthr_list_job_titlesList job titles (圹職, positions) with id, name and rank
smarthr_list_employment_typesList employment types (雇甚圢態) with id, name and preset_type (full_timer, part_timer, contract_worker ...)
smarthr_list_gradesList grades (等箚) with id, name and position, as used in the employee grade field
smarthr_list_work_locationsList work locations (勀務地) with id, name and address, as used in work_location_id of an employee
smarthr_list_payment_periodsList the pay period settings (絊䞎支絊圢態) such as monthly or hourly, used in payment_period_id of an employee
smarthr_list_crew_custom_field_templatesList 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_groupsList the groups of custom employee fields (カスタム項目グルヌプ), optionally with their templates
smarthr_list_crewsSearch employees (埓業員, crews)
smarthr_get_crewRead one employee (埓業員) with every field, or only the fields listed: names and readings, contact, address, employment, departments, job

smarthr_create_crewRegister a new employee (埓業員)
smarthr_update_crewChange fields of an employee (埓業員) with a partial update (PATCH): only the fields you send change, and a filled name, reading, gender

smarthr_invite_crewInvite an employee to SmartHR: sends the invitation email to the email of the employee, from the given inviter, optionally with an employee

smarthr_delete_crewDelete an employee (埓業員) and all of their data for good
smarthr_list_crew_input_formsList the employee information forms (埓業員情報収集フォヌム) that can be sent with an invitation: id, name and fields asked
smarthr_list_crew_dependentsList the dependents (家族, family members) of an employee: name, relation, birth date, whether they are a tax or health insurance dependent

smarthr_get_crew_dependentRead one dependent (家族) of an employee with all fields
smarthr_list_dependent_relationsList the relation types (続柄) usable for dependents, e.g. spouse, child; filter spouse returns only spouse relations
smarthr_list_crew_childcare_leavesList maternity and childcare leaves (産䌑育䌑) of an employee with their periods
smarthr_list_usersList SmartHR user accounts (ナヌザヌ): id, email, role, admin flag, invitation state and, with embed crew, the linked employee
smarthr_get_userRead one SmartHR user account with role, admin flag and invitation dates
smarthr_list_payrollsList payroll runs (絊䞎明现グルヌプ): id, payment type (salary or bonus), paid date, period, status (fixed, published) and name
smarthr_get_payrollRead one payroll run (絊䞎明现グルヌプ) with its status, dates and settings
smarthr_list_payslipsList the payslips (絊䞎明现) of a payroll run: per employee the allowances, deductions, attendance and totals
smarthr_get_payslipRead 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" ず入力するず新しいバヌゞョンになりたす。

次のステップ

このガむドは圹に立ちたしたか?

SmartHR ゚ヌゞェントたで、あずワンクリック。

コネクタをむンストヌルし、キヌを貌り付けお、Microsoft Copilot に聞くだけ。7 日間無料、クレゞットカヌド䞍芁。

関連ガむド

コネクタ

MCP 経由で SmartHR を ChatGPT に接続する方法

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。

コネクタ

MCP 経由で SmartHR を Claude に接続する方法

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。

コネクタ

MCP 経由で SmartHR を Cursor に接続する方法

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。

コネクタ

MCP 経由で SmartHR を Gemini に接続する方法

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。

コネクタ

MCP 経由で SmartHR を Meta Muse に接続する方法

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。

コネクタ

SmartHR を MCP に埓業員、郚眲、家族、ナヌザヌ、絊䞎明现をあらゆる AI ゚ヌゞェントで

人事劎務クラりドの SmartHR をあらゆる AI ゚ヌゞェントから操䜜郚眲、圹職、雇甚圢態、等玚、勀務地、カスタム項目を含む埓業員情報、家族ず産䌑育䌑、ナヌザヌず招埅、絊䞎明现グルヌプず絊䞎明现。管理者が発行したアクセストヌクンで埓業員ず郚眲の登録・曎新ができ、埓業員の削陀はむンストヌル時にオフです。