Jamf Pro MCP

io.github.Servosity由 GitHub 账号 Servosity 发布v0.1.0更新于 Nov 6, 2026

Every client's Jamf Pro in one CLI: find devices, check posture and patch status, audit policies.

概览

AI 生成的概览

本地 MCP 服务器与 CLI,让助手查询一个或多个 Jamf Pro 实例的设备、合规状态、补丁状态与策略卫生情况。

可以做什么
  • 按序列号、名称、用户名或邮箱跨已注册的 Jamf Pro 实例查找设备
  • 检查机群合规状态、补丁状态、应用版本与策略卫生,并与基线模板比对各实例
  • 查看 ADE 或 VPP 令牌到期、注册同步失败、Jamf Pro 版本等健康信息
  • 读取清单、脚本、策略等 Jamf Pro 对象,并执行通用 API 调用
  • 创建、更新或删除 Jamf Pro 对象、发送 MDM 命令、管理凭据,可先用试运行预览
  • 将各实例数据同步到本地 SQLite 镜像以便离线搜索
适用场景
适合管理多个 Jamf Pro 控制台的托管服务商或 IT 团队,希望在一次助手会话中回答跨客户问题,例如某台 Mac 属于哪个客户、哪些 Mac 未开启 FileVault。也适合只想做只读报表的单实例管理员。
运行要求
以本地 stdio 进程运行(也提供 Claude Desktop 的 .mcpb 安装包);多代理安装脚本需要 Node.js。需要 Jamf Pro 服务器地址(JAMF_PRO_SERVER)以及 API 客户端 ID 与密钥(JAMF_PRO_CLIENT_ID、JAMF_PRO_CLIENT_SECRET),或使用机群注册表配合 JAMF_PRO_FLEET_SECRETS。HTTP 传输需设置 JAMF_PRO_MCP_HTTP_TOKEN,非本地地址还需 TLS 证书。
安装前请注意
API 客户端密钥拥有其 Jamf Pro 角色授予的全部权限,应尽量缩小范围;设置 JAMF_PRO_MCP_READ_ONLY=1 可仅暴露只读工具。服务器包含写入、凭据管理、作用于客户设备的命令(如抹除、取消管理、MDM 命令)以及删除操作,需人工审核或限制。除非设置 JAMF_PRO_NO_LOCAL_DATA=1,本地 SQLite 镜像会保存 API 响应数据。项目处于测试阶段,尚未在真实租户上运行验证。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Jamf Pro MCP,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Jamf Pro + AI - for ChatGPT, Claude, GitHub Copilot, Microsoft 365 Copilot, Gemini, and any agent that speaks MCP

Unofficial. Community-built Claude Code Skill and MCP server for the Jamf API. Not affiliated with, endorsed by, or sponsored by JAMF Software, LLC.

[Jamf Pro demo - animated preview]

▶ Watch the 30-second demo - demo data is simulated; every command shown exists in the real CLI.

Every client's Jamf Pro in one CLI: register each instance once, then find devices, check posture and patch status, and audit policies across all of them. Works with the AI you already use - ChatGPT (Plus/Pro+), Claude Desktop, Codex, Claude Code, Claude Cowork, and GitHub Copilot - plus Microsoft 365 Copilot / Copilot Studio and Google Gemini via the remote path. Free, open source, runs on your laptop. Built for MSP owners. No code required.

Works with your agent

The six agents MSP owners actually use (self-serve, works today):

Your AI agentHow to install the Jamf Pro skill
Claude DesktopRun installer, then Settings > Extensions to register jamf-pro-mcp (no JSON editing).
ChatGPT (paid plans)Run installer, host jamf-pro-mcp over HTTPS with JAMF_PRO_MCP_HTTP_TOKEN set, then register it as a Developer Mode connector if your connector settings can send the bearer token.
Codex CLIPaste the install prompt below.
Claude CodePaste the install prompt below.
Claude CoworkPaste the install prompt below.
GitHub Copilot (VS Code)Run installer, add jamf-pro-mcp to mcp.json under the servers key, then pick Agent mode.

For ChatGPT, run jamf-pro-mcp --transport http with JAMF_PRO_MCP_HTTP_TOKEN set, on an HTTPS host; every request sends that token. See mcp-install.md.

Also for the Microsoft and Google stacks

Big install base, but an honest heads-up: these are the remote / enterprise path, not the local binary you just installed.

AgentWhat it takes
Microsoft 365 Copilot / Copilot StudioNot self-serve. Host jamf-pro-mcp over HTTPS with JAMF_PRO_MCP_HTTP_TOKEN set, then wire it into Copilot Studio (Tools > Add a tool > Model Context Protocol > Server URL) or a declarative agent, if it can send the bearer token. Needs a Copilot Studio license + tenant admin. See mcp-install.md.
Google GeminiGemini CLI is local - same as Claude Code. The Gemini app is remote - same HTTPS path as ChatGPT. See mcp-install.md.

Skill-native agents (also covered): Hermes and OpenClaw read this skill's SKILL.md directly and speak MCP - see their install sections below. Also works with Cursor, Windsurf, Cline, Continue.dev, and Zed via MCP. Full per-tool wire-up: docs/which-agent.md.

Run more than one agent? Install across all 51+ supported agents in one command: npx skills add Servosity/msp-skills@latest (requires Node.js, then run the per-skill installer for the CLI/MCP binaries). See docs/which-agent.md.

Install in 60 seconds

Fastest for Claude Desktop - one-click .mcpb

Download Jamf Pro MCP (.mcpb) - then open Claude Desktop > Settings > Extensions and select the file. One click, no JSON, no shell. (Browse every Jamf Pro release on the releases page.)

Prefer the Claude Code plugin? Add the marketplace once, then install - works immediately, no directory listing required:

/plugin marketplace add Servosity/msp-skills/plugin install jamf-pro@msp-skills

Path A - paste one prompt into your AI agent (recommended)

Copy this into Claude Code, Codex CLI, or Claude Cowork:

Install the Jamf Pro Skill and MCP server from Servosity/msp-skills in this agent workspace. If this workspace uses a POSIX shell (macOS, Linux, WSL, or Bash), run bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jamf-pro/install.sh). If it uses Windows PowerShell, run iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jamf-pro/install.ps1 | iex. Then authenticate per the README and run jamf-pro-cli --help to explore.

The same prompt works in any agent that can run shell.

Path B - run the installer yourself

Windows (PowerShell):

powershell
iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jamf-pro/install.ps1 | iex

macOS / Linux:

bash
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jamf-pro/install.sh)

The installer drops both jamf-pro-cli (the CLI) and jamf-pro-mcp (the MCP server) into your user bin path. Claude Code, Codex, and Cowork discover the Skill via SKILL.md in this directory.

Verify:

bash
jamf-pro-cli --version

Upgrade to the latest version

The installer always fetches the current release - re-run it to upgrade:

macOS / Linux:

bash
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jamf-pro/install.sh)

Windows (PowerShell):

powershell
iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jamf-pro/install.ps1 | iex

Claude Desktop .mcpb users: download the latest .mcpb (top of this section) and re-select it in Settings > Extensions. Claude Code plugin users: /plugin update jamf-pro@msp-skills.

Add to Claude Desktop, GitHub Copilot, Gemini CLI, Microsoft 365 Copilot, or another MCP client

After the installer runs, see mcp-install.md and docs/which-agent.md for the per-agent wire-up - one section per agent, including the GitHub Copilot servers key and the remote Microsoft 365 Copilot / Copilot Studio path. Claude Desktop's Settings > Extensions panel is the simplest path; the MCP config block (for users who prefer editing JSON) is documented in mcp-install.md.

Install for Hermes

From the Hermes CLI:

bash
hermes skills install servosity/msp-skills/skills/jamf-pro --force

Inside a Hermes chat session:

/skills install servosity/msp-skills/skills/jamf-pro --force

Hermes speaks MCP natively, so it can also use the jamf-pro-mcp server directly - same install path, same env vars.

Install for OpenClaw

Tell your OpenClaw agent (copy this):

Install the jamf-pro skill from https://github.com/servosity/msp-skills/tree/main/skills/jamf-pro. The skill defines how its required CLI (jamf-pro-cli) can be installed via the openclaw: frontmatter block.

OpenClaw isn't generally available yet; the frontmatter wiring is pre-shipped and will activate the moment OpenClaw launches.

Authenticate

Create an API client in each client's Jamf Pro (Settings > System > API roles and clients), with only the privileges your reports need. Then register each instance once. The secret stays in an environment variable you name, and is never written to the registry.

macOS / Linux:

bash
export JAMF_PRO_FLEET_SECRETS="acme=<client-secret>"jamf-pro-cli instance add acme --server acme.jamfcloud.com --client-id <client-id>jamf-pro-cli instance test

Windows (PowerShell):

powershell
$env:JAMF_PRO_FLEET_SECRETS = "acme=<client-secret>"jamf-pro-cli instance add acme --server acme.jamfcloud.com --client-id <client-id>jamf-pro-cli instance test

instance test requests a new token for each instance and reads its Jamf Pro version, so it proves each API client works. With one server, set JAMF_PRO_SERVER, JAMF_PRO_CLIENT_ID and JAMF_PRO_CLIENT_SECRET instead and run jamf-pro-cli doctor: it requests a token and reads the Jamf Pro version with it.

What this skill does

Question your MSP keeps askingCommand
Which client has this Mac, iPad or iPhone, by serial, name, username or email?jamf-pro-cli fleet find C02XK1ABJG5H
Which clients have stale check-ins, Macs below a macOS floor, FileVault off or the firewall off?jamf-pro-cli fleet posture --stale-days 14 --min-os 14.6
Which patch titles are behind latest, and which clients have failed managed OS updates?jamf-pro-cli fleet patch --behind-only
A vendor advisory landed: which clients and computers have this app below the fixed version?jamf-pro-cli fleet app "Google Chrome" --below 129.0.6668.100
Which policies are disabled, can never run, have no scope, or point at a missing script or package?jamf-pro-cli fleet policy-hygiene
Which ADE or VPP tokens expire soon, which enrollment syncs failed, and which Jamf Pro versions are clients on?jamf-pro-cli fleet health --within 30d
Which clients are missing objects from our template instance, or run a different copy of its scripts?jamf-pro-cli fleet baseline --golden msp-template
Does every client's API client still work?jamf-pro-cli instance test

Full command reference: guide.md. For the AI-agent operating contract (--agent, --dry-run, when to confirm before mutating), see AGENTS.md.

What makes this different

A connector that forwards each tool call to one Jamf Pro server answers for one client at a time. That's fine for one record. It stops working when you're asking "which of my 40 clients has FileVault off, and on how many Macs?"

This skill keeps a registry of every client's server and API client and reads them in parallel, each with its own credential, so that question is one command and one table with an instance column: fleet posture, fleet patch, fleet baseline. Those commands read live. sync also builds a local SQLite mirror per instance for offline search. An unsynced mirror answers empty, so sync first when you use --data-source local.

The pain this closes

Jamf Pro gives each customer its own server, so an MSP works many consoles. On Jamf Nation's "Multi-tenant Jamf Pro?" thread one MSP engineer put it as "about 100 instances", because Apple requires each organization to have its own push certificate. Any question across clients then means one login per client.

  • jamf-pro-cli fleet find <serial> - the ticket names a Mac but not the client: find which client has it.
  • jamf-pro-cli fleet health --within 30d - catch a lapsing ADE or VPP token before onboarding stops.
  • jamf-pro-cli fleet posture --min-os 14.6 - per-client counts of stale check-ins, old macOS, FileVault off and firewall off.
  • jamf-pro-cli fleet policy-hygiene - policies that can never run, before a client notices.
  • jamf-pro-cli fleet baseline --golden msp-template - which clients are missing your template's policies, profiles and smart groups by name, or run a different copy of its scripts.

See pain-point.md for the longer narrative.

Frequently asked questions

Does this work with ChatGPT?

Yes, on Plus, Pro, Team, Business, Enterprise, and Education plans (Free tier does not yet expose Developer Mode). ChatGPT connects to remote MCP servers over HTTPS, not local stdio binaries. The Jamf Pro MCP server runs locally over stdio by default. Its HTTP mode (jamf-pro-mcp --transport http) serves http://127.0.0.1:7777/mcp, refuses to start until JAMF_PRO_MCP_HTTP_TOKEN is set, requires Authorization: Bearer <token> on every request, and needs --tls-cert/--tls-key for any other address. See mcp-install.md. Step-by-step in mcp-install.md.

Does this work with Codex, Cursor, Windsurf, Cline, Copilot, or Gemini?

Yes - all of them speak MCP. Cross-tool install commands are in the matrix above and the deep-dive in docs/which-agent.md.

Do I need to know how to code?

No. The recommended install is to paste one sentence into Claude Code or Codex - your agent reads SKILL.md and does the install. The fallback is a one-line installer per OS (bash or PowerShell). Neither path requires writing code. You'll enter your Jamf Pro credentials once.

Is my Jamf Pro data safe?

Your data stays on your machine. The CLI and MCP server are local binaries. The SQLite mirror sits in a directory under your user account. The AI agent only sees what the CLI returns - typically a query result, not raw bulk data. Credentials are read from your environment or your agent's config; never bundled into this repo or transmitted anywhere by MSP Skills.

Do I need a separate API client for each client's Jamf Pro?

Yes. Create one in each instance under Settings > System > API roles and clients, with only the read privileges the reports need, then register it once with jamf-pro-cli instance add. Each secret stays in the JAMF_PRO_FLEET_SECRETS environment variable (name=secret entries separated by commas) and is never written to the registry.

Will this replace Jamf Account or the Jamf Pro console?

No. Jamf Account is where a service provider manages customers and their products, and each console is where you build policies and enroll devices. This skill answers questions across the data inside those instances.

Can it read LAPS passwords, FileVault keys or lock PINs?

No. Those endpoints are not included, fleet exec refuses them by path, and any password, key, token or PIN field in another response prints as [redacted]. Read them in the Jamf Pro console.

We run one Jamf Pro with sites. Does it help?

Partly. Register that server once and every read works, but fleet reports count per instance, not per site. Fleet reports earn their keep when each client has its own instance.

What does it cost?

Free. Apache-2.0 licensed. You pay only for whichever AI agent you use (Claude, ChatGPT, Codex, etc.), and that's billed by your AI provider, not by us.

Safety model

TierExamplesRecommended agent policy
Readfleet find, fleet posture, fleet patch, fleet app, fleet policy-hygiene, fleet health, fleet baseline, fleet exec, computer-inventory list, scripts get, policies list, sync, searchAllow
Write (routine)buildings create, categories update, departments update, computer-groups create-static-groups, packages update, computer-extension-attributes update, every other POST, PUT or PATCH not named belowPreview with --dry-run, then a reviewed write
Credential and identityauth login, auth set-token, every api-integrations and api-roles command, accounts, account-groups, every local-admin-password command, volume-purchasing-locations create and update, and any prestage write that sets an admin passwordHuman-in-the-loop only
Acts on customer devicescomputer-inventory erase, computer-inventory remove-mdm-profile, mobile-devices erase, mobile-devices unmanage, mdm send-command, mdm deploy-package, mdm blank-push, mdm renew-profile, managed-software-updates create-plans, patch-policy-logs retry, policies create and update, scripts create and update, device-enrollments disown, volume-purchasing-locations revoke-licenses and reclaimHuman-in-the-loop only, one instance at a time
Destructive / configEvery delete and delete-multiple command, for example scripts delete, policies delete, computer-inventory delete, api-roles delete, device-enrollments deleteHuman-in-the-loop only, explicit confirmation

The strongest control is the scope you grant the Jamf Pro credentials - the CLI can only do what the credentials are permitted to do. Full details, including how to lock it down, are in governance.md.

Status

Beta. Validated against mocks built from Jamf's public API reference; no live Jamf Pro tenant has run it yet. We validate with MSPs running it live against their own production tenant in our weekly Build Sessions. RSVP at compoundingteams.com/build-sessions.


Standards. Conforms to the open Agent Skills spec (Anthropic, Dec 2025; 40+ agents). MCP-compatible - works with any MCP-capable agent including Hermes. OpenClaw-ready (frontmatter pre-wired, awaiting OpenClaw launch).

Maintained by Servosity. Apache-2.0 licensed. Built with CLI Printing Press. Last updated: 2026-11-04.

来源:skills/jamf-pro/README.md,提交 8f2e267

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次,以列出其工具,但未能完成:该软件包类型无法在沙箱中运行。

版本历史

1
  1. v0.1.0最新Nov 6, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。