摘要

在任意 AI 助手中查询你的 Jisr 人力资源组织：员工及其岗位数据、考勤汇总和打卡记录、年假余额、部门和地点。默认只读；提交打卡记录的功能可用，但默认关闭。

引导式设置

2 分钟将 Jisr 连接到 Meta Muse

开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Jisr，再把你的 MCP URL 添加到 Meta Muse。无需代码，也无需自行运行服务器。

免费设置 Jisr 我已有账户

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Jisr 的示例提示

点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。

Jisr · 通过 MCP 实时

Claude 是 AI，可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Jisr、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Jisr + Meta Muse

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

JISR_SLUG, JISR_API_KEY, JISR_API_SECRET

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要一个具有 Admin 角色的 Jisr 用户，因为只有 Admin 才能创建 API 密钥；还需要你的组织 slug，也就是你的 Jisr 地址的子域名。

在 Jisr 中打开 Settings → Webhook & API Keys → API Keys，点击 Add new API key（Jisr 帮助文章）。
为密钥命名，并勾选它可以使用的 API：Get List Employees、Get Employee Basic Information、Get attendance summary、View attendance records、View summary of employee annual leave，以及你需要的查找列表（lookups）。只有在允许 AI 查看薪资时才勾选 Get Employee Financial Info。
点击 Generate，把 API key 复制到 JISR_API_KEY，把 secret 复制到 JISR_API_SECRET。secret 只显示一次：如果丢失，请生成一个新密钥。
把 JISR_SLUG 设为你的组织 slug：即你的 Jisr 地址的子域名，用小写，例如 acme.jisr.net 对应 acme，不要填完整地址。
安装连接器。用 jisr_list_employees 检查连接。

Cloud 和自托管的方式相同：无需注册应用，也没有 Redirect URL；连接器只需要 slug、API key 和 secret。

连接器自动登录：它携带你的 slug、API key 和 secret 调用 POST /openapi/v1/auth，获得访问令牌，之后每次调用都通过 Access-Token 请求头发送该令牌，并附带 slug 和 api-version。API key 和 secret 只发送给这个登录调用。Jisr 拒绝令牌时，连接器会重新登录，因此无需手动续期。

托管在沙特阿拉伯的组织：如果你的 Jisr 地址以 .jisr.net.sa 结尾，你的组织使用 https://api.jisr.net.sa/api，而不是 https://apis.jisr.net/api。请把连接器的 base URL 和 login URL 改为该主机（login URL 为 https://api.jisr.net.sa/api/openapi/v1/auth）。

员工数据属于个人数据：员工记录包含出生日期、个人联系方式以及证件号和护照号。只在密钥上勾选需要的 API，并且只分享必要的信息。银行信息（IBAN）始终会从员工列表中移除；只要未勾选 Get Employee Financial Info，薪资就不会显示；只有密钥拥有相应权限时才会返回自定义字段。

员工的两种标识：每位员工有一个公开 id（UUID，例如 bab6cd98-7246-4cfc-a576-19bc00391792），用于 jisr_get_employee 和考勤汇总的筛选；还有一个数字 employee code（例如 43），用于打卡记录和假期余额。

日期和分页：日期格式为 YYYY-MM-DD；打卡时间为日期时间，例如 2026-11-01T08:00:00。不指定时间范围时，考勤汇总覆盖当月，打卡列表覆盖最近一小时。列表每页最多返回 100 条（page 从 1 开始，rpp 或 limit）；只要 data.pagination 中有 next_page，AI 就会继续读取。

常见错误：This call requires login 表示令牌已过期，连接器会重新登录。Organization not found with given subdomain 表示 JISR_SLUG 错误。登录被拒绝表示 slug、API key 或 secret 有误：重新复制，或在 secret 丢失时生成新密钥。403 表示该 API 密钥没有此 API 的权限：在 Settings → Webhook & API Keys 中编辑密钥并勾选该 API。

不包含：创建员工、薪资和计提交易、日记账、Webhook 和审计事件。

可读取的内容：员工，包括公开 id 和 employee code、英文和阿拉伯文姓名、工作和个人邮箱、电话、状态、职位、部门、地点、业务单元、雇佣类型、国籍、直属上级、入职日期、出生日期、证件号和护照号，以及离职和删除日期，可按状态和创建、入职、离职或删除日期筛选；单个员工的完整基本档案，包括个人信息、地址和联系方式；每位员工在某一期间的考勤汇总：工作时长、迟到和早退、额外工作时间、已批准加班、缺勤、无记录天数、休假天数、休息日、全天考勤豁免和出差天数；单条打卡记录，包括时间、设备序列号，以及被拒绝记录的 Jisr 错误信息；年假余额，包括期初和上年余额、手动调整、已用、待批和预留天数、无薪假扣减以及年末余额；部门、地点、雇佣类型、业务单元、国籍和外包公司列表，附英文和阿拉伯文名称。

安装时默认关闭：jisr_create_attendance_logs。它会像考勤机或门禁系统那样向 Jisr 提交最多 100 条打卡记录；Jisr 在后台处理这些记录，它们会更改员工的考勤记录。之后用 jisr_list_attendance_logs（状态 success 或 failed）查看结果。请只在需要时在连接器页面开启它；AI 在每次更改前都会先征得你的确认。其他所有工具都是只读的。

步骤 2 — 安装 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

步骤 3 — 在 Muse 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Muse 以自定义连接器的形式添加远程 MCP 服务器，并通过 OAuth 登录。

在 Muse 中打开 Settings → Connectors，选择 Add custom connector。
粘贴 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
Muse 会打开 AnythingMCP 的登录页面：登录并批准访问。
在聊天中，向 Muse 提出需要用到 Jisr 的工具的请求。

你也可以在聊天中完成设置，适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息：

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接，因此 localhost 无法使用。

可用工具

Tool	What it does
`jisr_list_employees`	List the organization's employees, 1 to 100 per page: for each the public id (UUID), employee code, English and Arabic full name, work and…
`jisr_get_employee`	Full basic profile of one employee by public id (UUID from jisr_list_employees or jisr_get_attendance_summary): personal details, address…
`jisr_get_attendance_summary`	Attendance totals per employee for a date range (the current month when no dates are given), ordered by employee code: for each employee…
`jisr_list_attendance_logs`	Individual attendance punches (clock-ins and clock-outs) in a time range, 1 to 100 per page: punch id, employee code, punch time, device…
`jisr_create_attendance_logs`	Send up to 100 attendance punches to Jisr, as a time clock or access-control system would
`jisr_get_annual_leave_summary`	Annual leave balances per employee: employee code, leave days, opening and previous-year balance, manual adjustments, days used, pending…
`jisr_list_lookup`	Reference lists of the organization: departments, locations, employment types, business units, nationalities or outsourcing companies, each…

示例提示

“最近 30 天有谁入职？分别在哪个部门和地点？”
“给我看本月的考勤汇总：谁的迟到和缺勤天数最多？”
“昨天 Jisr 拒绝了哪些打卡记录？各自的错误是什么？”
“员工代码为 43 和 77 的员工还剩多少天年假？”
“列出今年离职的员工，附上职位和离职日期。”

FAQ

Muse 在哪些地区可用？ Meta 目前在美国和加拿大提供 Muse，可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。

Meta 会审核这个连接器吗？ 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具，你也可以随时在 Settings → Connectors 中断开它。

下一步

这份指南对你有帮助吗?

将 Jisr MCP 连接到 Meta Muse

2 分钟将 Jisr 连接到 Meta Muse

Jisr 的示例提示

Jisr + Meta Muse

前提条件

步骤 1 — 获取凭证

步骤 2 — 安装 adapter

步骤 3 — 在 Muse 中添加连接器

可用工具

示例提示

FAQ

下一步

2 分钟将 Jisr 连接到 Meta Muse

相关指南

将 Jisr MCP 连接到 ChatGPT

将 Jisr MCP 连接到 Claude

将 Jisr MCP 连接到 Microsoft Copilot

将 Jisr MCP 连接到 Cursor

将 Jisr MCP 连接到 Gemini CLI

Jisr MCP 服务器：员工、考勤与休假