Connect Claude Code (Anthropic’s terminal-based coding agent) to Prometheux via the MCP server.
Connect Claude Code (Anthropic’s terminal-based coding agent) to Prometheux using the MCP server. This guide covers both the local and remote setup options.
Recommended: Use the Local ServerWe recommend using the local MCP server (stdio) with Claude Code for the most reliable experience. It avoids the OAuth browser flow and passes credentials directly.
Prerequisites
Claude Code installed (npm install -g @anthropic-ai/claude-code)
Prometheux credentials (username, organization, API token)
Setup (Local Server — Recommended)
1. Install the MCP Package
If you haven’t already, install prometheux-mcp:macOS:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Prometheux","colors":{"primary":"#4a90fd","light":"#40e9a0","dark":"#0f0f0f"},"logo":{"light":"/images/202510-Logo-TransparentBlack.jpg","dark":"/images/202510-Logo-White.png","href":"https://prometheux.ai"},"favicon":{"light":"/images/prometheux_icon_black_on_white.jpg","dark":"/images/prometheux_icon_black_on_white.jpg"},"background":{"color":{"light":"#ffffff","dark":"#0f0f0f"}},"navbar":{"links":[{"href":"https://platform.prometheux.ai","label":"Platform"}],"primary":{"type":"button","label":"Get Started","href":"https://platform.prometheux.ai/login"}},"footer":{"socials":{"website":"https://prometheux.ai","linkedin":"https://www.linkedin.com/company/prometheux"}},"fonts":{"family":"Roboto","weight":400},"integrations":{"telemetry":{"enabled":false}},"navigation":{"global":{"anchors":[{"anchor":"Community (Coming Soon)","icon":"discord","color":{"light":"#ffee16","dark":"#ffee16"},"href":"https://docs.prometheux.ai/resources/community"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"hasAudioNarration":false,"customDomains":[],"gitSource":{"type":"github","owner":"local","repo":"local","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"local","isBase":true},"buildId":"local","clientVersion":"0.0.4127"},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":true,"isLoggedInCli":false,"mintExport":{}},"customCss":[{"filePath":"assets/static-search.css","content":"#px-search-modal{position:fixed;inset:0;display:none;z-index:9999}#px-search-modal.open{display:block}.px-search-backdrop{position:absolute;inset:0;background:rgba(15, 15, 15, 0.55);backdrop-filter:blur(3px);-webkit-backdrop-filter:blur(3px)}.px-search-panel{position:relative;display:flex;flex-direction:column;width:min(680px, calc(100vw - 32px));max-height:82vh;max-height:82dvh;margin:9vh auto 0;background:#ffffff;color:inherit;border-radius:14px;box-shadow:0 16px 48px rgba(0, 0, 0, 0.35);overflow:hidden;padding:18px 18px 12px}html.dark .px-search-panel,html[data-theme=\"dark\"] .px-search-panel{background:#141414;color:#e8e8e8}html.px-search-open,html.px-search-open body{overflow:hidden}:root{--px-search-primary: #00e382}.pagefind-ui{--pagefind-ui-primary: var(--px-search-primary);--pagefind-ui-text: #1a1a1a;--pagefind-ui-background: transparent;--pagefind-ui-border: #e3e3e3;--pagefind-ui-tag: #f4f4f4;--pagefind-ui-border-width: 1px;--pagefind-ui-border-radius: 10px;--pagefind-ui-image-border-radius: 8px;--pagefind-ui-image-box-ratio: 3 / 2;--pagefind-ui-font: inherit;--pagefind-ui-scale: 0.95}html.dark .pagefind-ui,html[data-theme=\"dark\"] .pagefind-ui{--pagefind-ui-text: #ececec;--pagefind-ui-border: #2a2a2a;--pagefind-ui-tag: #1f1f1f}.pagefind-ui__search-input{font-size:1rem}.pagefind-ui__result-link{color:var(--px-search-primary)}#px-search-modal #px-search-host,#px-search-modal .pagefind-ui,#px-search-modal .pagefind-ui__form{display:flex;flex-direction:column;flex:1 1 auto;min-height:0}#px-search-modal .pagefind-ui__search-input{flex:0 0 auto}#px-search-modal .pagefind-ui__drawer{flex:1 1 auto;min-height:0;overflow-y:auto;overscroll-behavior:contain;-webkit-overflow-scrolling:touch}"}],"page":{"pagePath":"integrations/mcp/claude-code","slug":"/integrations/mcp/claude-code","pageMetadata":{"title":"Connect Claude Code","description":"Connect Claude Code (Anthropic's terminal-based coding agent) to Prometheux via the MCP server.","href":"/integrations/mcp/claude-code"},"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: \"Connect Claude Code (Anthropic’s terminal-based coding agent) to Prometheux via the MCP server.\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Connect `,_jsx(_components.a,{href:`https://docs.anthropic.com/en/docs/claude-code`,children:`Claude Code`}),` (Anthropic’s terminal-based coding agent) to Prometheux using the MCP server. This guide covers both the local and remote setup options.`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Recommended: Use the Local Server`})}),_jsxs(_components.p,{children:[`We recommend using the `,_jsx(_components.strong,{children:`local MCP server`}),` (stdio) with Claude Code for the most reliable experience. It avoids the OAuth browser flow and passes credentials directly.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Claude Code`}),` installed (`,_jsx(_components.code,{children:`npm install -g @anthropic-ai/claude-code`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Prometheux credentials`}),` (username, organization, API token)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`setup-local-server-—-recommended`,children:`Setup (Local Server — Recommended)`}),`\n`,_jsx(Heading,{level:`3`,id:`1-install-the-mcp-package`,children:`1. Install the MCP Package`}),`\n`,_jsxs(_components.p,{children:[`If you haven’t already, install `,_jsx(_components.code,{children:`prometheux-mcp`}),`:`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`macOS:`})}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`brew`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pipx`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pipx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ensurepath`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pipx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` prometheux-mcp`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Windows/Linux:`})}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pipx`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pipx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ensurepath`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pipx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` prometheux-mcp`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`2-add-the-server-to-claude-code`,children:`2. Add the Server to Claude Code`}),`\n`,_jsx(CodeBlock,{numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -e`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROMETHEUX_TOKEN='your_token_here'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -e`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROMETHEUX_USERNAME='your_username'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -e`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROMETHEUX_ORGANIZATION='your_organization'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` prometheux`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /Users/YOUR_USERNAME/.local/bin/prometheux-mcp`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.prometheux.ai`})]}),`\n`]})})}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Finding Your Path`})}),_jsxs(_components.p,{children:[`Run `,_jsx(_components.code,{children:`which prometheux-mcp`}),` (macOS/Linux) or `,_jsx(_components.code,{children:`where prometheux-mcp`}),` (Windows) to find the correct path.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`3-verify-the-connection`,children:`3. Verify the Connection`}),`\n`,_jsx(_components.p,{children:`Restart Claude Code and check the server status:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`You should see `,_jsx(_components.code,{children:`prometheux`}),` listed as connected. You can also type `,_jsx(_components.code,{children:`/mcp`}),` inside a Claude Code session to see all server statuses.`]}),`\n`,_jsx(Heading,{level:`2`,id:`alternative-remote-server`,children:`Alternative: Remote Server`}),`\n`,_jsx(_components.p,{children:`You can also use the remote server with OAuth authentication:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --transport`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` prometheux`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.prometheux.ai/px-remote-mcp-server`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`This will trigger an OAuth browser flow when Claude Code connects. See the `,_jsx(_components.a,{href:`/integrations/mcp/remote`,children:`Remote MCP Server`}),` page for details.`]}),`\n`,_jsx(Heading,{level:`2`,id:`claude-code-in-claude-desktop`,children:`Claude Code in Claude Desktop`}),`\n`,_jsx(_components.p,{children:`If you use Claude Code within the Claude Desktop app (not the terminal), it shares the Desktop app’s MCP connectors. You can either:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use the remote connector`}),` via Settings → Connectors → Add custom connector (see `,_jsx(_components.a,{href:`/integrations/mcp/claude`,children:`Connect Claude`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use the local server`}),` by configuring `,_jsx(_components.code,{children:`claude_desktop_config.json`}),` (see `,_jsx(_components.a,{href:`/integrations/mcp/local#2-configure-claude-desktop`,children:`Local MCP Server configuration`}),`)`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Both methods make the Prometheux tools available to Claude Code running inside the Desktop app.`}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsx(_components.p,{children:`Once connected, interact naturally with Claude Code. It will automatically use the Prometheux MCP tools when relevant.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example Conversations \u0026 Available Tools`})}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/integrations/mcp/overview#available-tools`,children:`MCP overview page`}),` for example conversations and a complete list of available tools.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`managing-the-server`,children:`Managing the Server`}),`\n`,_jsx(CodeBlock,{numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# List all configured servers`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Remove the server`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` remove`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` prometheux`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Heading,{level:`3`,id:`server-shows-as-“failed”-in-/mcp`,children:[`Server shows as “failed” in `,_jsx(_components.code,{children:`/mcp`})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solution:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Verify the path to `,_jsx(_components.code,{children:`prometheux-mcp`}),` is correct — run `,_jsx(_components.code,{children:`which prometheux-mcp`}),` in your terminal`]}),`\n`,_jsx(_components.li,{children:`Check that your credentials are valid and the token hasn’t expired`}),`\n`,_jsxs(_components.li,{children:[`Remove and re-add the server: `,_jsx(_components.code,{children:`claude mcp remove prometheux`}),` then add it again`]}),`\n`,_jsxs(_components.li,{children:[`Run `,_jsx(_components.code,{children:`claude --debug`}),` to see detailed error logs`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`tools-not-being-used`,children:`Tools not being used`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solution:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Type `,_jsx(_components.code,{children:`/mcp`}),` in Claude Code to verify the server is connected`]}),`\n`,_jsx(_components.li,{children:`Be more explicit in your query: “Use the prometheux tools to list concepts in project X”`}),`\n`,_jsx(_components.li,{children:`Restart Claude Code for changes to take effect`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`”command-not-found”-error`,children:`”command not found” error`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solution:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Use the full path to `,_jsx(_components.code,{children:`prometheux-mcp`}),` instead of just the command name`]}),`\n`,_jsxs(_components.li,{children:[`Ensure `,_jsx(_components.code,{children:`pipx ensurepath`}),` was run and your shell profile was reloaded`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`For general troubleshooting, see the `,_jsx(_components.a,{href:`/integrations/mcp/local#troubleshooting`,children:`Local MCP Server troubleshooting`}),` section.`]})]})}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":{"config":{},"pageMetadata":{"title":"Connect Claude Code","description":"Connect Claude Code (Anthropic's terminal-based coding agent) to Prometheux via the MCP server.","href":"/integrations/mcp/claude-code"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Setup (Local Server — Recommended)","slug":"setup-local-server-—-recommended","depth":2,"children":[{"title":"1. Install the MCP Package","slug":"1-install-the-mcp-package","depth":3,"children":[]},{"title":"2. Add the Server to Claude Code","slug":"2-add-the-server-to-claude-code","depth":3,"children":[]},{"title":"3. Verify the Connection","slug":"3-verify-the-connection","depth":3,"children":[]}]},{"title":"Alternative: Remote Server","slug":"alternative-remote-server","depth":2,"children":[]},{"title":"Claude Code in Claude Desktop","slug":"claude-code-in-claude-desktop","depth":2,"children":[]},{"title":"Usage","slug":"usage","depth":2,"children":[]},{"title":"Managing the Server","slug":"managing-the-server","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[{"title":"Server shows as “failed” in /mcp","slug":"server-shows-as-“failed”-in-/mcp","depth":3,"children":[]},{"title":"Tools not being used","slug":"tools-not-being-used","depth":3,"children":[]},{"title":"”command not found” error","slug":"”command-not-found”-error","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/localhost/59112c55929f7b0a/assets/static-search.js"],"subdomain":"localhost","siteName":"Prometheux","title":"Connect Claude Code - Prometheux","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"integrations/mcp/claude-code.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=\"Connect Claude Code (Anthropic\u0026#x27;s terminal-based coding agent) to Prometheux via the MCP server.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Prometheux\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/favicons/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicons/favicon-32x32.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/favicons/favicon-16x16.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/favicons/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Claude Code - Prometheux\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Claude Code (Anthropic\u0026#x27;s terminal-based coding agent) to Prometheux via the MCP server.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Prometheux\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://local./integrations/mcp/claude-code\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connect Claude Code - Prometheux\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Claude Code (Anthropic\u0026#x27;s terminal-based coding agent) to Prometheux via the MCP server.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/favicons/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Prometheux\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4a90fd\">\u003clink data-mint-head rel=\"canonical\" href=\"https://local./integrations/mcp/claude-code\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/mcp/claude-code.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Prometheux\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Prometheux\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/mcp/claude-code.md","siteName":"Prometheux","nav":{"global":{"anchors":[{"anchor":"Community (Coming Soon)","icon":"discord","color":{"light":"#ffee16","dark":"#ffee16"},"href":"https://docs.prometheux.ai/resources/community"}]},"groups":[{"group":"Introduction","pages":[{"title":"Getting Started","href":"/introduction"}]},{"group":"Get Started","pages":[{"title":"Platform Overview","href":"/get-started/platform-overview"},{"title":"Quickstart","href":"/get-started/quickstart"},{"title":"Your First Ontology","href":"/get-started/your-first-ontology"},{"group":"Installation","pages":[{"title":"Installation","href":"/get-started/installation/overview"},{"title":"Prometheux Cloud","href":"/get-started/installation/cloud"},{"title":"Snowflake Native App","href":"/get-started/installation/snowflake"},{"group":"On-Premises","pages":[{"title":"On (Cloud) Premises","href":"/get-started/installation/on-premises/cloud-premises"},{"title":"Single VM","href":"/get-started/installation/on-premises/single-vm"},{"title":"Physical Premises","href":"/get-started/installation/on-premises/physical-premises"}]},{"group":"Databricks","pages":[{"title":"Databricks","href":"/get-started/installation/databricks/overview"},{"title":"Databricks Native App","href":"/get-started/installation/databricks/native-app"},{"title":"Installing PX on Databricks \u0026 Connectors","href":"/get-started/installation/databricks/connectors"}]},{"title":"Palantir Foundry","href":"/get-started/installation/palantir"}]}]},{"group":"Platform","pages":[{"title":"Data Connections","href":"/platform/data-connections"},{"title":"Ontologies","href":"/platform/ontologies"},{"title":"Ontology Graph","href":"/platform/ontology-graph"},{"title":"Concepts \u0026 Lineage","href":"/platform/concepts-and-lineage"},{"title":"Ontology Workspace","href":"/platform/ontology-workspace"},{"title":"Concept Editor","href":"/platform/concept-editor"},{"title":"Context \u0026 LLM Concepts","href":"/platform/context-and-llm-concepts"},{"group":"Apps","pages":[{"title":"Apps","href":"/platform/apps/overview"},{"title":"Your first app","href":"/platform/apps/your-first-app"},{"title":"Forms and parameters","href":"/platform/apps/forms-and-parameters"},{"title":"Selects, triggers and drill-downs","href":"/platform/apps/selects-triggers-and-drill-downs"},{"title":"The App Editor","href":"/platform/apps/the-app-editor"},{"title":"How apps run","href":"/platform/apps/how-apps-run"},{"title":"App definition reference","href":"/platform/apps/schema-reference"}]},{"title":"AI Assistant","href":"/platform/ai-assistant"},{"title":"Compute","href":"/platform/compute"},{"title":"Settings","href":"/platform/settings"}]},{"group":"Integrations","pages":[{"title":"PX APIs","href":"/integrations/overview"},{"title":"Python SDK","href":"/integrations/python-sdk"},{"title":"TypeScript SDK","href":"/integrations/typescript-sdk"},{"title":"SDK Function Reference","href":"/integrations/sdk-reference"},{"title":"REST API","href":"/integrations/rest-api"},{"title":"Config","href":"/integrations/config"},{"title":"Bring Your Own Frontend","href":"/integrations/bring-your-own-frontend"},{"title":"Chat API","href":"/integrations/chat-api"},{"group":"CLI","pages":[{"title":"Overview","href":"/integrations/cli/overview"},{"title":"Installation","href":"/integrations/cli/installation"},{"title":"Quickstart","href":"/integrations/cli/quickstart"},{"title":"Authoring a workspace","href":"/integrations/cli/authoring"},{"title":"Context as code","href":"/integrations/cli/context-as-code"},{"title":"Command reference","href":"/integrations/cli/command-reference"},{"title":"Agent skill","href":"/integrations/cli/agent-skill"},{"title":"CI/CD","href":"/integrations/cli/ci-cd"}]},{"group":"MCP","pages":[{"title":"AI Agent Integration via MCP","href":"/integrations/mcp/overview"},{"title":"Local MCP Server","href":"/integrations/mcp/local"},{"title":"Remote MCP Server","href":"/integrations/mcp/remote"},{"title":"Connect Claude","description":"Connect Claude Desktop or Web to Prometheux using the Remote MCP Server.","href":"/integrations/mcp/claude"},{"title":"Connect Claude Code","href":"/integrations/mcp/claude-code"},{"title":"Connect ChatGPT","description":"Connect ChatGPT to Prometheux via the Remote MCP Server using Developer Mode connectors.","href":"/integrations/mcp/chatgpt"},{"title":"Connect Cursor","href":"/integrations/mcp/cursor"},{"title":"Connect Genie Code","href":"/integrations/mcp/databricks-genie"},{"title":"Connect Snowflake Cortex","href":"/integrations/mcp/snowflake-cortex"}]},{"group":"API Reference","pages":[{"title":"Authentication","href":"/integrations/api-endpoints/authentication"},{"title":"Ontologies","href":"/integrations/api-endpoints/ontologies"},{"title":"Ontology Sharing","href":"/integrations/api-endpoints/sharing"},{"title":"Concepts","href":"/integrations/api-endpoints/concepts"},{"title":"Data Sources","href":"/integrations/api-endpoints/data"},{"title":"Schema","href":"/integrations/api-endpoints/schema"},{"title":"Knowledge Graph","href":"/integrations/api-endpoints/knowledge-graph"},{"title":"Vadalog","href":"/integrations/api-endpoints/vadalog"},{"title":"Vadalingo","href":"/integrations/api-endpoints/vadalingo"},{"title":"Apps","href":"/integrations/api-endpoints/apps"},{"title":"Schedules","href":"/integrations/api-endpoints/schedules"},{"title":"Context Layer","href":"/integrations/api-endpoints/context-layer"},{"title":"AI Agent","href":"/integrations/api-endpoints/agent"},{"title":"Assistant","href":"/integrations/api-endpoints/assistant"},{"title":"Chat History","href":"/integrations/api-endpoints/chat-history"},{"title":"Alerts","href":"/integrations/api-endpoints/alerts"},{"title":"Compute","href":"/integrations/api-endpoints/compute"}]}]},{"group":"Examples","pages":[{"title":"Examples Overview","href":"/examples/overview"},{"group":"Patterns","pages":[{"title":"Graph Analytics","href":"/examples/patterns/graph-analytics"},{"title":"Recursion","href":"/examples/patterns/recursion"},{"title":"State Machine","href":"/examples/patterns/state-machine"}]},{"group":"Finance","pages":[{"title":"Banking Supervision","href":"/examples/finance/banking-supervision"},{"title":"Card Clearing Migration","href":"/examples/finance/card-clearing-migration"},{"title":"Non-Performing Loans","href":"/examples/finance/non-performing-loans"}]}]},{"group":"Vadalog Reference","pages":[{"title":"What is Vadalog?","href":"/vadalog/overview"},{"title":"Thinking in Vadalog","href":"/vadalog/thinking-in-vadalog"},{"title":"Grammar Reference","href":"/vadalog/grammar"},{"title":"Language Primitives","href":"/vadalog/language-primitives"},{"title":"Rules","href":"/vadalog/rules"},{"group":"Expressions","pages":[{"title":"Expressions","href":"/vadalog/expressions/overview"},{"title":"Operators","href":"/vadalog/expressions/operators"},{"title":"Negation","href":"/vadalog/expressions/negation"},{"title":"Conditions \u0026 Assignments","href":"/vadalog/expressions/conditions-assignments"},{"title":"Recursion","href":"/vadalog/expressions/recursion"},{"title":"Aggregations","href":"/vadalog/expressions/aggregations"},{"title":"Collections","href":"/vadalog/expressions/collections"},{"title":"Specialized Functions","href":"/vadalog/expressions/specialized-functions"},{"title":"AI Functions","href":"/vadalog/expressions/ai-functions"}]},{"title":"Annotations","href":"/vadalog/annotations"},{"title":"Data Sources","href":"/vadalog/data-sources"},{"title":"Chase \u0026 Provenance","href":"/vadalog/chase-provenance"},{"title":"Explanations","href":"/vadalog/explanations"},{"title":"Graph Analytics","href":"/vadalog/graph-analytics"},{"title":"SQL Integration","href":"/vadalog/sql-integration"},{"title":"Cypher Integration","href":"/vadalog/cypher-integration"},{"title":"Engine API (Low-Level)","href":"/vadalog/engine-api"}]},{"group":"Resources","pages":[{"title":"FAQ","href":"/resources/faq"},{"title":"Learning Resources","href":"/resources/community"}]}]},"basePath":"","title":"Connect Claude Code - Prometheux","buildId":"2b1ecce0afe8","dynamics":[],"chunks":[]}