# Interactive installation wizardultra install# Install into one agent (see Supported Agents for values)ultra install --agent claudeultra install --agent codex# List detected agents without installingultra install --list# Install into all detected agents (non-interactive, used by MDM)ultra install --all
Adds an ultra MCP server entry that runs ultra start to each selected agent’s config, leaving other connectors and settings in place. With --config, the entry also passes --config <path>. For Hermes, connectors set to enabled: false are skipped when Ultra discovers existing entries. See Configure Agents for each agent’s config file and format.
Restart each agent you installed into (for example, quit and reopen Claude Desktop, Cursor, or Codex) so it picks up the new config.
ultra install --all (MDM) and ultra install --agent ona (Ona devcontainers) link the device to Hub at install time when a deploy key is available from ULTRA_DEPLOY_KEY, the config file, or managed preferences, so it appears in Hub before any agent starts. Every other install path, and any OAuth login, links at the first ultra start.
⌘I
{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"Ultra","colors":{"primary":"#CE07A6","light":"#CE07A6","dark":"#CE07A6"},"logo":{"light":"https://mintcdn.com/ultra-52ae57d1/j2CRReV02m2L6JVA/logo/ultra-logo-black.svg?fit=max\u0026auto=format\u0026n=j2CRReV02m2L6JVA\u0026q=85\u0026s=d0bfb10ef0b4b157e8a2c1df8a018d2b","dark":"https://mintcdn.com/ultra-52ae57d1/j2CRReV02m2L6JVA/logo/ultra-logo-white.svg?fit=max\u0026auto=format\u0026n=j2CRReV02m2L6JVA\u0026q=85\u0026s=9b7c76009b13962631e3d411688897a0"},"favicon":{"light":"https://mintcdn.com/ultra-52ae57d1/j2CRReV02m2L6JVA/favicon.svg?fit=max\u0026auto=format\u0026n=j2CRReV02m2L6JVA\u0026q=85\u0026s=8c90507d793e9038865391c3b417d1ba","dark":"https://mintcdn.com/ultra-52ae57d1/j2CRReV02m2L6JVA/favicon-dark.svg?fit=max\u0026auto=format\u0026n=j2CRReV02m2L6JVA\u0026q=85\u0026s=2c1770c6b903e7f95a92b99e4fe57e97"},"background":{"color":{"light":"#FFFFFF","dark":"#181818"}},"fonts":{"heading":{"family":"Hanken Grotesk","weight":400},"body":{"family":"Hanken Grotesk","weight":400}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ultra-52ae57d1","hasAudioNarration":false,"actualSubdomain":"ultra-52ae57d1","customDomains":["docs.ultra.security"],"gitSource":{"type":"github","owner":"ultra-security","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adfa28490b8f769491b0a5a","collectionId":"d882be10-be4f-498e-87ec-dfbe1485d0ac","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfa28490b8f769491b0a5a"},"entitlements":{},"buildId":"6adfa28490b8f769491b0a5a","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Documentation","count":47},{"language":"default","tag":"CLI Reference","count":34},{"language":"default","tag":"Ultra Hub","count":19},{"language":"default","tag":"Getting Started","count":14},{"language":"default","tag":"Observability","count":9},{"language":"default","tag":"Concepts","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".tab-container ol{padding-left:2rem}html:root{--gray-50:250 250 250;--gray-100:245 245 245;--gray-200:228 228 228;--gray-300:211 211 211;--gray-400:163 163 163;--gray-500:122 122 122;--gray-600:86 86 86;--gray-700:68 68 68;--gray-800:50 50 50;--gray-900:30 30 30;--gray-950:20 20 20;--ultra-rail:#323232;--ultra-panel:#141414}@font-face{font-family:\"Hanken Grotesk\";font-style:normal;font-weight:100 900;font-display:swap;src:url(/fonts/hanken-grotesk-latin.woff2) format(\"woff2\");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}#page-title,.mdx-content h1,.mdx-content h2,.mdx-content h3,.mdx-content h4{font-weight:400}#page-title{letter-spacing:-.02em}.dark #page-title,.dark .mdx-content h1,.dark .mdx-content h2,.dark .mdx-content h3{color:#fff}.code-block,.code-block *,.code-group,.code-group *,.font-mono,code,kbd,pre{font-family:\"DM Mono\",ui-monospace,SFMono-Regular,Menlo,monospace!important}code:not(pre *){background-color:#f0f0f0!important;padding:2px 4px!important}.dark code:not(pre *){background-color:rgb(var(--gray-800))!important}[data-component-part=pagination-title]{text-transform:none}#navigation-items .sidebar-group-header,#navigation-items .sidebar-group-header .sidebar-title{font-weight:500}#navigation-items .sidebar-group a{border-radius:8px}#navigation-items .sidebar-group a:hover{background-color:#f1f1f4;color:#16161c}#navigation-items .sidebar-group a[aria-current=page]{color:#ce07a6;background-color:rgba(206,7,166,.07);font-weight:600;text-shadow:none}#navigation-items .sidebar-group a[aria-current=page]>.absolute,#table-of-contents .toc-item[data-active]>.absolute{display:none}.dark #navigation-items .sidebar-group a:hover{background-color:#222226;color:#fff}.dark #navigation-items .sidebar-group a[aria-current=page]{color:#ce07a6;background-color:rgba(206,7,166,.12)}#table-of-contents .toc-item>a{border-radius:8px;margin-left:calc(var(--toc-padding-left, 0rem) - var(--toc-focus-padding, 0rem));padding:.375rem .75rem;padding-left:calc(1rem + var(--toc-focus-padding, 0rem))}#table-of-contents .toc-item[data-depth=\"0\"]>a{margin-left:calc(var(--toc-padding-left, 0rem) - 1rem - var(--toc-focus-padding, 0rem))}#table-of-contents .toc-item+.toc-item>a,#table-of-contents .toc-item>ul>.toc-item:first-child>a{margin-top:1px}#table-of-contents .toc-item>a:hover{background-color:#f1f1f4;color:#16161c}#table-of-contents .toc-item[data-active]:not([data-active-deepest])>a{color:rgb(var(--gray-600));text-shadow:none}#table-of-contents .toc-item[data-depth=\"2\"][data-active]:not([data-active-deepest])>a{color:rgb(var(--gray-500))}#table-of-contents .toc-item[data-active-deepest]>a,#table-of-contents a[aria-current=location]{color:#ce07a6;background-color:rgba(206,7,166,.07);text-shadow:none}.dark #table-of-contents .toc-item[data-active]:not([data-active-deepest])>a{color:rgb(var(--gray-400))}.dark #table-of-contents .toc-item>a:hover{background-color:#222226;color:#fff}.dark #table-of-contents .toc-item[data-active-deepest]>a,.dark #table-of-contents a[aria-current=location]{color:#ce07a6;background-color:rgba(206,7,166,.12)}.mdx-content a.link{border-bottom-color:#7a7a7a!important}.mdx-content a.link:hover{border-bottom-color:currentColor!important}.mdx-content a.link code{-webkit-text-decoration-color:#7a7a7a!important;text-decoration-color:#7a7a7a!important}.mdx-content a.link:hover code{-webkit-text-decoration-color:currentColor!important;text-decoration-color:currentColor!important}.eyebrow{color:rgb(var(--gray-500));font-size:.75rem;letter-spacing:.2em;text-transform:uppercase}.dark .eyebrow{color:rgb(var(--gray-300))}#search-bar-entry,#topbar-cta-button,#topbar-cta-button *,.accordion,.accordion *,.accordion-group,.callout,.card,.card *,.code-block,.code-block *,.code-group,.code-group *,.frame,.frame *,.mdx-content code,.mdx-content kbd,.steps *{border-radius:0!important}.dark .accordion-group,.dark .callout,.dark .card,.dark .code-block,.dark .code-group{border-color:var(--ultra-rail)!important;box-shadow:none!important}.dark .callout,.dark .card:hover,.dark .code-block,.dark .code-group{background-color:var(--ultra-panel)!important}.callout{background-color:rgb(var(--gray-50))!important;border-color:rgb(var(--gray-200))!important}.callout [data-component-part=callout-content]{color:rgb(var(--gray-700))!important}.dark .callout [data-component-part=callout-content]{color:rgb(var(--gray-300))!important}"}],"page":{"pagePath":"cli/install","slug":"/cli/install","pageMetadata":{"title":"ultra install","description":"Install Ultra into MCP agents","href":"/cli/install"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install Ultra into MCP agents\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Detect installed MCP agents and configure them to use Ultra as their MCP server.`}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`ultra`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` install`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` [flags]`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`flags`,children:`Flags`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Short`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--agent`})}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`Target agent; see `,_jsx(_components.a,{href:`#supported-agents`,children:`Supported Agents`}),` for values`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all`})}),_jsx(_components.td,{}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Install into all detected MCP agents (non-interactive)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--config`})}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsx(_components.td,{children:`Path to Ultra config file`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--no-backup`})}),_jsx(_components.td,{}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Skip backing up each agent config before modifying it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--yes`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`-y`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Skip confirmation prompt`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--list`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`-l`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`List detected agents without installing`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--client`}),` (`,_jsx(_components.code,{children:`-c`}),`) is a deprecated alias for `,_jsx(_components.code,{children:`--agent`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A737D`},children:`# Interactive installation wizard`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`ultra`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` install`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A737D`},children:`# Install into one agent (see Supported Agents for values)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`ultra`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` install`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --agent`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` claude`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`ultra`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` install`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --agent`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` codex`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A737D`},children:`# List detected agents without installing`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`ultra`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` install`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --list`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A737D`},children:`# Install into all detected agents (non-interactive, used by MDM)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`ultra`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` install`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --all`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-agents`,children:`Supported Agents`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Agent`}),_jsx(_components.th,{children:`Flag Value`}),_jsx(_components.th,{children:`Aliases`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Claude Desktop`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`claude`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`claude-desktop`}),`, `,_jsx(_components.code,{children:`claude_desktop`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cursor`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`cursor`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cline`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`cline`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Codex`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`codex`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`codex-cli`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Grok Build`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`grok`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`grok-build`}),`, `,_jsx(_components.code,{children:`grok_build`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`VS Code`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`vscode`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Claude Code`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`claude_code`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`claude-code`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Windsurf`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`windsurf`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Goose`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`goose`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`OpenCode`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`opencode`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gemini`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`gemini`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Antigravity`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`antigravity`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`agy`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Roo Code`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`roocode`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`roo-code`}),`, `,_jsx(_components.code,{children:`roo_code`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Amazon Q`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`amazonq`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`amazon-q`}),`, `,_jsx(_components.code,{children:`amazon_q`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`LM Studio`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`lmstudio`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`lm-studio`}),`, `,_jsx(_components.code,{children:`lm_studio`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Zed`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`zed`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Ona`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ona`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Hermes`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`hermes`})}),_jsx(_components.td,{})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-it-does`,children:`What It Does`}),`\n`,_jsxs(_components.p,{children:[`Adds an `,_jsx(_components.code,{children:`ultra`}),` MCP server entry that runs `,_jsx(_components.code,{children:`ultra start`}),` to each selected agent’s config, leaving other connectors and settings in place. With `,_jsx(_components.code,{children:`--config`}),`, the entry also passes `,_jsx(_components.code,{children:`--config \u003cpath>`}),`. For Hermes, connectors set to `,_jsx(_components.code,{children:`enabled: false`}),` are skipped when Ultra discovers existing entries. See `,_jsx(_components.a,{href:`/installation/configure-agents`,children:`Configure Agents`}),` for each agent’s config file and format.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Restart each agent you installed into (for example, quit and reopen Claude Desktop, Cursor, or Codex) so it picks up the new config.`})}),`\n`,_jsx(Heading,{level:`2`,id:`auto-linking`,children:`Auto-linking`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ultra install --all`}),` (MDM) and `,_jsx(_components.code,{children:`ultra install --agent ona`}),` (Ona devcontainers) link the device to Hub at install time when a `,_jsx(_components.a,{href:`/hub/deploy-keys`,children:`deploy key`}),` is available from `,_jsx(_components.code,{children:`ULTRA_DEPLOY_KEY`}),`, the config file, or managed preferences, so it appears in Hub before any agent starts. Every other install path, and any OAuth login, links at the first `,_jsx(_components.code,{children:`ultra start`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"ultra install","description":"Install Ultra into MCP agents","href":"/cli/install"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Usage","slug":"usage","depth":2,"children":[]},{"title":"Flags","slug":"flags","depth":2,"children":[]},{"title":"Examples","slug":"examples","depth":2,"children":[]},{"title":"Supported Agents","slug":"supported-agents","depth":2,"children":[]},{"title":"What It Does","slug":"what-it-does","depth":2,"children":[]},{"title":"Auto-linking","slug":"auto-linking","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"ultra-52ae57d1","siteName":"Ultra","title":"ultra install - Ultra","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T20:38:20.606Z","originalFileLocation":"cli/install.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install Ultra into MCP agents\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ultra\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ultra install - Ultra\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install Ultra into MCP agents\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ultra\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ultra.security/cli/install\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ultra-52ae57d1.mintlify.app/_mintlify/api/og/v2?division=CLI+Reference\u0026amp;title=ultra+install\u0026amp;description=Install+Ultra+into+MCP+agents\u0026amp;theme=c93fb4da46096eee06114979\u0026amp;signature=3ff2acd8ce267949c5622bda0fd356ab4fb83d6b694a4025606d21ca35091b93\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ultra install - Ultra\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install Ultra into MCP agents\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ultra-52ae57d1.mintlify.app/_mintlify/api/og/v2?division=CLI+Reference\u0026amp;title=ultra+install\u0026amp;description=Install+Ultra+into+MCP+agents\u0026amp;theme=c93fb4da46096eee06114979\u0026amp;signature=3ff2acd8ce267949c5622bda0fd356ab4fb83d6b694a4025606d21ca35091b93\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ultra-52ae57d1/-IM2rziYB89ke4HP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ultra\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#CE07A6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ultra.security/cli/install\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cli/install.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ultra.security/#organization\",\"name\":\"Ultra\",\"url\":\"https://docs.ultra.security\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ultra-52ae57d1/j2CRReV02m2L6JVA/logo/ultra-logo-black.svg?fit=max\u0026auto=format\u0026n=j2CRReV02m2L6JVA\u0026q=85\u0026s=d0bfb10ef0b4b157e8a2c1df8a018d2b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ultra.security#website\",\"name\":\"Ultra\",\"url\":\"https://docs.ultra.security\",\"publisher\":{\"@id\":\"https://docs.ultra.security/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ultra.security/cli/install#webpage\",\"url\":\"https://docs.ultra.security/cli/install\",\"name\":\"ultra install\",\"description\":\"Install Ultra into MCP agents\",\"dateModified\":\"2026-10-16T20:38:20.606Z\",\"isPartOf\":{\"@id\":\"https://docs.ultra.security#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ultra.security/cli/install#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ultra.security/cli/install#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CLI Reference\",\"item\":\"https://docs.ultra.security/cli/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ultra install\",\"item\":\"https://docs.ultra.security/cli/install\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ultra.security/cli/install#article\",\"headline\":\"ultra install\",\"name\":\"ultra install\",\"description\":\"Install Ultra into MCP agents\",\"url\":\"https://docs.ultra.security/cli/install\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ultra.security/cli/install#webpage\"},\"dateModified\":\"2026-10-16T20:38:20.606Z\",\"publisher\":{\"@id\":\"https://docs.ultra.security/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ultra.security#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ultra\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ultra","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"CLI Reference","groups":[{"group":"CLI Reference","pages":[{"title":"CLI Overview","href":"/cli/overview"},{"title":"ultra start","description":"Start Ultra as an MCP proxy server","href":"/cli/start"},{"title":"ultra install","href":"/cli/install"},{"title":"ultra migrate","description":"Import existing MCP connectors into Ultra","href":"/cli/migrate"},{"title":"ultra search","href":"/cli/search"},{"title":"ultra add","href":"/cli/add"},{"title":"ultra connectors","href":"/cli/connectors"},{"title":"ultra reconnect","href":"/cli/reconnect"},{"title":"ultra config","href":"/cli/config"},{"title":"ultra dashboard","href":"/cli/dashboard"},{"title":"ultra login","href":"/cli/login"},{"title":"ultra link","href":"/cli/link"},{"title":"ultra unlink","href":"/cli/unlink"},{"title":"ultra uninstall","href":"/cli/uninstall"},{"title":"ultra logout","href":"/cli/logout"},{"title":"ultra doctor","href":"/cli/doctor"},{"title":"ultra version","href":"/cli/version"}]}]}]},"basePath":"","title":"ultra install - Ultra","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}
