Skip to content

Document cross-machine plugin bundle download behavior #3807

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 2 commits into
base: main
Choose a base branch
from
+6 −0
Open

Document cross-machine plugin bundle download behavior #3807

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5667aef
Update docs/inspector/plugins.mdx
mintlify[bot] Aug 10, 2026
529f8c2
Merge branch 'main' into mintlify/docs-update-pr-3806-1786321391372
github-actions[bot] Aug 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/inspector/plugins.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,12 @@ Some component types found in OpenAI plugin bundles are not executed by MCPJam.

These components appear in the preview and in the expanded card under **Unsupported components**, always described as preserved rather than executable.

## Running plugins on a different machine

When a plugin has a local stdio component and you open the project on a machine where the bundle has not been imported before, MCPJam automatically attempts to download the stored bundle from the cloud before spawning the process. If the download succeeds and the bundle's content matches the pinned hash, the plugin starts normally with no action required on your part.

If the download fails for any reason — for example, because you are offline or the bundle is no longer available — MCPJam shows an error asking you to re-import the plugin from its original folder on a device that has it. Re-importing stores the bundle in the cloud so future machines can download it automatically.

## Credential setup

After installing a plugin, each MCP server component that requires credentials shows its readiness in the plugin card. The setup section of the install summary lists the environment variable and header names the bundle declared. You configure the actual values per server — MCPJam never reads or stores credential values from the bundle itself.
Expand Down
Loading