Support & Resources

Get help with JamfMCP, connect with the community, and find resources for troubleshooting

Quick Help

First Time Setup?

Start with the Prerequisites and Installation Guide

Something Not Working?

Check the Troubleshooting Guide for common issues

API Errors?

Review Jamf API Setup for permission requirements

Found a Bug?

Report it on GitHub Issues

Getting Help

Asking Good Questions

When asking for help, provide:

  1. Search first - Check existing issues and discussions

  2. Context - What are you trying to accomplish?

  3. Error messages - Include complete error text

  4. Versions - JamfMCP, Python, uv, and OS versions

  5. Steps to reproduce - What exactly did you do?

  6. Configuration - Sanitized config (no secrets!)

Community Resources

MacAdmins Slack

  • Channel: #jamfmcp

  • What to ask: Setup help, best practices, feature ideas

  • Response time: Community-driven, usually within hours

  • Join: MacAdmins Slack Signup

GitHub

  • Issues: Bug reports and feature requests

  • Releases: Version history and changelogs

Gathering System Information

When reporting issues, run this command to gather version info:

# Create a diagnostic report
cat << EOF > jamfmcp-info.txt
System Information for JamfMCP
==============================
Date: $(date)

Python Version:
$(python --version)

UV Version:
$(uv --version 2>&1 || echo "uv not installed")

JamfMCP Version:
$(uv pip show jamfmcp 2>&1 || echo "JamfMCP not installed")

Environment Variables (sanitized):
JAMF_URL: ${JAMF_URL:+[SET]}
JAMF_CLIENT_ID: ${JAMF_CLIENT_ID:+[SET]}
JAMF_CLIENT_SECRET: ${JAMF_CLIENT_SECRET:+[SET]}

Platform:
$(uname -a)
EOF

echo "Diagnostic info saved to jamfmcp-info.txt"

Frequently Asked Questions

Can I use JamfMCP with Jamf School or Jamf Now?

No, JamfMCP is designed specifically for Jamf Pro and requires Jamf Pro API access.

What Jamf Pro version is required?

JamfMCP requires Jamf Pro 10.49+ for full OAuth2 support. Basic functionality may work with older versions using basic auth.

Is JamfMCP officially supported by Jamf?

No, JamfMCP is a community project and is not officially supported by Jamf. For official Jamf support, contact Jamf directly.

Can I contribute to JamfMCP?

Yes! See our Contributing Guide for details on how to contribute.

How do I update JamfMCP?
# Update to latest version
uv pip install --upgrade jamfmcp

# Update to specific version
uv pip install jamfmcp==1.2.3
Why am I getting “spawn uv ENOENT” errors?

This means uv is not accessible to your MCP client. For Claude Desktop on macOS, install uv via Homebrew:

brew install uv

See Prerequisites for platform-specific installation instructions.

Can I use JamfMCP in production?

JamfMCP is in active development. While core features are stable, thoroughly test in your environment before production use. See the warning on our homepage for details.

How do I rotate API credentials?

  1. Create new API client in Jamf Pro

  2. Update environment variables with new credentials

  3. Restart your MCP client

  4. Test connection with a simple query

  5. Remove old API client from Jamf Pro

Support Response Times

Community Support

  • MacAdmins Slack: Usually within hours during US business hours

  • GitHub Discussions: 1-3 days for community responses

  • GitHub Issues: Maintainers review weekly

Priority Support

For critical production issues:

  1. Check Known Issues

  2. Post in MacAdmins Slack for quick community help

  3. Open a detailed GitHub issue with reproduction steps

Note

JamfMCP is maintained by volunteers. Response times vary based on availability.

Helping Others

Ways to Contribute Support

  • Answer questions in MacAdmins Slack #jamfmcp

  • Share your setup experiences in MacAdmins Slack

  • Write blog posts or create videos about JamfMCP

  • Improve documentation when you solve a problem

  • Star the GitHub repository to show support

Becoming a Contributor

Ready to contribute code? See our Development Guide to get started.

External Resources

MCP Protocol
Jamf Resources
Python Resources
AI Assistant Resources

Common Commands

# Check JamfMCP version
uv pip show jamfmcp

# Update JamfMCP
uv pip install --upgrade jamfmcp

# Run CLI configuration
jamfmcp-cli --platform claude-desktop

# Test connection (in Python)
python -c "from jamfmcp.auth import JamfAuth; JamfAuth()"

# View MCP logs (Claude Desktop on macOS)
tail -f ~/Library/Logs/Claude/*.log

# View MCP logs (Cursor)
tail -f ~/.cursor/logs/main.log

Environment Variables

# Required
export JAMF_URL="https://your-instance.jamfcloud.com"
export JAMF_CLIENT_ID="your-client-id"
export JAMF_CLIENT_SECRET="your-client-secret"

# Optional
export JAMF_TIMEOUT=30  # Request timeout in seconds
export JAMF_DEBUG=true  # Enable debug logging