Jisr MCPをMicrosoft Copilotに接続

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Jisr をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Jisr + Microsoft Copilot

どの AI アシスタントからでも Jisr の人事組織について質問できます。従業員とその職務データ、勤怠サマリーと打刻、年次有給休暇の残日数、部署と勤務地を扱います。標準では読み取り専用で、打刻の送信も可能ですがオフになっています。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

JISR_SLUG, JISR_API_KEY, JISR_API_SECRET

ステップ 1 — 認証情報を取得

セットアップは約 5 分です。API キーを作成できるのは Admin だけなので、Admin ロールを持つ Jisr ユーザーが必要です。また、組織のスラッグ（Jisr のアドレスのサブドメイン）も必要です。

1. Jisr で Settings → Webhook & API Keys → API Keys を開き、Add new API key をクリックします（Jisr のヘルプ記事）。
2. キーに名前を付け、使用を許可する API にチェックを入れます: Get List Employees、Get Employee Basic Information、Get attendance summary、View attendance records、View summary of employee annual leave、および必要なルックアップ。Get Employee Financial Info には、AI に給与を見せてもよい場合だけチェックを入れてください。
3. Generate をクリックし、API key を JISR_API_KEY に、secret を JISR_API_SECRET にコピーします。secret は一度しか表示されません。紛失した場合は新しいキーを生成してください。
4. JISR_SLUG に組織のスラッグを設定します。Jisr のアドレスのサブドメインを小文字で入力し（acme.jisr.net なら acme）、アドレス全体は入れません。
5. コネクターをインストールします。jisr_list_employees で接続を確認してください。

Cloud とセルフホストは同じ手順です: 登録するアプリも Redirect URL もありません。コネクターに必要なのはスラッグ、API キー、secret だけです。

コネクターは自動でサインインします: スラッグ、API キー、secret を付けて POST /openapi/v1/auth を呼び出し、アクセストークンを受け取ると、以降のすべての呼び出しで slug と api-version とともに Access-Token ヘッダーで送ります。キーと secret が送られるのはこのサインインの呼び出しだけです。Jisr がトークンを拒否するとコネクターがサインインし直すので、更新作業は不要です。

サウジアラビアでホストされている組織: Jisr のアドレスが .jisr.net.sa で終わる場合、組織は https://apis.jisr.net/api ではなく https://api.jisr.net.sa/api を使います。コネクターのベース URL とログイン URL をこのホストに変更してください（ログイン URL は https://api.jisr.net.sa/api/openapi/v1/auth）。

従業員データは個人データです: 従業員レコードには生年月日、個人の連絡先、身分証明書番号やパスポート番号が含まれます。キーには必要な API だけを許可し、必要な情報だけを共有してください。銀行情報（IBAN）は従業員一覧から常に除かれます。給与は Get Employee Financial Info にチェックを入れない限り表示されません。カスタムフィールドはキーにその権限がある場合だけ返されます。

従業員の 2 つの識別子: 従業員には公開 id（bab6cd98-7246-4cfc-a576-19bc00391792 のような UUID）と数値の employee code（43 など）があります。id は jisr_get_employee と勤怠サマリーの絞り込みで、employee code は打刻と休暇残日数で使います。

日付とページ送り: 日付は YYYY-MM-DD、打刻時刻は 2026-11-01T08:00:00 のような日時です。期間を指定しない場合、勤怠サマリーは当月、打刻一覧は直近 1 時間が対象です。一覧は 1 ページ最大 100 件で（page は 1 から、rpp または limit）、data.pagination に next_page がある間、AI は続きを読み込みます。

よくあるエラー: This call requires login はトークンの期限切れを示し、コネクターがサインインし直します。Organization not found with given subdomain は JISR_SLUG が誤っていることを示します。サインインが拒否される場合は、スラッグ、API キー、secret のいずれかが誤っています。もう一度コピーするか、secret を紛失した場合は新しいキーを生成してください。403 は API キーにその API の権限がないことを示します。Settings → Webhook & API Keys でキーを編集し、その API にチェックを入れてください。

対象外: 従業員の作成、給与と引当の取引、仕訳、Webhook、監査イベント。

読み取れるデータ: 公開 id と employee code、英語とアラビア語の氏名、勤務用と個人のメールアドレス、電話番号、ステータス、役職、部署、勤務地、ビジネスユニット、雇用形態、国籍、上長、入社日、生年月日、身分証明書番号とパスポート番号、退職日と削除日を含む従業員（ステータスや作成日、入社日、退職日、削除日で絞り込み可能）、個人情報、住所、連絡先を含む従業員 1 人の基本プロフィール、期間ごとの従業員別の勤怠集計（労働時間、遅刻と早退、時間外の勤務、承認済み残業、欠勤、記録のない日、休暇日、休日、終日の勤怠免除、出張日数）、時刻と端末のシリアル番号、拒否された打刻については Jisr のエラーを含む個々の打刻、期首残高と前年残高、手動調整、取得済み・申請中・予約済みの日数、無給休暇の控除、年末残高を含む年次有給休暇の残日数、そして英語とアラビア語の名称付きの部署、勤務地、雇用形態、ビジネスユニット、国籍、アウトソーシング会社の一覧です。

インストール時はオフ: jisr_create_attendance_logs。タイムレコーダーや入退室管理システムと同じように、最大 100 件の打刻を Jisr に送信します。Jisr はそれをバックグラウンドで処理し、従業員の勤怠記録が変わります。結果は後から jisr_list_attendance_logs（ステータス success または failed）で確認します。必要な場合だけコネクターのページで有効にしてください。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 ウィンドウで試します。Jisr のツールが必要になる依頼をしてみましょう。
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 は使えません。

利用可能なツール

プロンプトの例

• 「この 30 日間に入社したのは誰ですか。部署と勤務地も教えてください。」
• 「今月の勤怠サマリーを見せてください。遅刻と欠勤の日数が最も多いのは誰ですか。」
• 「昨日 Jisr に拒否された打刻はどれですか。それぞれのエラーも教えてください。」
• 「従業員コード 43 と 77 の年次有給休暇はあと何日残っていますか。」
• 「今年退職した従業員を、役職と退職日付きで一覧にしてください。」

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 に接続